• Stars
    star
    1,822
  • Rank 25,486 (Top 0.6 %)
  • Language
    Java
  • License
    Apache License 2.0
  • Created over 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The official AWS SDK for Java - Version 2

AWS SDK for Java 2.0

Build Status Maven Gitter codecov

All Contributors

The AWS SDK for Java 2.0 is a rewrite of 1.0 with some great new features. As with version 1.0, it enables you to easily work with Amazon Web Services but also includes features like non-blocking IO and pluggable HTTP implementation to further customize your applications. You can get started in minutes using Maven or any build system that supports MavenCentral as an artifact source.

Getting Started

Sign up for AWS

Before you begin, you need an AWS account. Please see the Sign Up for AWS section of the developer guide for information about how to create an AWS account and retrieve your AWS credentials.

Minimum requirements

To run the SDK 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.

Using the SDK

The recommended way to use the AWS SDK for Java in your project is to consume it from Maven Central.

Importing the BOM

To automatically manage module versions (currently all modules have the same version, but this may not always be the case) we recommend you use the Bill of Materials import as follows:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>software.amazon.awssdk</groupId>
      <artifactId>bom</artifactId>
      <version>2.25.39</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Then individual modules may omit the version from their dependency statement:

<dependencies>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>ec2</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
  </dependency>
  <dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>dynamodb</artifactId>
  </dependency>
</dependencies>

Individual Services

Alternatively you can add dependencies for the specific services you use only:

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>ec2</artifactId>
  <version>2.25.39</version>
</dependency>
<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>s3</artifactId>
  <version>2.25.39</version>
</dependency>

Whole SDK

You can import the whole SDK into your project (includes ALL services). Please note that it is recommended to only import the modules you need.

<dependency>
  <groupId>software.amazon.awssdk</groupId>
  <artifactId>aws-sdk-java</artifactId>
  <version>2.25.39</version>
</dependency>

See the Set up the AWS SDK for Java section of the developer guide for more usage information.

New Features for 2.0

  • Provides a way to plug in your own HTTP implementation.

  • Provides first class support for non-blocking IO in Async clients.

Building From Source

Once you check out the code from GitHub, you can build it using the following commands.

Linux:

./mvnw clean install

# Skip tests, checkstyles, findbugs, etc for quick build
./mvnw clean install -P quick

# Build a specific service module
./mvnw clean install -pl :s3 -P quick --am

Windows:

./mvnw.cmd clean install

Sample Code

You can find sample code for v2 in the following places:

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:

Maintenance and Support for Java Versions

We maintain full support on Long-Term Support(LTS) releases: Java 8, Java 11, Java 17, and Java 21.

Giving Feedback

We need your help in making this SDK great. Please participate in the community and contribute to this effort by submitting issues, participating in discussion forums and submitting pull requests through the following channels:

  • Submit issues - this is the preferred channel to interact with our team
  • Articulate your feature request or upvote existing ones on our Issues page

Contributors โœจ

Thanks goes to these wonderful people (emoji key):

sullis
sullis

๐Ÿ’ป
Austin Brooks
Austin Brooks

๐Ÿ’ป
Konrad `ktoso` Malawski
Konrad `ktoso` Malawski

๐Ÿ’ป
Andrew Hopkins
Andrew Hopkins

๐Ÿ’ป
Adam Thomas
Adam Thomas

๐Ÿ’ป
Steven Swor
Steven Swor

๐Ÿ’ป
Carey Burgess
Carey Burgess

๐Ÿ’ป
Anuraag Agrawal
Anuraag Agrawal

๐Ÿ’ป
jeffalder
jeffalder

๐Ÿ’ป
Boris
Boris

๐Ÿ’ป
Guillaume Corrรฉ
Guillaume Corrรฉ

๐Ÿ’ป
Henri Yandell
Henri Yandell

๐Ÿ’ป
Ryan Schmitt
Ryan Schmitt

๐Ÿ’ป
Somaya
Somaya

๐Ÿ’ป
Steven Aerts
Steven Aerts

๐Ÿ’ป
Steven Wong
Steven Wong

๐Ÿ’ป
Tomasz Elendt
Tomasz Elendt

๐Ÿ’ป
Will Erickson
Will Erickson

๐Ÿ’ป
Julien Hoarau
Julien Hoarau

๐Ÿ’ป
SEOKHYOENCHOI
SEOKHYOENCHOI

๐Ÿ’ป
adriannistor
adriannistor

๐Ÿ’ป
Xian Sun
Xian Sun

๐Ÿ’ป
Andreas Scheja
Andreas Scheja

๐Ÿ’ป
Anton Egorov
Anton Egorov

๐Ÿ’ป
roexber
roexber

๐Ÿ’ป
brharrington
brharrington

๐Ÿ’ป
Christopher Radek
Christopher Radek

๐Ÿ’ป
Foivos
Foivos

๐Ÿ’ป
Frank Wesemann
Frank Wesemann

๐Ÿ’ป
Gergely Varga
Gergely Varga

๐Ÿ’ป
Guillermo
Guillermo

๐Ÿ’ป
Henry Heikkinen
Henry Heikkinen

๐Ÿ’ป
Jochen Schalanda
Jochen Schalanda

๐Ÿ’ป
Joe Barnett
Joe Barnett

๐Ÿ’ป
Kazuhiro Sera
Kazuhiro Sera

๐Ÿ’ป
Krishna Chaithanya Ganta
Krishna Chaithanya Ganta

๐Ÿ’ป
Lee Packham
Lee Packham

๐Ÿ’ป
Matteo Carrara
Matteo Carrara

๐Ÿ’ป
Michael Scharp
Michael Scharp

๐Ÿ’ป
Miguel Jimenez
Miguel Jimenez

๐Ÿ’ป
Russell Bolles
Russell Bolles

๐Ÿ’ป
Russell Scheerer
Russell Scheerer

๐Ÿ’ป
Scott
Scott

๐Ÿ’ป
Shin'ya Ueoka
Shin'ya Ueoka

๐Ÿ’ป
sushilamazon
sushilamazon

๐Ÿ’ป
tomliu4uber
tomliu4uber

๐Ÿ’ป
Vladimir Orany
Vladimir Orany

๐Ÿ’ป
Xinyu Hu
Xinyu Hu

๐Ÿ’ป
Yosef Fertel
Yosef Fertel

๐Ÿ’ป
Denys Konakhevych
Denys Konakhevych

๐Ÿ’ป
Alex Weibel
Alex Weibel

๐Ÿ’ป
Ryan Carper
Ryan Carper

๐Ÿ’ป
Jonathan M. Henson
Jonathan M. Henson

๐Ÿ’ป
Debora N. Ito
Debora N. Ito

๐Ÿ’ป
Bret Ambrose
Bret Ambrose

๐Ÿ’ป
Anna-Karin Salander
Anna-Karin Salander

๐Ÿ’ป
John Viegas
John Viegas

๐Ÿ’ป
Dongie Agnir
Dongie Agnir

๐Ÿ’ป
Matthew Miller
Matthew Miller

๐Ÿ’ป
Benjamin Maizels
Benjamin Maizels

๐Ÿ’ป
Quan Zhou
Quan Zhou

๐Ÿ’ป
Zoe Wang
Zoe Wang

๐Ÿ’ป
Varun Nandi
Varun Nandi

๐Ÿ’ป
Andrew Shore
Andrew Shore

๐Ÿ’ป
Kyle Thomson
Kyle Thomson

๐Ÿ’ป
Sam Fink
Sam Fink

๐Ÿ’ป
Jonathan Bond
Jonathan Bond

๐Ÿ’ป
ajs139
ajs139

๐Ÿ’ป
Dewey Nguyen
Dewey Nguyen

๐Ÿ’ป
David Leen
David Leen

๐Ÿ’ป
Michael Li
Michael Li

๐Ÿ’ป
Bennett Lynch
Bennett Lynch

๐Ÿ’ป
Ikko Ashimine
Ikko Ashimine

๐Ÿ“–
Jamie Liu
Jamie Liu

๐Ÿ“–
guillepb10
guillepb10

๐Ÿ’ป
Lorenz Nickel
Lorenz Nickel

๐Ÿ“–
Erin Yang
Erin Yang

๐Ÿ’ป
Roberto Tyley
Roberto Tyley

๐Ÿ’ป
Alvin See
Alvin See

๐Ÿ’ป
ron1
ron1

๐Ÿ’ป
Sai Kumar Reddy Chandupatla
Sai Kumar Reddy Chandupatla

๐Ÿ’ป
David Ho
David Ho

๐Ÿ’ป
Thomas Turrell-Croft
Thomas Turrell-Croft

๐Ÿ’ป
Steven Shan
Steven Shan

๐Ÿ’ป
Barry O'Neill
Barry O'Neill

๐Ÿ’ป
Andy Kiesler
Andy Kiesler

๐Ÿ’ป
Martin
Martin

๐Ÿ’ป
Paulo Lieuthier
Paulo Lieuthier

๐Ÿ’ป
Sรฉbastien Crocquesel
Sรฉbastien Crocquesel

๐Ÿ’ป
David Negrete
David Negrete

๐Ÿ’ป
Stephen Flavin
Stephen Flavin

๐Ÿ’ป
Olivier L Applin
Olivier L Applin

๐Ÿ’ป
Adrian Chlebosz
Adrian Chlebosz

๐Ÿ’ป
Chad Wilson
Chad Wilson

๐Ÿ’ป
Manish Dait
Manish Dait

๐Ÿ“–
Dennis Kieselhorst
Dennis Kieselhorst

๐Ÿ’ป
Nilesh PS
Nilesh PS

๐Ÿ’ป
Steven Swartz
Steven Swartz

๐Ÿ’ป
Michael Dimchuk
Michael Dimchuk

๐Ÿ’ป
Nikita Sokolov
Nikita Sokolov

๐Ÿ’ป
Manuel Sugawara
Manuel Sugawara

๐Ÿ’ป
Anirudh
Anirudh

๐Ÿ’ป
Hayden Baker
Hayden Baker

๐Ÿ’ป
Jaykumar Gosar
Jaykumar Gosar

๐Ÿ’ป
Michael Graeb
Michael Graeb

๐Ÿ’ป
Michael Grundie
Michael Grundie

๐Ÿ’ป
Eckard Mรผhlich
Eckard Mรผhlich

๐Ÿ’ป

This project follows the all-contributors specification. Contributions of any kind welcome!

More Repositories

1

aws-cli

Universal Command Line Interface for Amazon Web Services
Python
14,304
star
2

chalice

Python Serverless Microframework for AWS
Python
10,654
star
3

aws-cdk

The AWS Cloud Development Kit is a framework for defining cloud infrastructure in code
JavaScript
10,440
star
4

amazon-sagemaker-examples

Example ๐Ÿ““ Jupyter notebooks that demonstrate how to build, train, and deploy machine learning models using ๐Ÿง  Amazon SageMaker.
Jupyter Notebook
9,542
star
5

serverless-application-model

The AWS Serverless Application Model (AWS SAM) transform is a AWS CloudFormation macro that transforms SAM templates into CloudFormation templates.
Python
9,342
star
6

aws-sdk-js

AWS SDK for JavaScript in the browser and Node.js
JavaScript
7,476
star
7

aws-sam-cli

CLI tool to build, test, debug, and deploy Serverless applications using AWS SAM
Python
6,506
star
8

aws-sdk-php

Official repository of the AWS SDK for PHP (@awsforphp)
PHP
5,886
star
9

containers-roadmap

This is the public roadmap for AWS container services (ECS, ECR, Fargate, and EKS).
Shell
5,164
star
10

karpenter

Karpenter is a Kubernetes Node Autoscaler built for flexibility, performance, and simplicity.
Go
4,615
star
11

s2n-tls

An implementation of the TLS/SSL protocols
C
4,465
star
12

aws-sdk-java

The official AWS SDK for Java 1.x. The AWS SDK for Java 2.x is available here: https://github.com/aws/aws-sdk-java-v2/
Java
4,117
star
13

aws-lambda-go

Libraries, samples and tools to help Go developers develop AWS Lambda functions.
Go
3,624
star
14

aws-sdk-pandas

pandas on AWS - Easy integration with Athena, Glue, Redshift, Timestream, Neptune, OpenSearch, QuickSight, Chime, CloudWatchLogs, DynamoDB, EMR, SecretManager, PostgreSQL, MySQL, SQLServer and S3 (Parquet, CSV, JSON and EXCEL).
Python
3,537
star
15

copilot-cli

The AWS Copilot CLI is a tool for developers to build, release and operate production ready containerized applications on AWS App Runner or Amazon ECS on AWS Fargate.
Go
3,488
star
16

aws-sdk-ruby

The official AWS SDK for Ruby.
Ruby
3,462
star
17

amazon-freertos

DEPRECATED - See README.md
C
2,535
star
18

aws-sdk-go-v2

AWS SDK for the Go programming language.
Go
2,518
star
19

aws-sdk-js-v3

Modularized AWS SDK for JavaScript.
TypeScript
2,476
star
20

jsii

jsii allows code in any language to naturally interact with JavaScript classes. It is the technology that enables the AWS Cloud Development Kit to deliver polyglot libraries from a single codebase!
TypeScript
2,371
star
21

sagemaker-python-sdk

A library for training and deploying machine learning models on Amazon SageMaker
Python
2,095
star
22

amazon-vpc-cni-k8s

Networking plugin repository for pod networking in Kubernetes using Elastic Network Interfaces on AWS
Go
2,071
star
23

aws-eks-best-practices

A best practices guide for day 2 operations, including operational excellence, security, reliability, performance efficiency, and cost optimization.
Python
2,022
star
24

amazon-ecs-agent

Amazon Elastic Container Service Agent
Go
2,005
star
25

lumberyard

Amazon Lumberyard is a free AAA game engine deeply integrated with AWS and Twitch โ€“ with full source.
C++
1,965
star
26

aws-sdk-net

The official AWS SDK for .NET. For more information on the AWS SDK for .NET, see our web site:
1,945
star
27

eks-anywhere

Run Amazon EKS on your own infrastructure ๐Ÿš€
Go
1,899
star
28

aws-sdk-cpp

AWS SDK for C++
1,779
star
29

amazon-ecs-cli

The Amazon ECS CLI enables users to run their applications on ECS/Fargate using the Docker Compose file format, quickly provision resources, push/pull images in ECR, and monitor running applications on ECS/Fargate.
Go
1,725
star
30

aws-sdk-php-laravel

A Laravel 5+ (and 4) service provider for the AWS SDK for PHP
PHP
1,589
star
31

serverless-java-container

A Java wrapper to run Spring, Spring Boot, Jersey, and other apps inside AWS Lambda.
Java
1,483
star
32

aws-node-termination-handler

Gracefully handle EC2 instance shutdown within Kubernetes
Go
1,443
star
33

aws-lambda-dotnet

Libraries, samples and tools to help .NET Core developers develop AWS Lambda functions.
C#
1,430
star
34

aws-fpga

Official repository of the AWS EC2 FPGA Hardware and Software Development Kit
VHDL
1,380
star
35

eks-distro

Amazon EKS Distro (EKS-D) is a Kubernetes distribution based on and used by Amazon Elastic Kubernetes Service (EKS) to create reliable and secure Kubernetes clusters.
Shell
1,263
star
36

eks-charts

Amazon EKS Helm chart repository
Mustache
1,184
star
37

s2n-quic

An implementation of the IETF QUIC protocol
Rust
1,152
star
38

aws-toolkit-vscode

CodeWhisperer, CodeCatalyst, Local Lambda debug, SAM/CFN syntax, ECS Terminal, AWS resources
TypeScript
1,150
star
39

opsworks-cookbooks

Chef Cookbooks for the AWS OpsWorks Service
Ruby
1,058
star
40

aws-codebuild-docker-images

Official AWS CodeBuild repository for managed Docker images http://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref.html
Dockerfile
1,032
star
41

amazon-ssm-agent

An agent to enable remote management of your EC2 instances, on-premises servers, or virtual machines (VMs).
Go
975
star
42

aws-iot-device-sdk-js

SDK for connecting to AWS IoT from a device using JavaScript/Node.js
JavaScript
957
star
43

aws-iot-device-sdk-embedded-C

SDK for connecting to AWS IoT from a device using embedded C.
C
926
star
44

aws-health-tools

The samples provided in AWS Health Tools can help users to build automation and customized alerting in response to AWS Health events.
Python
887
star
45

aws-graviton-getting-started

Helping developers to use AWS Graviton2, Graviton3, and Graviton4 processors which power the 6th, 7th, and 8th generation of Amazon EC2 instances (C6g[d], M6g[d], R6g[d], T4g, X2gd, C6gn, I4g, Im4gn, Is4gen, G5g, C7g[d][n], M7g[d], R7g[d], R8g).
Python
850
star
46

aws-app-mesh-examples

AWS App Mesh is a service mesh that you can use with your microservices to manage service to service communication.
Shell
844
star
47

deep-learning-containers

AWS Deep Learning Containers (DLCs) are a set of Docker images for training and serving models in TensorFlow, TensorFlow 2, PyTorch, and MXNet.
Python
800
star
48

aws-parallelcluster

AWS ParallelCluster is an AWS supported Open Source cluster management tool to deploy and manage HPC clusters in the AWS cloud.
Python
782
star
49

aws-lambda-runtime-interface-emulator

Go
771
star
50

aws-toolkit-jetbrains

AWS Toolkit for JetBrains - a plugin for interacting with AWS from JetBrains IDEs
Kotlin
735
star
51

graph-notebook

Library extending Jupyter notebooks to integrate with Apache TinkerPop, openCypher, and RDF SPARQL.
Jupyter Notebook
706
star
52

aws-iot-device-sdk-python

SDK for connecting to AWS IoT from a device using Python.
Python
670
star
53

amazon-chime-sdk-js

A JavaScript client library for integrating multi-party communications powered by the Amazon Chime service.
TypeScript
655
star
54

amazon-ec2-instance-selector

A CLI tool and go library which recommends instance types based on resource criteria like vcpus and memory
Go
642
star
55

studio-lab-examples

Example notebooks for working with SageMaker Studio Lab. Sign up for an account at the link below!
Jupyter Notebook
625
star
56

aws-secretsmanager-agent

The AWS Secrets Manager Agent is a local HTTP service that you can install and use in your compute environments to read secrets from Secrets Manager and cache them in memory.
Rust
584
star
57

event-ruler

Event Ruler is a Java library that allows matching many thousands of Events per second to any number of expressive and sophisticated rules.
Java
564
star
58

aws-sdk-rails

Official repository for the aws-sdk-rails gem, which integrates the AWS SDK for Ruby with Ruby on Rails.
Ruby
554
star
59

aws-mwaa-local-runner

This repository provides a command line interface (CLI) utility that replicates an Amazon Managed Workflows for Apache Airflow (MWAA) environment locally.
Shell
553
star
60

amazon-eks-pod-identity-webhook

Amazon EKS Pod Identity Webhook
Go
534
star
61

aws-lambda-java-libs

Official mirror for interface definitions and helper classes for Java code running on the AWS Lambda platform.
C++
518
star
62

aws-lambda-base-images

506
star
63

aws-appsync-community

The AWS AppSync community
HTML
495
star
64

sagemaker-training-toolkit

Train machine learning models within a ๐Ÿณ Docker container using ๐Ÿง  Amazon SageMaker.
Python
493
star
65

dotnet

GitHub home for .NET development on AWS
487
star
66

aws-cdk-rfcs

RFCs for the AWS CDK
JavaScript
476
star
67

aws-sam-cli-app-templates

Python
472
star
68

aws-elastic-beanstalk-cli-setup

Simplified EB CLI installation mechanism.
Python
453
star
69

amazon-cloudwatch-agent

CloudWatch Agent enables you to collect and export host-level metrics and logs on instances running Linux or Windows server.
Go
403
star
70

secrets-store-csi-driver-provider-aws

The AWS provider for the Secrets Store CSI Driver allows you to fetch secrets from AWS Secrets Manager and AWS Systems Manager Parameter Store, and mount them into Kubernetes pods.
Go
393
star
71

amazon-braket-examples

Example notebooks that show how to apply quantum computing in Amazon Braket.
Python
376
star
72

aws-for-fluent-bit

The source of the amazon/aws-for-fluent-bit container image
Shell
375
star
73

aws-pdk

The AWS PDK provides building blocks for common patterns together with development tools to manage and build your projects.
TypeScript
361
star
74

aws-extensions-for-dotnet-cli

Extensions to the dotnet CLI to simplify the process of building and publishing .NET Core applications to AWS services
C#
346
star
75

aws-sdk-php-symfony

PHP
346
star
76

aws-app-mesh-roadmap

AWS App Mesh is a service mesh that you can use with your microservices to manage service to service communication
344
star
77

aws-lambda-builders

Python library to compile, build & package AWS Lambda functions for several runtimes & framework
Python
337
star
78

aws-iot-device-sdk-python-v2

Next generation AWS IoT Client SDK for Python using the AWS Common Runtime
Python
335
star
79

constructs

Define composable configuration models through code
TypeScript
332
star
80

pg_tle

Framework for building trusted language extensions for PostgreSQL
C
329
star
81

graph-explorer

React-based web application that enables users to visualize both property graph and RDF data and explore connections between data without having to write graph queries.
TypeScript
321
star
82

aws-codedeploy-agent

Host Agent for AWS CodeDeploy
Ruby
316
star
83

aws-sdk-ruby-record

Official repository for the aws-record gem, an abstraction for Amazon DynamoDB.
Ruby
313
star
84

aws-ops-wheel

The AWS Ops Wheel is a randomizer that biases for options that havenโ€™t come up recently; you can also outright cheat and specify the next result to be generated.
JavaScript
308
star
85

aws-xray-sdk-python

AWS X-Ray SDK for the Python programming language
Python
304
star
86

sagemaker-inference-toolkit

Serve machine learning models within a ๐Ÿณ Docker container using ๐Ÿง  Amazon SageMaker.
Python
303
star
87

efs-utils

Utilities for Amazon Elastic File System (EFS)
Python
286
star
88

amazon-ivs-react-native-player

A React Native wrapper for the Amazon IVS iOS and Android player SDKs.
TypeScript
286
star
89

sagemaker-spark

A Spark library for Amazon SageMaker.
Scala
282
star
90

apprunner-roadmap

This is the public roadmap for AWS App Runner.
280
star
91

aws-xray-sdk-go

AWS X-Ray SDK for the Go programming language.
Go
274
star
92

aws-toolkit-eclipse

(End of life: May 31, 2023) AWS Toolkit for Eclipse
Java
273
star
93

elastic-beanstalk-roadmap

AWS Elastic Beanstalk roadmap
272
star
94

aws-logging-dotnet

.NET Libraries for integrating Amazon CloudWatch Logs with popular .NET logging libraries
C#
271
star
95

sagemaker-tensorflow-training-toolkit

Toolkit for running TensorFlow training scripts on SageMaker. Dockerfiles used for building SageMaker TensorFlow Containers are at https://github.com/aws/deep-learning-containers.
Python
270
star
96

aws-lc-rs

aws-lc-rs is a cryptographic library using AWS-LC for its cryptographic operations. The library strives to be API-compatible with the popular Rust library named ring.
Rust
263
star
97

elastic-load-balancing-tools

AWS Elastic Load Balancing Tools
Java
262
star
98

aws-step-functions-data-science-sdk-python

Step Functions Data Science SDK for building machine learning (ML) workflows and pipelines on AWS
Python
261
star
99

amazon-braket-sdk-python

A Python SDK for interacting with quantum devices on Amazon Braket
Python
254
star
100

aws-xray-sdk-node

The official AWS X-Ray SDK for Node.js.
JavaScript
248
star