Need help with aws-java-sample?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

211 Stars 328 Forks Apache License 2.0 28 Commits 14 Opened issues


Sample project to demonstrate usage of the AWS SDK for Java

Services available


Need anything else?

Contributors list

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 = 
aws_secret_access_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

file. Otherwise, you will likely get a
Access Denied

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.