Repository files navigation

TheAWS SDK for Java enables Java developers to easily work withAmazon Web Services andbuild scalable solutions with Amazon S3, Amazon DynamoDB, Amazon Glacier, and more.

See theAWS SDK for Java 2.x for how to get started.

The AWS SDK for Java 1.x is in maintenance mode. The AWS SDK for Java 1.x entered maintenancemode on July 31, 2024 and will reaching end-of-support on December 31, 2025. During maintenance mode, AWS will limitSDK releases to address critical bug fixes and security issues only. The SDK will not receive API updates for new orexisting services, or be updated to support new regions.

We recommend that youmigrate to the AWS SDK for Java 2.x. The AWS SDK for Java 2.x providesimproved features, enhanced performance, and continued support from AWS. By adopting the latest version of the SDK,developers can ensure the security, compatibility, and stability of their solutions on AWS. Updating also allows you toleverage the latest services and innovations from AWS.

The AWS SDK for Java 1.x will reach end-of-support on December 31, 2025. After end-of-support, AWS will no longer receive updates or releases. Previously published releases will continue to be availablevia public package managers and the code will remain on GitHub.

Changes to the SDK beginning with version 1.12.1 (June 2021) are tracked inCHANGELOG.md.

Changes in theretired 1.11.x series of the SDK, beginning with version 1.11.82,are listed in theCHANGELOG-1.11.x.md file.

Usethe AWS SDK for Java 2.x to get started.

The AWS SDK for Java 1.x is inmaintenance mode, so we recommend that you use theAWS SDK for Java 2.x.

To run the AWS SDK for Java 1.x, you will needJava 1.8+. For more information about the requirements and optimumsettings for the SDK, please see theInstalling a Java Development Environmentsection of the developer guide.

You can use the AWS SDK for Java 1.x in your project by consuming it from Maven. Importtheaws-java-sdk-bom and specify the SDK Maven modules that your project needs in thedependencies.

<dependencyManagement>  <dependencies>    <dependency>      <groupId>com.amazonaws</groupId>      <artifactId>aws-java-sdk-bom</artifactId>      <version>1.12.793</version>      <type>pom</type>      <scope>import</scope>    </dependency>  </dependencies></dependencyManagement>

<dependencies>  <dependency>    <groupId>com.amazonaws</groupId>    <artifactId>aws-java-sdk-ec2</artifactId>  </dependency>  <dependency>    <groupId>com.amazonaws</groupId>    <artifactId>aws-java-sdk-s3</artifactId>  </dependency>  <dependency>    <groupId>com.amazonaws</groupId>    <artifactId>aws-java-sdk-dynamodb</artifactId>  </dependency></dependencies>

See theSet up the AWS SDK for Java 1.x section of the developer guide for moreinformation about installing the 1.x SDK through other means.

Once you check out the code from GitHub, you can build it using Maven. To disable the GPG-signingin the build, use:

mvn clean install -Dgpg.skip=true

GitHubissues is the preferred channel to interact with our team. Also check these community resources for getting help:

• Ask a question onStackOverflow and tag it withaws-java-sdk
• Articulate your feature request or upvote existing ones on ourIssues page
• Take a look at theblog for plenty of helpful walkthroughs and tips
• Open a case via theAWS Support Center in theAWS console
• If it turns out that you may have found a bug, please open anissue

For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the AWS SDKs and Tools Reference Guide:

• AWS SDKs and Tools Maintenance Policy
• AWS SDKs and Tools Version Support Matrix

• 1.12.x - Inmaintenance mode. We recommend migrating to theAWS SDK for Java 2.x.

• 1.11.x - No longer supported, but migration to 1.12.x should require no code changes.

A version 2.x of the SDK is generally available. It is a major rewrite of the 1.x code base, built on top of Java 8+ and adds several frequently requested features. These include support for non-blocking I/O, improved start-up performance, automatic iteration over paginated responses and the ability to plug in a different HTTP implementation at run time.

For more information see theAWS SDK for Java 2.x Developer Guide or check the project repository inhttps://github.com/aws/aws-sdk-java-v2.

The AWS SDK for Java 1.x supports Java versions from 8 to 17, but may not be updated to support future Java versions. To ensure long-term compatibility with the latest JDK versions, we recommend that you migrate to theAWS SDK for Java 2.x.