Releases: aws/aws-sdk-go-v2
Release v0.17.0 (2019-11-20)
Services
- Synced the V2 SDK with latest AWS service API definitions.
SDK Enhancements
- SDK minimum version requirement has been updated to Go 1.12 (#432)
Release v0.16.0 (2019-11-12)
Services
- Synced the V2 SDK with latest AWS service API definitions.
Release v0.15.0 (2019-10-18)
Services
- Synced the V2 SDK with latest AWS service API definitions.
Release v0.14.0 (2019-10-08)
Services
- Synced the V2 SDK with latest AWS service API definitions.
Release v0.13.0 (2019-10-01)
Services
- Synced the V2 SDK with latest AWS service API definitions.
SDK Breaking changes
- This update includes breaking changes to how the DynamoDB AttributeValue (un)marshier handles empty collections.
Deprecations
service/s3/s3crypto
: Deprecates the crypto client from the SDK (#394)- s3crypto client is now deprecated and may be removed from the future versions of the SDK.
aws
: Removes plugin credential provider (#391)- Removing plugin credential provider from the v2 SDK developer preview. This feature may be made available as a separate module.
- Removes support for deprecated Go versions (#393)
- Removes support for Go version specific files from the SDK. Also removes irrelevant build tags, and updates the README.md file.
- Raises the minimum supported version to Go 1.11 for the SDK. Older versions may work, but are not actively supported
SDK Features
service/s3/s3manager
: Add Upload Buffer Provider (#404)- Adds a new
BufferProvider
member for specifying how part data can be buffered in memory. - Windows platforms will now default to buffering 1MB per part to reduce contention when uploading files.
- Non-Windows platforms will continue to employ a non-buffering behavior.
- Adds a new
service/s3/s3manager
: Add Download Buffer Provider (#404)- Adds a new
BufferProvider
member for specifying how part data can be buffered in memory when copying from the http response body. - Windows platforms will now default to buffering 1MB per part to reduce contention when downloading files.
- Non-Windows platforms will continue to employ a non-buffering behavior.
- Adds a new
service/dynamodb/dynamodbattribute
: New Encoder and Decoder Behavior for Empty Collections (#401)- The
Encoder
andDecoder
types have been enhanced to support the marshaling of empty structures, maps, and slices to and from their respective DynamoDB AttributeValues. - This change incorporates the behavior changes introduced via a marshal option in V1 (#2834)
- The
SDK Enhancements
internal/awsutil
: Add suppressing logging sensitive API parameters (#398)- Adds suppressing logging sensitive API parameters marked with the
sensitive
trait. This prevents the API type'sString
method returning a string representation of the API type with sensitive fields printed such as keys and passwords. - Related to aws/aws-sdk-go#2310
- Fixes #251
- Adds suppressing logging sensitive API parameters marked with the
aws/request
: Retryer is now a named field on Request. (#393)service/s3/s3manager
: Addssync.Pool
to allow reuse of part buffers for streaming payloads (#404)
SDK Bugs
service/s3/s3manager
: Fix index out of range when a streaming reader returns -1 (#378)- Fixes the S3 Upload Manager's handling of an unbounded streaming reader that returns negative bytes read.
internal/ini
: Fix ini parser to handle empty values #406- Fixes incorrect modifications to the previous token value of the skipper. Adds checks for cases where a skipped statement should be marked as complete and not be ignored.
- Adds tests for nested and empty field value parsing, along with tests suggested in aws/aws-sdk-go#2801
Release v0.12.0 (2019-09-17)
Services
- Synced the V2 SDK with latest AWS service API definitions.
SDK Enhancements
aws/endpoints
: Expose DNSSuffix for partitions (#369)- Exposes the underlying partition metadata's DNSSuffix value via the
DNSSuffix
method on the endpoint'sPartition
type. This allows access to the partition's DNS suffix, e.g. "amazon.com". - Fixes #347
- Exposes the underlying partition metadata's DNSSuffix value via the
private/protocol
: Add support for parsing fractional timestamp (#367)- Fixes the SDK's ability to parse fractional unix timestamp values and adds tests.
- Fixes #365
aws/ec2metadata
: Add marketplaceProductCodes to EC2 Instance Identity Document (#374)- Adds
MarketplaceProductCodes
to the EC2 Instance Metadata's Identity Document. The ec2metadata client will now retrieve these values if they are available. - Related to: aws/aws-sdk-go#2781
- Adds
aws
: Adds configurations to the default retryer (#375)- Provides more customization options for retryer by adding a constructor for default Retryer which accepts functional options. Adds NoOpRetryer to support no retry behavior. Exposes members of default retryer.
- Updates the underlying logic used by the default retryer to calculate jittered delay for retry. Handles int overflow for retry delay.
- Fixes #370
aws
: Refactors request retry behavior path logic (#384)
SDK Bugs
aws
: Fixes bug in calculating throttled retry delay (#373)- The
Retry-After
duration specified in the request is now added to the Retry delay for throttled exception. Adds test for retry delays for throttled exceptions. Fixes bug where the throttled retry's math was off. - Fixes #45
- The
aws
: Adds missing sdk error checking when seeking readers (#379)- Adds support for nonseekable io.Reader. Adds support for streamed payloads for unsigned body request.
- Fixes #371
service/s3
: Fixes unexpected EOF error by s3manager (#386)- Fixes bug which threw unexpected EOF error when s3 upload is performed for a file of maximum allowed size
- Fixes #316
private/model
: Fixes generated API Reference docs links being invalid (387)- Fixes #327
Release v0.11.0 (2019-08-22)
Services
- Synced the V2 SDK with latest AWS service API definitions.
- Fixes #359
SDK Features
SDK Enhancements
private/protocol
: Add support for TimestampFormat in protocols (#358)aws
: Add example for custom HTTP client idle connection options (#350)- Adds example to the SDK for configuring custom HTTP client idle connection keep alive options.
SDK Bugs
private/model/api
: Fix API doc being generated with wrong value (#359)- Fixes the SDK's generated API documentation for structure member being generated with the wrong documentation value when the member was included multiple times in the model doc-2.json file, but under different types.
- V2 port of to v1 aws/aws-sdk-go#2748
aws/ec2rolecreds
: Fix security creds path to include trailing slash (#356)- Fixes the iamSecurityCredsPath var to include a trailing slash preventing redirects when making requests to the EC2 Instance Metadata service.
- Fixes #351
service/dynamodb/expression
: Improved reporting of bad key conditions (#360)- Improved error reporting when invalid key conditions are constructed using KeyConditionBuilder
Release v0.10.0 (2019-07-24)
Services
SDK Breaking Changes
aws
: Add default HTTP client instead of http.DefaultClient/Transport (#315)- Adds a new BuildableHTTPClient type to the SDK's aws package. The type uses the builder pattern with immutable changes. Modifications to the buildable client create copies of the client. Adds a HTTPClient interface to the aws package that the SDK will use as an abstraction over the specific HTTP client implementation. The SDK will default to the BuildableHTTPClient, but a *http.Client can be also provided for custom configuration. When the SDK's aws.Config.HTTPClient value is a BuildableHTTPClient the SDK will be able to use API client specific request timeout options.
- Fixes #279
- Fixes #269
SDK Enhancements
service/s3/s3manager
: Update S3 Upload Multipart location (#324)- Updates the Location returned value of S3 Upload's Multipart UploadOutput type to be consistent with single part upload URL. This update also brings the multipart upload Location inline with the S3 object URLs created by the SDK.
- Fixes #323
- V2 Port aws/aws-sdk-go#2453
SDK Bugs
private/model
: Handles empty map vs unset map behavior in send request (#337)- Updated shape marshal model to handle the empty map vs nil map behavior. Adding a test case to assert behavior when a user sends an empty map vs nil map.
- Fix #332
service/rds
: Fix presign URL for same region (#331)- Fixes RDS no-autopresign URL for same region issue for aws-sdk-go-v2. Solves the issue by making sure that the presigned URLs are not created, when the source and destination regions are the same. Added and updated the tests accordingly.
- Fix #271
private/protocola/json/jsonutil
: Fix Unmarshal map[string]bool (#320)- Fixes the JSON unmarshaling of maps of bools. The unmarshal case was missing the condition for bool value, in addition the bool pointer.
- Fix #319
Release v0.9.0 (2019-05-28)
Services
SDK Breaking changes
This update includes multiple breaking changes to the SDK. These updates improve the SDK's usability, consistency.
Client type name
The API client type is renamed to Client
for consistency, and remove stutter between package and client type name. Using Amazon S3 API client as an example, the s3.S3
type is renamed to s3.Client
.
New API operation response type
API operations' Request.Send
method now returns a Response type for the specific operation. The Response type wraps the operation's Output parameter, and includes a method for the response's metadata such as RequestID. The Output type is an anonymous embedded field within the Output type. If your application was passing the Output value around you'll need to extract it directly, or pass the Response type instead.
New API operation paginator utility
This change removes the Paginate
method from API operation Request types, (e.g. ListObjectsRequest). A new Paginator constructor is added that can be used to page these operations. To update your application to use the new pattern, where Paginate
was being called, replace this with the Paginator type's constructor. The usage of the returned Paginator type is unchanged.
req := svc.ListObjectsRequest(params)
p := req.Paginate()
Is updated to to use the Paginator constructor instead of Paginate method.
req := svc.ListObjectsRequest(params)
p := s3.NewListObjectsPaginator(req)
Other changes
- Standardizes API client package name to be based on the API model's
ServiceID
. - Standardizes API client operation input and output type names.
- Removes
endpoints
package's service identifier constants. These values were unstable. Each API client package contains anEndpointsID
constant that can be used for service specific endpoint lookup. - Fix API endpoint lookup to use the API's modeled
EndpointsID
(akaenpdointPrefix
). Searching for API endpoints in theendpoints
package should use the API client package's,EndpointsID
.
SDK Enhancements
-
Update CI tests to ensure all codegen changes are accounted for in PR (#183)
-
Updates the CI tests to ensure that any code generation changes are accounted for in the PR, and that there were no mistaken changes made without also running code generation. This change should also help ensure that code generation order is stable, and there are no ordering issues with the SDK's codegen.
-
Related aws/aws-sdk-go#1966
-
service/dynamodb/expression
: Fix Builder with KeyCondition example (#306)- Fixes the ExampleBuilder_WithKeyCondition example to include the ExpressionAttributeNames member being set.
- Fixes #285
-
aws/defaults
: Fix UserAgent execution environment key (#307)- Fixes the SDK's UserAgent key for the execution environment.
- Fixes #276
-
private/model/api
: Improve SDK API reference doc generation (#309)- Improves the SDK's generated documentation for API client, operation, and types. This fixes several bugs in the doc generation causing poor formatting, an difficult to read reference documentation.
- Fix #308
- Related aws/aws-sdk-go#2617
Release v0.8.0 (2019-04-25)
Services
- Synced the V2 SDK with latest AWS service API definitions.
SDK Breaking changes
- Update SDK API operation request send to required Context (#265)
- Updates the SDK's API operation request Send method to require a context.Context value when called. This is done to encourage best applications to use Context for cancellation and request tracing. Standardizing on this pattern will also help reduce code paths which accidentally do not have the Context causing the cancellation and tracing chain to be lost. Leading to difficult to trace down losses of cancellation and tracing within an application.
- Fixes #264
SDK Enhancements
- Update README.md for getting SDK without Go Modules
- Updates the README.md with instructions how to get the SDK without Go Modules enabled, or using the SDK within a GOPATH with Go 1.11, and Go 1.12.
- Refactor SDK's integration tests to be code generated (#283)
aws
: Add RequestThrottledException to set of throttled exceptions (#292)private/model/api
: Backfill authtype, STS and Cognito Identity (#293)- Backfills the authtype=none modeled trait for STS and Cognito Identity services. This removes the in code customization for these two services' APIs that should not be signed.
SDK Bugs
- Fix HTTP endpoint credential provider test for unresolved hosts (#262)
- Fixes the HTTP endpoint credential provider's tests to check for a host that resolves to no addresses.
example/service/s3/mockPaginator
: Update example to not use internal pkg (#278)- Updates the SDK's S3 Mock Paginator example to not use internal SDK packages and instead use the SDK's provided defaults package for default configuration.
- Fixes #116
- Cleanup go mod unused dependencies (#284)
service/s3/s3manager
: Fix brittle Upload unit test (#288)aws/ec2metadata
: Fix EC2 Metadata client panic with debug logging (#290)- Fixes a panic that could occur within the EC2 Metadata client when both AWS_EC2_METADATA_DISABLED env var is set and log level is LogDebugWithHTTPBody. The SDK's client response body debug functionality would panic because the Request.HTTPResponse value was not specified.
aws
: Fix RequestUserAgent test to be stable (#289)private/protocol/rest
: Trim space in header key and value (#291)- Fixes a bug when using S3 metadata where metadata values with leading spaces would trigger request signature validation errors when the request is received by the service.