Awesome Open Source
Awesome Open Source

AWS SDK for Java Sample Project

A simple Java application illustrating usage of the AWS SDK for Java.


You have a choice of Maven or Gradle

The only requirement of this application is Maven. All other dependencies can be installed by building the maven package:

mvn package

Otherwise with gradle you can run the gradlew wrapper and all dependencies will be installed:

gradlew build

Basic Configuration

You need to set up your AWS security credentials before the sample code is able to connect to AWS. You can do this by creating a file named "credentials" at ~/.aws/ (C:\Users\\ for Windows users) and saving the following lines in the file:

aws_access_key_id = <your access key id>
aws_secret_access_key = <your secret key>

See the Security Credentials page for more information on getting your keys.

Running the S3 sample


You will need to go to IAM policies page, search for the String "S3," and "Attach" the "AmazonS3FullAccess" policy to the user whose credentials exist in your ~/.aws/credentials file. Otherwise, you will likely get a AmazonServiceException/Access Denied/403 error.

This sample application connects to Amazon's Simple Storage Service (S3), creates a bucket, and uploads a file to that bucket. The code will generate a bucket name for you, as well as an example file to upload. All you need to do is run it.


mvn clean compile exec:java


gradlew clean build run

When you start making your own buckets, the S3 documentation provides a good overview of the restrictions for bucket names.


This sample application is distributed under the Apache License, Version 2.0.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (396,711
Aws (38,656
Sdk (32,761
Gradle (13,002
S3 (6,236
Credentials (5,995