Sample project to demonstrate usage of the AWS SDK for Java
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:
Otherwise with gradle you can run the gradlew wrapper and all dependencies will be installed:
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\USER_NAME.aws\ for Windows users) and saving the following lines in the file:
[default] aws_access_key_id = aws_secret_access_key =
See the Security Credentials page for more information on getting your keys.
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/credentialsfile. Otherwise, you will likely get a
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.