Document history
This topic describes important changes to the Amazon SDK for Java Developer Guide over the course of its history.
| Change | Description | Date |
|---|---|---|
| Metrics | Added comprehensive documentation for LoggingMetricPublisher. Restructured the metrics topic with improved getting-started guidance. | June 20, 2025 |
| High-level changes | Added 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 | Configuring service clients in the Amazon SDK for Java 2.x chapter was added and topics were moved to it from other parts of the guide. | June 16, 2025 |
| Use the LegacyMd5Plugin for simplified MD5 compatibility | Added 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 Amazon SDK for Java | Add S3 client differences between v1 and v2 of the Amazon 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 Amazon Lambda functions using the Amazon SDK for Java 2.x | Add information about using the EMF logging metric publisher with Amazon 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 Amazon SDK for Java | Add migration content for working with Amazon S3. | January 8, 2025 |
| Access the Amazon CRT-based HTTP clients | Add information about how to used a platform-specific jar with Amazon 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 Amazon 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 Amazon 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 |
| Use Amazon account-based endpoints | Add information about Amazon 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 |
| AutoGeneratedUuidExtension | Add information about the DynamoDB Enhanced Client
AutoGeneratedUuidExtension |
August 14, 2024 |
| Migration tool (preview release) | 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 the DynamoDB mapping/document APIs from version 1 to version 2 | 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 Amazon 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 Amazon Lambda | Update HTTP client recommendation to reduce startup time for Amazon Lambda | May 14, 2024 |
| Amazon 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 Amazon 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 Amazon SDK for Java | Update migration topic. | February, 14, 2024 |
| Configure Amazon CRT-based HTTP clients | Add information about the synchronous Amazon 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 |
| Use features of the Amazon SDK for Java 2.x | Reworked the SDK features topic. | December 11, 2023 |
| OpenPGP key for the Amazon SDK for Java | Provide current OpenPGP key. | December 6, 2023 |
| Serialization differences between 1.x and 2.x of the Amazon SDK for Java | Describe serialization differences between v1 and v2 of the SDK for Java. | December 5, 2023 |
| Changes in Amazon S3 Transfer Manager from version 1 to version 2 | 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 Amazon 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 |
| Work with service clients in the Amazon SDK for Java 2.x | Update service client section. | August 15, 2023 |
| HTTP client recommendations | Since version 0.23, Amazon 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 Amazon 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 Work with Amazon Web Services services using the Amazon 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 |
| Work with paginated results using the Amazon SDK for Java 2.x | Update pagination topic. | May 18, 2023 |
| Set up a Gradle project that uses the Amazon 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 Amazon 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: Amazon CRT-based S3 client | Add section for the Amazon 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 Amazon SDK for Java 2.x | Added best practices section. | November 18, 2022 |
| Load credentials from an external process using the Amazon SDK for Java 2.x | Added section on loading credentials from an external process. | November 15, 2022 |
| Amazon 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 Amazon Lambda | Updated section with additional options to reduce Lambda startup time. | November 1, 2022 |
| Configure HTTP clients in the Amazon 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 Amazon 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 Amazon SDK for Java 2.x |
New topic for setting up a GraalVM Native Image project. |
February 18, 2021 |
|
Poll for resource states in the Amazon SDK for Java 2.x: Waiters |
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 Amazon 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 Amazon SDK for Java 2.x, Set up a Gradle project that uses the Amazon 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 |
|
|
Work with paginated results using the Amazon SDK for Java 2.x |
Added auto pagination topic. |
April 5, 2018 |
|
Work with Amazon Web Services services using the Amazon SDK for Java 2.x |
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 Amazon SDK for Java 2.x |
Amazon SDK for Java version 2 (v2) released. |
June 28, 2017 |