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

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

mvn package

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 = <your access key id>
aws_secret_access_key = <your secret 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/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

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.