Document history - Amazon SDK for Java 2.x
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Document history

This topic describes important changes to the Amazon SDK for Java Developer Guide over the course of its history.

This guide was last published on May 1, 2024.

Change Description Date
Service client metrics 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
Use SDK metrics from the Amazon SDK for Java 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 changes 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 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 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 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 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 temporary credentials from an external process Added section on loading credentials from an external process. November 15, 2022
Service client metrics 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
HTTP clients 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

Amazon database services and Amazon SDK for Java 2.x

Added overview section of Amazon database services and the SDK for Java 2.x. September 13, 2022

EC2-Classic Networking is Retiring

EC2-Classic is retiring on August 15, 2022.

July 28, 2022

Additional authentication options

Update to dependency required for single sign-on authentication.

July 18, 2022

Working with TLS in the SDK for Java

Update TLS security information.

April 8, 2022

Additional authentication options

Added more information about setting up and using credentials.

February 22, 2021

Set up a GraalVM Native Image project for the Amazon SDK for Java

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

Use SDK metrics from the Amazon SDK for Java

Metrics released; added topic for the new feature.

August 17, 2020

Work with Amazon Simple Notification Service

Added example topics for Amazon SNS.

May 30, 2020

Reduce SDK startup time for Amazon Lambda

Added Amazon Lambda function performance topic.

May 29, 2020

Set the JVM TTL for DNS name lookups

Added JVM TTL DNS caching topic.

April 27, 2020

Set up an Apache Maven project, Set up a Gradle project

New Maven and Gradle set up topics.

April 21, 2020

Working with TLS in the SDK for Java

Added TLS 1.2 to security section.

March 19, 2020

Subscribe to Amazon Kinesis Data Streams

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 using the Amazon SDK for Java 2.x

Added example topics for IAM, Amazon EC2, CloudWatch and DynamoDB.

December 29, 2017

Work with Amazon S3

Added getobjects example for Amazon S3.

August 7, 2017

Use asynchronous programming

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