# Go SDKs

Use the IONOS Cloud Go SDKs to build applications, automation, and integrations against IONOS Cloud APIs. Each SDK is auto-generated from the OpenAPI specification and published as open source on GitHub.

### Core Infrastructure

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Cloud API Go SDK</strong></mark></td><td>Manage compute, networking, and storage</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/-MUOHE5q_IIVpDsAT0YF-3956399747/">Cloud API Go SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>SDK Go Bundle</strong></mark></td><td>All IONOS Cloud Go SDKs in one module</td><td><a href="https://app.gitbook.com/s/ORX6Is3JfV7amgQuMlE9/">Introduction</a></td></tr><tr><td><mark style="color:blue;"><strong>Auth Go SDK</strong></mark></td><td>Manage API tokens and credentials</td><td><a href="https://app.gitbook.com/s/8YMfMfWHce8Rbg0S1v7P/">Introduction</a></td></tr></tbody></table>

### Database

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>DBaaS Mongo Go SDK</strong></mark></td><td>Provision and manage MongoDB clusters</td><td><a href="https://app.gitbook.com/s/6lfy2uCRlHsQdjPdPQdB/">Introduction</a></td></tr><tr><td><mark style="color:blue;"><strong>DBaaS Postgres Go SDK</strong></mark></td><td>Provision and manage PostgreSQL clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/4htX644tCfonGbxygAeL/">DBaaS Postgres GOLang SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>In Memory DB Go SDK</strong></mark></td><td>Provision and manage in-memory databases</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/BJoSx1zRVI1fzZVbBa1M/">In Memory DB Go SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>MariaDB SDK Go</strong></mark></td><td>Provision and manage MariaDB clusters</td><td><a href="https://app.gitbook.com/s/xDilcxWf1Vpwg1hRGwBG/">Introduction</a></td></tr></tbody></table>

### Networking and Storage

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>API Gateway Go SDK</strong></mark></td><td>Manage API Gateway routes and endpoints</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/zL0gMOzJOXMyfYUxNXiV/">API Gateway Go SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>CDN SDK Go</strong></mark></td><td>Manage CDN distributions and origins</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/3coPyxSPGKJzaqKjTh9Q/">CDN SDK Golang</a></td></tr><tr><td><mark style="color:blue;"><strong>DNS Go SDK</strong></mark></td><td>Manage DNS zones and records</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/qA6rgVMYSEkXiU2vXy8k/">DNS Go SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>NFS SDK Go</strong></mark></td><td>Manage NFS shares and access controls</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/n7XPeMBl6UOWtLGLeTFZ/">NFS SDK Golang</a></td></tr><tr><td><mark style="color:blue;"><strong>S3 SDK Go</strong></mark></td><td>Manage S3-compatible object storage</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/dNpDxHdHphOz7cZVKzUU/">S3 SDK Golang</a></td></tr></tbody></table>

### Containers and Compute

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Container Registry Go SDK</strong></mark></td><td>Manage container registries and images</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/Kwi8HmUWL62sjKUOKVhx/">Container Registry GOLang SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>VM Autoscaling Go SDK</strong></mark></td><td>Manage autoscaling groups for virtual machines</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/74YxuhUR70ZEc7uwcKpe/">VM Autoscaling Go SDK</a></td></tr></tbody></table>

### Observability and Streaming

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Logging Go SDK</strong></mark></td><td>Manage log pipelines and destinations</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/uBxTmGF6G9IFCSTAo3zr/">Logging Go SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>Kafka Go SDK</strong></mark></td><td>Provision and manage Kafka clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/xUDYMMjK9FGA0Hm3zncZ/">Kafka Go SDK</a></td></tr></tbody></table>

### Security

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Certificate Manager Go SDK</strong></mark></td><td>Manage TLS/SSL certificates</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/sNb3PXOUWkCyYX54ez4r/">Certificate Manager GO SDK</a></td></tr></tbody></table>

### Quick Start

Install the Cloud API Go SDK:

```bash
go get github.com/ionos-cloud/sdk-go/v6
```

Set up a client:

```go
import (
    ionoscloud "github.com/ionos-cloud/sdk-go/v6"
    "os"
)

cfg := ionoscloud.NewConfiguration()
cfg.Username = os.Getenv("IONOS_USERNAME")
cfg.Password = os.Getenv("IONOS_PASSWORD")
client := ionoscloud.NewAPIClient(cfg)
```

Use a token instead:

```go
cfg.Token = os.Getenv("IONOS_TOKEN")
```

### Authentication

All Go SDKs use the same credentials. Store them in environment variables and keep them out of your source code.

```bash
export IONOS_USERNAME=your@email.com
export IONOS_PASSWORD=yourpassword

# Use a token for CI/CD:
export IONOS_TOKEN=your_api_token
```

### GitHub Repositories

All Go SDKs are open source on GitHub under [ionos-cloud](https://github.com/ionos-cloud). Product SDKs follow the pattern `sdk-go-{service}`.
