Amazon Simple Storage Service
Developer Guide (API Version 2006-03-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Buckets and Regions

You can choose the geographical Region where Amazon S3 will store the buckets you create. You might choose a Region to optimize latency, minimize costs, or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to create buckets in the EU (Ireland) Region.

[Important]Important

The SOAP API does not support geographical constraints.

Objects stored in a Region never leave that Region unless you explicitly transfer them to another Region. For example, objects stored in the EU (Ireland) Region never leave it.

Amazon S3 supports the following Regions:

  • US Standard—Uses Amazon S3 servers in the United States

    This is the default Region. The US Standard Region automatically routes requests to facilities in Northern Virginia or the Pacific Northwest using network maps. To use this region, select US Standard as the region when creating a bucket in the console. The US Standard Region provides eventual consistency for all requests.

  • US West (Oregon) Region—Uses Amazon S3 servers in Oregon

    To use this Region, choose Oregon as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the US West (Oregon) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

  • US West (Northern California) Region—Uses Amazon S3 servers in Northern California

    To use this Region, choose Northern California as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the US West (Northern California) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

  • EU (Ireland) Region—Uses Amazon S3 servers in Ireland

    To use this Region, choose Ireland as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the EU (Ireland) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

  • Asia Pacific (Singapore) Region—Uses Amazon S3 servers in Singapore

    To use this Region, choose Singapore as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the Asia Pacific (Singapore) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

  • Asia Pacific (Tokyo) Region—Uses Amazon S3 servers in Tokyo

    To use this Region, choose Tokyo as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the Asia Pacific (Tokyo) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

  • South America (Sao Paulo) Region—Uses Amazon S3 servers in Sao Paulo

    To use this Region, choose Sao Paulo as the Region when creating the bucket in the AWS Management Console. In Amazon S3, the South America (Sao Paulo) Region provides read-after-write consistency for PUTS of new objects in your Amazon S3 bucket and eventual consistency for overwrite PUTS and DELETES.

Regions are set at the bucket level. You specify a Region using the LocationConstraint bucket parameter. If you do not specify a Region, Amazon S3 hosts your buckets on servers in the US Standard Region.

[Important]Important

If you use a Region-specific endpoint to create a bucket, you must set the LocationConstraint bucket parameter to the same Region. For more information about Region-specific endpoints, see Request Endpoints.

How to Specify a Bucket's Region

Use the following process to specify a bucket's Region.

Specifying a Bucket's Region

1

In a bucket creation request, set the LocationContraint parameter to a specific Region, for example, CreateBucketConfiguration.LocationConstraint=us-west-1

2

Optionally, when creating a bucket in the Northern California Region, you can also use a Region-specific endpoint in the request to create the bucket. For example, to match the Region specified in step 1, you would use the endpoint, https://s3-us-west-1.amazonaws.com (or http://s3-us-west-1.amazonaws.com).

Using the Region-specific endpoint avoids the latency caused by the redirection of requests from US Standard to the Northern California Region. For more information, see Redirection. (The EU (Ireland) Region does not have a Region-specific endpoint.)

[Important]Important

Even if you use a Region-specific endpoint in a request to create a Northern California Region bucket, you must set the value of LocationConstraint to the same Region.


Bucket Access

To access Amazon S3 buckets and objects that were created using CreateBucketConfiguration, you can use the virtual hosted-style request in all Regions. For example:

http://yourbucket.s3.amazonaws.com/yourobject

To use the path-style request, the bucket must be in the US Classic Region, or the bucket must be in the same Region as the endpoint in the request. For example:

http://s3.amazonaws.com/yourbucket/yourobject

Redirection

Amazon supports two types of redirects: temporary and permanent.

Temporary redirects automatically redirect users that do not have DNS information for the requested bucket. This occurs because DNS changes take time to propagate through the Internet. For example, if a user creates a bucket with a location constraint and immediately stores an object in the bucket, information about the bucket might not distribute throughout the Internet. Because the bucket is a sub domain of s3.amazonaws.com, Amazon S3 redirects it to the correct Amazon S3 location.

You can remove this (short lived) redirection latency by using a Region-specific endpoint in the bucket creation request. The LocationConstraint bucket parameter specifies the Region where the bucket will reside. Using the Region-specific endpoint is optional. The only Region you can do this in is US-West. For more information, see How to Specify a Bucket's Region.

Transferring a Bucket's Contents to Another Region

Use the following process to transfer your bucket from one Region to another.

To transfer a bucket to another Region

1Create a new Amazon S3 bucket in the Region you wish to transfer your data to.
2

Use the copy operation to transfer each of your objects from the source Region to the target Region.

Bandwidth charges apply for this transfer. For more information, go to COPY Object.