Sourced from github.com/aws/aws-sdk-go-v2's releases.

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

Sourced from github.com/aws/aws-sdk-go-v2's changelog.

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)

• 70cb144 Release 2020-12-23
• 762857f checkpoint for release metadata
• 4b8f9e2 regenerate apis
• 9085d3e Update README.md regarding project status (#1008)
• 149c445 Merge pull request #998 from aws/jasdel/updateAPIModels
• cbca803 regenerate apis
• 1db9e52 update API models
• 07a86e5 Regenerated Clients
• d1a795c Use static strings for enums
• 7ca5d89 XML Codegen Fixes
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
• @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
• @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
• @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
• @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language
• @dependabot badge me will comment on this PR with code to add a "Dependabot enabled" badge to your readme

Additionally, you can set the following in your Dependabot dashboard:

• Update frequency (including time of day and day of week)
• Pull request limits (per update run and/or open at any time)
• Out-of-range updates (receive only lockfile updates, if desired)
• Security updates (receive only security updates, if desired)