Document history
This topic describes important changes to the AWS SDK for Java Developer Guide over the course of its history.
| Change | Description | Date |
|---|---|---|
| Download objects through a direct buffer pool with the AWS CRT-based S3 client | Add a guide on downloading Amazon S3 objects through a direct buffer pool with the AWS CRT-based S3 client and the Amazon S3 Transfer Manager. | November 13, 2026 |
| Retries | Document the standard retry strategy as the default starting with version
2.58.0. Update the default values of the standard and adaptive retry strategies.
Describe how to keep the previous default retry behavior with the legacy retry
strategy. Add the
doNotRetryWhen method. |
November 10, 2026 |
| Publish SDK metrics with the CRT-based S3 client | Added support for publishing SDK metrics with the AWS CRT-based S3 client at both the client and request levels. | November 6, 2026 |
| Limit the total number of results | Clarify that the maxResults parameter on a request sets the page size, not the total number of items. Add examples that limit the total number of items across all pages. |
October 6, 2026 |
| Migrating Amazon S3 pre-signed URL downloads from v1 to v2 | Add migration guide for pre-signed URL downloads from v1 to v2 | July 15, 2026 |
| Pre-signed URL download examples for Amazon S3 | Add pre-signed URL download examples using S3AsyncClient pre-signed URL extension and S3 Transfer Manager | July 15, 2026 |
| Current key | Add new PGP key that expires on 2026-09-27. | October 1, 2025 |
| Unsupported code patterns | Document the unsupported code patterns of the migration tool. | September 23, 2025 |
| Migration tool | Updates for GA release. | September 19, 2025 |
| Metrics reference | Add more details about metrics collected by the SDK. | September 3, 2025 |
| Implement optimistic locking with the VersionedRecordExtension | Add details about DynamoDB Enhanced Client's
VersionRecordExtension. |
September 2, 2025 |
| Find applications using 1.x clients | Add instructions to help identify applications using AWS SDK for Java 1.x clients by querying AWS CloudTrail events before migrating to version 2. | August 20, 2025 |
| Transfer Manager | Add comprehensive migration tables for client constructors, methods, model objects, and behavior changes. Included detailed code examples for unsupported methods requiring manual migration. | July 1, 2025 |
| Metrics | Add comprehensive documentation for LoggingMetricPublisher. Restructured the metrics topic with improved getting-started guidance. | June 20, 2025 |
| High-level changes in mapping libraries from version 1 to version 2 of the SDK for Java | Add information about empty string handling differences between
DynamoDBMapper (v1) and DynamoDB Enhanced Client (v2) in the
migration guide. |
June 18, 2025 |
| Table of contents reorganization | Add Configuring service clients in the AWS SDK for Java 2.x chapter assembled from other sections of the guide. | June 16, 2025 |
| Use the LegacyMd5Plugin for simplified MD5 compatibility | Add information about using the LegacyMd5Plugin for backward
compatibility with systems that require MD5 checksums. |
May 19, 2025 |
| S3 client differences between version 1 and version 2 of the AWS SDK for Java | Add S3 client differences between v1 and v2 of the AWS SDK for Java and provide migration examples if the migration tool cannot automatically migrate the V1 code. | April 24, 2025 |
| Deserialization differences | Add deserialization difference between v1 and v2 of the SDK for Java. | April 10, 2025 |
| Changes in automatic Amazon SQS request batching from version 1 to version 2 | Add migration content for SQS automatic request batching from v1 to v2 of the SDK for Java. | April 8, 2025 |
| Other checksum calculation options | Update information about automatic checksum calculations | April 3, 2025 |
| Configure ALPN protocol negotiation | Show configuration of ALPN protocol negotiation with the Netty-based HTTP client. | February 21, 2025 |
| Publish SDK metrics for AWS Lambda functions using the AWS SDK for Java 2.x | Add information about using the EMF logging metric publisher with AWS Lambda to capture SDK metrics. | February 6, 2025 |
| Implement ContentStreamProvider | Add topic on how to implement a ContentStreamProvider. |
January 29, 2025 |
| Data integrity protection with checksums | Content updated with details about automatic checksum calculation. | January 16, 2025 |
| Changes in working with Amazon S3 from version 1 to version 2 of the AWS SDK for Java | Add migration content for working with Amazon S3. | January 8, 2025 |
| Access the AWS CRT-based HTTP clients | Add information about how to used a platform-specific jar with AWS CRT-based components. | November 14, 2024 |
| Use IAM Roles Anywhere for authentication | Add information about how to use IAM Roles Anywhere for authentication. | November 6, 2024 |
| Caching credentials configuration example | Add an example that configures a credentials provider by using the
asyncCredentialUpdateEnabled property. |
November 4, 2024 |
| Use automatic request batching for Amazon SQS with the AWS SDK for Java 2.x | Add a new topic that documents the Automatic Request Batching API for Amazon SQS. | October 23, 2024 |
| OpenPGP key for the AWS SDK for Java | Update current OpenPGP key information. | October 10, 2024 |
| Use complex types in expressions and Update items that contain complex types | Add content for how to work with complex types in expressions and updates. | October 10, 2024 |
| Update Amazon S3 bucket names | Update Amazon S3 bucket names. | September 30, 2024 |
| Optimize performance with account-based endpoints | Add information about AWS account-based endpoints for DynamoDB. | September 24, 2024 |
| Work with attributes that are beans, maps, lists and sets | Update section for DynamoDB Enhance Client that discusses working with attributes that are complex types. | September 6, 2024 |
| Configure service clients to shortcut lookups | Clarify use of the EnvironmentVariableCredentialsProvider when
Lambda SnapStart for Java is used. |
August 19, 2024 |
| Configure the Java-based S3 async client to use parallel transfers | Add page with information on how to enable parallel transfer support | August 15, 2024 |
| Generate a UUID with the AutoGeneratedUuidExtension | Add information about the DynamoDB Enhanced Client
AutoGeneratedUuidExtension |
August 14, 2024 |
| AWS SDK for Java migration tool | Add a section about the migration tool (preview release) | August 9, 2024 |
| Work with S3 Event Notifications | Add section that discusses how to work with the S3 Event Notifications API | July 21, 2024 |
| Changes in working with DynamoDB from version 1 to version 2 of the AWS SDK for Java | Add v1 to v2 migration information for the DynamoDB mapping/document APIs | July 21, 2024 |
| Changes in the S3 Event Notifications API from version 1 to version 2 | Add v1 to b2 migration information for the S3 Event Notifications API | July 21, 2024 |
| Configure retry behavior in the AWS SDK for Java 2.x | Add retry strategy topic | June 18, 2024 |
| How to set the JVM TTL | Remove instructions to set networkaddress.cache.ttl security
property by using a java command-line system property. |
May 21, 2024 |
| Reduce SDK startup time for AWS Lambda | Update HTTP client recommendation to reduce startup time for AWS Lambda | May 14, 2024 |
| AWS SDK for Java 2.x: Comprehensive Metrics Reference | Reorganize metrics table items | May 1, 2024 |
| Troubleshooting FAQs | Add troubleshooting topic. | April 26, 2024 |
| Metrics collected with each request | Add new metrics reported by the SDK. | April 26, 2024 |
| Set the JVM TTL for DNS name lookups | Change recommended DNS lookup TTL to 5 seconds. | April 23, 2024 |
| Package name to Maven artifactId mappings | Add package name to Maven artifactId mapping topic. | April 17, 2024 |
| Publish SDK metrics from the AWS SDK for Java 2.x | Add configuration details to the metrics section. | April 12, 2024 |
| Changes in the IAM Policy Builder API from version 1 to version 2 | Add IAM Policy Builder API migration information. | April 11, 2024 |
| Configure HTTP proxies | Update HTTP proxy information. | April 3, 2024 |
| Securely acquire IAM role credentials | Add instructions to disable IMDSv1. | March 14, 2024 |
| Migration step-by-step instructions with example | Add step-by-step migration instructions. | March 8, 2024 |
| Migrate from version 1.x to 2.x of the AWS SDK for Java | Update migration topic. | February, 14, 2024 |
| Configure AWS CRT-based HTTP clients | Add information about the synchronous AWS CRT-based HTTP client. | January 5, 2024 |
| Amazon Cognito Identity examples using SDK for Java 2.x and Amazon Cognito Identity Provider examples using SDK for Java 2.x | Amazon Cognito examples moved to Code Examples section. | December 28, 2023 |
| OpenPGP key for the AWS SDK for Java | Provide current OpenPGP key. | December 6, 2023 |
| Serialization differences between 1.x and 2.x of the AWS SDK for Java | Describe serialization differences between v1 and v2 of the SDK for Java. | December 5, 2023 |
| Migrate the Transfer Manager from version 1 to version 2 of the AWS SDK for Java | Add a section that details the changes in the S3 Transfer Manager from version 1 to version 2. | November 13, 2023 |
| Data class annotations | Add a listing of data class annotations that can be used with the DynamoDB Enhanced Client. | October 30, 2023 |
| Migration status of libraries and utilities | Add information on the migration status of libraries and utilities from SDK for Java v1.x to v2.x | October 17, 2023 |
| Set up a Gradle project that uses the AWS SDK for Java 2.x | Update the Gradle setup topic | October 17, 2023 |
| Avoid saving null attributes of nested objects | Add information about the DynamoDB Enhanced Client @DynamoDbIgnoreNulls
annotation. |
September 22, 2023 |
| Cross-Region access for Amazon S3 | Add information about cross-Region access to Amazon S3 buckets. | August 31, 2023 |
| Preserve empty objects with @DynamoDbPreserveEmptyObject | Add section that discusses the @DynamoDbPreserveEmptyObject
annotation. |
August 25, 2023 |
| Making AWS service requests using the AWS SDK for Java 2.x | Update service client section. | August 15, 2023 |
| HTTP client recommendations | Since version 0.23, AWS CRT supports musl-based OS such as Alpine Linux. HTTP client recommendations now reflect the musl support. | August 11, 2023 |
| Create IAM policies with the AWS SDK for Java 2.x | Add IAM Policy Builder API section | July 31, 2023 |
| Get Started using the DynamoDB Enhanced Client API | Correct several snippets in the Get Started section of the DynamoDB Enhanced Client topic. | July 24, 2023 |
| Configure HTTP proxies | Add HTTP proxy support information and examples for each HTTP client. | June 2, 2023 |
| Reorganize the table of contents | Promote SDK for Java 2.x code examples section and Calling AWS services from the AWS SDK for Java 2.x to top-level TOC entries. | May 24, 2023 |
| Add logging dependency | Show Gradle dependencies in logging section. | May 23, 2023 |
| Using paginated results in the AWS SDK for Java 2.x | Update pagination topic. | May 18, 2023 |
| Set up a Gradle project that uses the AWS SDK for Java 2.x | Update Gradle project setup. | May 3, 2023 |
| DynamoDB Enhanced Client API | Rewritten DynamoDB Enhanced Client API topic released. | April 28, 2023 |
| Update get started tutorial instructions | Maven archetype modified to include option for credentialsProvider; instructions modified accordingly. | April 11, 2023 |
| HTTP client recommendations | Add HTTP client decision guidance | March 30, 2023 |
|
IAM best practices updates |
Updated guide to align with the IAM best practices. For more information, see Security best practices in IAM. |
March 14, 2023 |
| Reload profile credentials | Add section on reloading profile credentials. | February 9, 2023 |
| Configure AWS CRT-based HTTP clients | Update topic for GA release. | February 8, 2023 |
| Work with Amazon EC2 instance metadata | Add guided example for Java SDK client for Amazon S3 instance metadata service. | February 1, 2023 |
| Use a performant S3 client: AWS CRT-based S3 client | Add section for the AWS CRT-based S3 Client. | December 19, 2022 |
| Transfer files and directories with the Amazon S3 Transfer Manager | Update Amazon S3 Transfer Manager examples for GA release. | December 19, 2022 |
| Best practices for using the AWS SDK for Java 2.x | Added best practices section. | November 18, 2022 |
| Load credentials from an external process using the AWS SDK for Java 2.x | Added section on loading credentials from an external process. | November 15, 2022 |
| AWS SDK for Java 2.x: Comprehensive Metrics Reference | Updated metric listing with HTTP client usage requirement. | November 9, 2022 |
| Transfer files and directories with the Amazon S3 Transfer Manager | Example code corrected. | November 2, 2022 |
| Reduce SDK startup time for AWS Lambda | Updated section with additional options to reduce Lambda startup time. | November 1, 2022 |
| Configure HTTP clients in the AWS SDK for Java 2.x | Added configuration information to cover all HTTP clients in the SDK. | October 26, 2022 |
| Logging with the SDK for Java 2.x | Updated logging topic to include wire logging details for all HTTP clients. | October 4, 2022 |
| Added overview section of AWS database services and the SDK for Java 2.x. | September 13, 2022 | |
|
EC2-Classic is retiring on August 15, 2022. |
July 28, 2022 |
|
|
Update to dependency required for single sign-on authentication. |
July 18, 2022 |
|
|
Update TLS security information. |
April 8, 2022 |
|
|
Added more information about setting up and using credentials. |
February 22, 2021 |
|
|
Set up a GraalVM Native Image project that uses the AWS SDK for Java 2.x |
New topic for setting up a GraalVM Native Image project. |
February 18, 2021 |
|
Waiters released; added topic for the new feature. |
September 30, 2020 |
|
|
Metrics released; added topic for the new feature. |
August 17, 2020 |
|
|
Added example topics for Amazon SNS. |
May 30, 2020 |
|
|
Added AWS Lambda function performance topic. |
May 29, 2020 |
|
|
Added JVM TTL DNS caching topic. |
April 27, 2020 |
|
|
Set up an Apache Maven project that uses the AWS SDK for Java 2.x, Set up a Gradle project that uses the AWS SDK for Java 2.x |
New Maven and Gradle set up topics. |
April 21, 2020 |
|
Added TLS 1.2 to security section. |
March 19, 2020 |
|
|
Added Kinesis stream examples. |
August 2, 2018 |
|
|
Added auto pagination topic. |
April 5, 2018 |
|
|
Added example topics for IAM, Amazon EC2, CloudWatch and DynamoDB. |
December 29, 2017 |
|
|
Added getobjects example for Amazon S3. |
August 7, 2017 |
|
|
Added async topic. |
August 4, 2017 |
|
|
GA release of the AWS SDK for Java 2.x |
AWS SDK for Java version 2 (v2) released. |
June 28, 2017 |