Release v1.2.1 (2021-03-12)

Service Client Highlights

• Bug Fix: Fixed a bug that could union shape types to be deserialized incorrectly
• Bug Fix: Fixed a bug where unboxed shapes that were marked as required were not serialized and sent over the wire, causing an API error from the service.
• Bug Fix: Fixed a bug with generated API Paginators' handling of nil input parameters causing a panic.
• Dependency Update: update smithy-go dependency
• service/detective - v1.1.2
  • Bug Fix: Fix deserialization of API response timestamp member.
• service/docdb - v1.2.0
  • Feature: Client now support presigned URL generation for CopyDBClusterSnapshot and CreateDBCluster operations by specifying the target SourceRegion
• service/neptune - v1.2.0
  • Feature: Client now support presigned URL generation for CopyDBClusterSnapshot and CreateDBCluster operations by specifying the target SourceRegion
• service/s3 - v1.2.1
  • Bug Fix: Fixed an issue where ListObjectsV2 and ListParts paginators could loop infinitely
  • Bug Fix: Fixed key encoding when addressing S3 Access Points

Core SDK Highlights

• Dependency Update: Updated SDK dependencies to their latest versions.
• config - v1.1.2
  • Bug Fix: Fixed a panic when using WithEC2IMDSRegion without a specified IMDS client

Release v1.2.0 (2021-02-09)

Service Client Highlights

• service/s3 - v1.2.0
  • Feature: adds support for s3 vpc endpoint interface #1113
• service/s3control - v1.2.0
  • Feature: adds support for s3 vpc endpoint interface #1113

Core SDK Highlights

• Dependency Update: Updated SDK dependencies to their latest versions.
• aws - v1.2.0
  • Feature: support to add endpoint source on context. Adds getter/setter for the endpoint source #1113
• config - v1.1.1
  • Bug Fix: Only Validate SSO profile configuration when attempting to use SSO credentials #1103
  • Bug Fix: Environment credentials were not taking precedence over AWS_PROFILE #1103

Release v1.1.0 (2021-01-29)

Service Client Highlights

• Bug Fix: A serialization bug has been fixed that caused some service operations with empty inputs to not be serialized correctly (#1071)
• Bug Fix: Fixes a bug that could cause a waiter to fail when comparing types (#1083)

Core SDK Highlights

• Feature: EndpointResolverFromURL helpers have been added for constructing a service EndpointResolver type (#1066)
• Dependency Update: Updated SDK dependencies to their latest versions.
• aws - v1.1.0
  • Feature: Add support for specifying the EndpointSource on aws.Endpoint types (#1070)
• config - v1.1.0
  • Feature: Add Support for AWS Single Sign-On (SSO) credential provider (#1072)
• credentials - v1.1.0
  • Feature: Add AWS Single Sign-On (SSO) credential provider (#1072)

Release v1.0.0 (2021-01-19)

Announcement

We are excited to announce the General Availability (GA) release of the AWS SDK for Go version 2 (v2). This release follows the Release candidate of the AWS SDK for Go v2. Version 2 incorporates customer feedback from version 1 and takes advantage of modern Go language features.

New Features

• service/sts: Add support for presigning GetCallerIdentity operation (#1030)
  • Adds a PresignClient to the sts API client module. Use PresignGetCallerIdentity to obtain presigned URLs for the create presigned URLs for the GetCallerIdentity operation.
  • Fixes #1021
• aws/retry: Add package documentation for retry package (#1033)
  • Adds documentation for the retry package

Bug Fixes

• Multiple API Clients: Fix SDK's generated serde for unmodeled operation input/output (#1050)
  • Fixes #1047 by fixing the how the SDKs generated serialization and deserialization of API operations that did not have modeled input or output types. This caused the SDK to incorrectly attempt to deserialize response documents that were either empty, or contained unexpected data.
• service/s3: Fix Tagging parameter not serialized correctly for presigned PutObject requests (#1017)
  • Fixes the Tagging parameter incorrectly being serialized to the URL's query string instead of being signed as a HTTP request header.
  • When using PresignPutObject make sure to add all signed headers returned by the method to your down stream's HTTP client's request. These headers must be included in the request, or the request will fail with signature errors.
  • Fixes #1016
• service/s3: Fix Unmarshaling GetObjectAcl operation's Grantee type response (#1034)
  • Updates the SDK's codegen for correctly deserializing XML attributes in tags with XML namespaces.
  • Fixes #1013
• service/s3: Fix Unmarshaling GetBucketLocation operation's response (#1027)
  • Fixes #908

Breaking Changes

• aws: Updated Config.Retryer member to be a func that returns aws.Retryer (#1033)
  • Updates the SDK's references to Config.Retryer to be a function that returns aws.Retryer value. This ensures that custom retry options specified in the aws.Config are scoped to individual client instances.
  • All API clients created with the config will call the Config.Retryer function to get an aws.Retryer.
  • Removes duplicate Retryer interface from retry package. Single definition is aws.Retryer now.
• aws/middleware: Updates AddAttemptClockSkewMiddleware to use appropriate AddRecordResponseTiming naming (#1031)
  • Removes ResponseMetadata struct type, and adds its members to middleware metadata directly, to improve discoverability.
• config: Updated the WithRetryer helper to take a function that returns an aws.Retryer (#1033)
  • All API clients created with the config will call the Config.Retryer function to get an aws.Retryer.
• API Clients: Fix SDK's API client enum constant name generation to have expected casing (#1020)
  • This updates of the generated enum const value names in API client's types package to have the expected casing. Prior to this, enum names were being generated with lowercase names instead of camel case.
• API Clients: Updates SDK's API client request middleware stack values to be scoped to individual operation call (#1019)
  • The API client request middleware stack values were mistakenly allowed to escape to nested API operation calls. This broke the SDK's presigners.
  • Stack values that should not escape are not scoped to the individual operation call.
• Multiple API Clients: Unexported the API client's WithEndpointResolver this type wasn't intended to be exported (#1051)
  • Using the aws.Config.EndpointResolver member for setting custom endpoint resolver instead.

Migrating from v2 preview SDK's v0.31.0 to v1.0.0

aws.Config Retryer member

If your application sets the Config.Retryer member the application will need
to be updated to set a function that returns an aws.Retryer. In addition, if
your application used the config.WithRetryer helper a function that returns
an aws.Retryer needs to be used.

If your application used the retry.Retryer type, update to using the
aws.Retryer type instead.

API Client enum value names

If your application used the enum values in the API Client's types package between v0.31.0 and the latest version of the client module you may need to update the naming of the enum value. The enum value name casing were updated to camel case instead lowercased.

Release 2020-12-23 (Release Candidate 1)

We’re happy to announce the Release Candidate (RC) of the AWS SDK for Go v2.
This RC follows the developer preview release of the AWS SDK for Go v2. The SDK
has undergone a major rewrite from the v1 code base to incorporate your
feedback and to take advantage of modern Go language features.

Documentation

• Developer Guide: https://aws.github.io/aws-sdk-go-v2/docs/
• API Reference docs: https://pkg.go.dev/github.com/aws/aws-sdk-go-v2
• Migration Guide: https://aws.github.io/aws-sdk-go-v2/docs/migrating/

Breaking Changes

• Dependency github.com/awslabs/smithy-go has been relocated to github.com/aws/smithy-go
  • The smithy-go repository was moved from the awslabs GitHub organization to aws.
  • xml, httpbinding, and json package relocated under encoding package.
• The module ec2imds moved to feature/ec2/imds path (#984)
  • Moves the ec2imds feature module to be in common location as other SDK features.
• aws/signer/v4: Refactor AWS Sigv4 Signer and options types to allow function options (#955)
  • Fixes #917, #960, #958
• aws: CredentialCache type updated to require constructor function (#946)
  • Fixes #940
• credentials: ExpiryWindow and Jitter moved from credential provider to CredentialCache (#946)
  • Moves ExpiryWindow and Jitter options to common option of the CredentialCache instead of duplicated across providers.
  • Fixes #940
• config: Ensure shared credentials file has precedence over shared config file (#990)
  • The shared config file was incorrectly overriding the shared credentials file when merging values.
• config: Add context.Context to LoadDefaultConfig (#951)
  • Updates config#LoadDefaultConfig function to take context.Context as well as functional options for the config#LoadOptions type.
  • Fixes #926, #819
• aws: Rename NoOpRetryer to NopRetryer to have consistent naming with rest of SDK (#987)
  • Fixes #878
• service/s3control: Change S3InitiateRestoreObjectOperation.ExpirationInDays from value to pointer type (#988)
• aws: ReaderSeekerCloser and WriteAtBuffer have been relocated to feature/s3/manager.

New Features

• Waiters: Add Waiter utilities for API clients (aws/smithy-go#237)
  • Your application can now use Waiter utilities to wait for AWS resources.
• feature/dynamodb/attributevalue: Add Amazon DynamoDB Attribute value marshaler utility (#948)
  • Adds a utility for marshaling Go types too and from Amazon DynamoDB AttributeValues.
  • Also includes utility for converting from Amazon DynamoDB Streams AttributeValues to Amazon DynamoDB AttributeValues.
• feature/dynamodbstreams/attributevalue: Add Amazon DynamoDB Streams Attribute value marshaler utility (#948)
  • Adds a utility for marshaling Go types too and from Amazon DynamoDB Streams AttributeValues.
  • Also includes utility for converting from Amazon DynamoDB AttributeValues to Amazon DynamoDB Streams AttributeValues.
• feature/dynamodb/expression: Add Amazon DynamoDB expression utility (#981)
  • Adds the expression utility to the SDK for easily building Amazon DynamoDB operation expressions in code.

Bug Fixes

• service/s3: Fix Presigner to configure client correctly for Amazon S3 (#969)
• service/s3: Fix deserialization of CompleteMultipartUpload (#965
  • Fixes #927
• codegen: Fix API client union serialization (#979)
  • Fixes #978

Service Client Highlights

• API Clients have been bumped to version v0.31.0
• Regenerate API Clients from updated API models adding waiter utilities, and union parameters.
• codegen:
  • Add documentation to union API parameters describing valid member types, and usage example (aws/smithy-go#239)
  • Normalize Metadata header map keys to be lower case (aws/smithy-go#241), (#982)
    • Fixes #376 Amazon S3 Metadata parameters keys are always returned as lower case.
  • Fix API client deserialization of XML based responses (aws/smithy-go#245), (#992)
    • Fixes #910
• service/s3, service/s3control:
  • Add support for reading s3_use_arn_region from shared config file (#991)
  • Add Utility for getting RequestID and HostID of response (#983)

Other changes

• Updates branch HEAD points from master to main.
  • This should not impact your application, but if you have pull requests or forks of the SDK you may need to update the upstream branch your fork is based off of.

Migrating from v2 preview SDK's v0.30.0 to v0.31.0 release candidate

smithy-go module relocation

If your application uses smithy-go utilities for request pipeline your application will need to be updated to refer to the new import path of github.com/aws/smithy-go. If you application did not use smithy-go utilities directly, your application will update automatically.

EC2 IMDS module relocation

If your application used the ec2imds module, it has been relocated to feature/ec2/imds. Your application will need to update to the new import path, github.com/aws/aws-sdk-go-v2/feature/ec2/imds.

CredentialsCache Constructor and ExpiryWindow Options

The aws#CredentialsCache type was updated, and a new constructor function, NewCredentialsCache was added. This function needs to be used to initialize the CredentialCache. The constructor also has function options to specify additional configuration, e.g. ExpiryWindow and Jitter.

If your application was specifying the ExpiryWindow with the credentials/stscreds#AssumeRoleOptions, credentials/stscreds#WebIdentityRoleOptions, credentials/processcreds#Options, or credentials/ec2rolecrds#Options types the ExpiryWindow option will need to specified on the CredentialsCache constructor instead.

AWS Sigv4 Signer Refactor

The aws/signer/v4 package's Signer.SignHTTP and Signer.PresignHTTP methods were updated to take functional options. If your application provided a custom implementation for API client's HTTPSignerV4 or HTTPPresignerV4 interfaces, that implementation will need to be updated for the new function signature.

Configuration Loading

The config#LoadDefaultConfig function has been updated to require a context.Context as the first parameter, with additional optional function options as variadic additional arguments. Your application will need to update its usage of LoadDefaultConfig to pass in context.Context as the first parameter. If your application used the With... helpers those should continue to work without issue.

The v2 SDK corrects its behavior to be inline with the AWS CLI and other AWS SDKs. Refer to https://docs.aws.amazon.com/credref/latest/refdocs/overview.html for more information how to use the shared config and credentials files.

Release 2020-11-30

Breaking Change

• codegen: Add support for slice and maps generated with value members instead of pointer (#887)
  • This update allow the SDK's code generation to be aware of API shapes and members that are not nullable, and can be rendered as value types by the code generation instead of pointer types.
  • Several API client parameter types will change from pointer members to value members for slice, map, number and bool member types.
  • See Migration notes for migrating to v0.30.0 with this change.
• aws/transport/http: Move aws.BuildableHTTPClient to HTTP transport package (#898)
  • Moves the BuildableHTTPClient from the SDK's aws package to the aws/transport/http package as BuildableClient to with other HTTP specific utilities.
• feature/cloudfront/sign: Add CloudFront sign feature as module (#884)
  • Moves service/cloudfront/sign package out of the cloudfront module, and into its own module as github.com/aws/aws-sdk-go-v2/feature/cloudfront/sign.

New Features

• config: Add a WithRetryer provider helper to the config loader (#897)
  • Adds a WithRetryer configuration provider to the config loader as a convenience helper to set the Retryer on the aws.Config when its being loaded.
• config: Default to TLS 1.2 for HTTPS requests (#892)
  • Updates the SDK's default HTTP client to use TLS 1.2 as the minimum TLS version for all HTTPS requests by default.

Bug Fixes

• config: Fix AWS_CA_BUNDLE usage while loading default config (#912)
  • Fixes the LoadDefaultConfig's configuration provider order to correctly load a custom HTTP client prior to configuring the client for AWS_CA_BUNDLE environment variable.
• service/s3: Fix signature mismatch error for s3 (#913)
  • Fixes (#883)
• service/s3control:
  • Fix HostPrefix addition behavior for s3control (#882)
    • Fixes (#863)
  • Fix s3control error deserializer (#875)
    • Fixes (#864)

Service Client Highlights

• Pagination support has been added to supported APIs. See Using Operation Paginators in the Developer Guide. (#885)
• Logging support has been added to service clients. See Logging in the Developer Guide. (#872)
• service: Add support for pre-signed URL clients for S3, RDS, EC2 service (#888)
  • service/s3: operations PutObject and GetObject are now supported with s3 pre-signed url client.
  • service/ec2: operation CopySnapshot is now supported with ec2 pre-signed url client.
  • service/rds: operations CopyDBSnapshot, CreateDBInstanceReadReplica, CopyDBClusterSnapshot, CreateDBCluster are now supported with rds pre-signed url client.
• service/s3: Add support for S3 access point and S3 on outposts access point ARNs (#870)
• service/s3control: Adds support for S3 on outposts access point and S3 on outposts bucket ARNs (#870)

Migrating from v2 preview SDK's v0.29.0 to v0.30.0

aws.BuildableHTTPClient move

The aws's BuildableHTTPClient HTTP client implementation was moved to aws/transport/http as BuildableClient. If your application used the aws.BuildableHTTPClient type, update it to use the BuildableClient in the aws/transport/http package.

Slice and Map API member types

This release includes several code generation updates for API client's slice map members. Using API modeling metadata the Slice and map members are now generated as value types instead of pointer types. For your application this means that for these types, the SDK no longer will have pointer member types, and have value member types.

To migrate to this change you'll need to remove the pointer handling for slice and map members, and instead use value type handling of the member values.

Boolean and Number API member types

Similar to the slice and map API member types being generated as value, the SDK's code generation now has metadata where the SDK can generate boolean and number members as value type instead of pointer types.

To migrate to this change you'll need to remove the pointer handling for numbers and boolean member types, and instead use value handling.

Release 2020-10-30

New Features

• Adds HostnameImmutable flag on aws.Endpoint to direct SDK if the associated endpoint is modifiable.(#848)

Bug Fixes

• Fix SDK handling of xml based services - xml namespaces (#858)
  • Fixes (#850)

Service Client Highlights

• API Clients have been bumped to version v0.29.0
  • Regenerate API Clients from update API models.
• Improve client doc generation.

Core SDK Highlights

• Dependency Update: Updated SDK dependencies to their latest versions.

Migrating from v2 preview SDK's v0.28.0 to v0.29.0

• API Clients ResolverOptions type renamed to EndpointResolverOptions

Release 2020-10-26

New Features

• service/s3: Add support for Accelerate, and Dualstack (#836)
• service/s3control: Add support for Dualstack (#836)

Service Client Highlights

• API Clients have been bumped to version v0.28.0
  • Regenerate API Clients from update API models.
• service/s3: Add support for Accelerate, and Dualstack (#836)
• service/s3control: Add support for Dualstack (#836)
• service/route53: Fix sanitizeURL customization to handle leading slash(/) #846
  • Fixes #843
• service/route53: Fix codegen to correctly look for operations that need sanitize url (#851)

Core SDK Highlights

• aws/protocol/restjson: Fix unexpected JSON error response deserialization (#837)
  • Fixes #832
• example/service/s3/listobjects: Add example for Amazon S3 ListObjectsV2 (#838)

Release 2020-10-16

New Features

• feature/s3/manager:
  • Initial v0.1.0 release
  • Add the Amazon S3 Upload and Download transfer manager (#802)

Service Client Highlights

• Clients have been bumped to version v0.27.0
• service/machinelearning: Add customization for setting client endpoint with PredictEndpoint value if set (#782)
• service/s3: Fix empty response body deserialization in case of error response (#801)
  • Fixes xml deserialization util to correctly handle empty response body in case of an error response.
• service/s3: Add customization to auto fill Content-Md5 request header for Amazon S3 operations (#812)
• service/s3: Add fallback to using HTTP status code for error code (#818)
  • Adds falling back to using the HTTP status code to create a API Error code when not error code is received from the service, such as HeadObject.
• service/route53: Add support for deserialzing InvalidChangeBatch API error (#792)
• codegen: Remove API client Options getter methods (#788)
• codegen: Regenerate API Client modeled endpoints (#791)
• codegen: Sort API Client struct member paramaters by required and alphabetical (#787)
• codegen: Add package docs to API client modules (#821)
• codegen: Rename smithy-go's smithy.OperationError to smithy.OperationInvokeError.

Core SDK Highlights

• config:
  • Bumped to v0.2.0
  • Refactor Config Module, Add Config Package Documentation and Examples, Improve Overall SDK Readme (#822)
• credentials:
  • Bumped to v0.1.2
  • Strip Monotonic Clock Readings when Comparing Credential Expiry Time (#789)
• ec2imds:
  • Bumped to v0.1.2
  • Fix refreshing API token if expired (#789)

Migrating from v0.26.0 to v0.27.0

Configuration

The config module's exported types were trimmed down to add clarity and reduce confusion. Additional changes to the config module' helpers.

• Refactored WithCredentialsProvider, WithHTTPClient, and WithEndpointResolver to functions instead of structs.
• Removed MFATokenFuncProvider, use AssumeRoleCredentialOptionsProvider for setting options for stscreds.AssumeRoleOptions.
• Renamed WithWebIdentityCredentialProviderOptions to WithWebIdentityRoleCredentialOptions
• Renamed AssumeRoleCredentialProviderOptions to AssumeRoleCredentialOptionsProvider
• Renamed EndpointResolverFuncProvider to EndpointResolverProvider

API Client

• API Client Options type getter methods have been removed. Use the struct members instead.
• The error returned by API Client operations was renamed from smithy.OperationError to smithy.OperationInvokeError.

Release 2020-09-30

Service Client Highlights

• Service clients have been bumped to v0.26.0 simplify the documentation experience when using pkg.go.dev.
• service/s3: Disable automatic decompression of getting Amazon S3 objects with the Content-Encoding: gzip metadata header. (#748)
  • This changes the SDK's default behavior with regard to making S3 API calls. The client will no longer automatically set the Accept-Encoding HTTP request header, nor will it automatically decompress the gzipped response when the Content-Encoding: gzip response header was received.
  • If you'd like the client to sent the Accept-Encoding: gzip request header, you can add this header to the API operation method call with the SetHeaderValue. middleware helper.
• service/cloudfront/sign: Fix cloudfront example usage of SignWithPolicy (#673)
  • Fixes #671 documentation typo by correcting the usage of SignWithPolicy.

Core SDK Highlights

• SDK core module released at v0.26.0
• config module released at v0.1.1
• credentials module released at v0.1.1
• ec2imds module released at v0.1.1