Migrate from the Go HTTP Client to the Atlas Go SDK

Client Initialization

The Atlas Go SDK has different methods for the initialization of the clients:

// Surrounding code ignored for brevity
sdk, err := admin.NewClient(
    // Authentication using ApiKey and ApiSecret
    admin.UseDigestAuth(apiKey, apiSecret))

Note: Both the deprecated go-client-mongodb-atlas and the Atlas Go SDK use Digest-based authentication. The same credentials apply.

To learn more, see Authenticate using the Atlas Go SDK.

Error Handling

Error handling requires developers to use dedicated methods for casting errors to API error objects:

// Surrounding code omitted for brevity
apiErr, _ := admin.AsError(err)
log.Fatalf("Error when performing SDK request: %v", apiErr.GetDetail())

To learn more, see Error Handling.

Format of the API Interface

The Atlas Go SDK changes the API interface to differentiate APIs from other methods.

Each API method has an API suffix. For example:

sdk.Projects will now sdk.ProjectsApi

Each method now explains the object that is created. For example:

sdk.Projects.create() will become sdk.ProjectsApi.createProject(...)

To learn more, see the Endpoint Documentation.

Different Naming Conventions for SDK Methods

Model names and properties are formatted in PascalCase format for clarity and predictability of the methods and field names. For example, ClusterAWSProviderSettings will become now ClusterAwsProviderSettings.

The same applies to property names. For example, ID fields will become Id etc.

Multiple Choices when Creating Request Body Objects

The Atlas Go SDK improves the clarity for request and response objects. For situations when the endpoint accepts multiple formats of the payload (polymorphism), you can specify instances of the API models that you want to use for a particular request. For example, when creating a cluster you can use one of the dedicated RegionConfigs objects (AWSRegionConfig, GCPRegionConfig, etc.):

// Surrounding code omitted for brevity
RegionConfig{
    // Dedicated region config for AWS cloud
    AWSRegionConfig: &mongodbatlas.AWSRegionConfig{
        //AWS-specific fields are here
        RegionName:   &regionName,
    },
}