AWS SDK for Java

The AWS SDK for Java enables Java developers to easily work with Amazon Web Services and build scalable solutions with Amazon S3, Amazon DynamoDB, Amazon Glacier, and more.

See the AWS SDK for Java 2.x for how to get started.

In Maintenance Mode as of July 31, 2024

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

We recommend that you migrate to the AWS SDK for Java 2.x. The AWS SDK for Java 2.x provides improved 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 to leverage the latest services and innovations from AWS.

End-of-Support on December 31, 2025

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 available via public package managers and the code will remain on GitHub.

Release Notes

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

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

Getting Started with AWS

Use the AWS SDK for Java 2.x to get started.

Using the AWS SDK for Java 1.x

The AWS SDK for Java 1.x is in maintenance mode, so we recommend that you use the AWS SDK for Java 2.x.

Minimum requirements

To run the AWS SDK for Java 1.x, you will need Java 1.8+. For more information about the requirements and optimum settings for the SDK, please see the Installing a Java Development Environment section of the developer guide.

Install the 1.x SDK

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

Importing the 1.x BOM

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

Using the 1.x SDK Maven modules

<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 the Set up the AWS SDK for Java 1.x section of the developer guide for more information about installing the 1.x SDK through other means.

Building From Source

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

mvn clean install -Dgpg.skip=true

Getting Help

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

Ask a question on StackOverflow and tag it with aws-java-sdk
Articulate your feature request or upvote existing ones on our Issues page
Take a look at the blog for plenty of helpful walkthroughs and tips
Open a case via the AWS Support Center in the AWS console
If it turns out that you may have found a bug, please open an issue

Maintenance and Support for SDK Major Versions

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:

Supported Minor Versions

1.12.x - In maintenance mode. We recommend migrating to the AWS SDK for Java 2.x.
1.11.x - No longer supported, but migration to 1.12.x should require no code changes.

AWS SDK for Java 2.x

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 the AWS SDK for Java 2.x Developer Guide or check the project repository in https://github.com/aws/aws-sdk-java-v2.

Maintenance and Support for Java Versions

The AWS SDK for Java 1.x supports Java versions from 7 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 the AWS SDK for Java 2.x.

aws / aws-sdk-java

readme