Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.

This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Amazon S3 Documentation Java Examples

These are the Java examples used in the Amazon S3 developer documentation.

Prerequisites

To build and run these examples, you'll need:

• AWS SDK for Java (downloaded and extracted somewhere on your machine)

• AWS credentials, either configured in a local AWS credentials file or by setting the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.

For information about how to set AWS credentials for use with the AWS SDK for Java, see Set up AWS Credentials and Region for Development in the AWS Java Developer Guide.

Running the Examples

To run the Java examples, you will need to create a Java project in your preferred Java development environment. For more information, see Getting Started. You can also use the AWS Toolkit for Eclipse.

IMPORTANT

The examples perform AWS operations for the account and region for which you've specified credentials, and you may incur AWS service charges by running them. Please visit the AWS Pricing page for details about the charges you can expect for a given service and operation.

Some of these examples perform destructive operations on AWS resources, such as deleting an Amazon S3 bucket. Be very careful when running an operation that may delete or modify AWS resources in your account. It's best to create separate test-only resources when experimenting with these examples.

All of the examples require replacing certain configuration values in the source code. These values are specified as String variables at the beginning of each example, and begin and end with three stars (for example, "*** Client region ***"). The source-code comments and developer guide provide further information.