com.amazonaws.services.s3.model
Enum Region

java.lang.Object
  java.lang.Enum<Region>
      com.amazonaws.services.s3.model.Region

All Implemented Interfaces:

Serializable, Comparable<Region>

public enum Region
extends Enum<Region>

Specifies constants that define Amazon S3 Regions.

Amazon S3 Regions allow the user to choose the geographical region where Amazon S3 will store the buckets the user creates. Choose a Amazon S3 Region to optimize latency, minimize costs, or address regulatory requirements.

Objects stored in a Amazon S3 Region never leave that region unless explicitly transfered to another region.

Enum Constant Summary

AP_Singapore
The Asia Pacific (Singapore) Region.

AP_Tokyo
The Asia Pacific (Tokyo) Region.

EU_Ireland
The EU (Ireland) Amazon S3 Region.

SA_SaoPaulo
The South America (Sao Paulo) Region.

US_Standard
The US Standard Amazon S3 Region.

US_West
The US-West (Northern California) Amazon S3 Region.

US_West_2
The US-West-2 (Oregon) Region.

Method Summary

static Region	fromValue(String s3RegionString) Returns the Amazon S3 Region enumeration value representing the specified Amazon S3 Region ID string.
String	toString()
static Region	valueOf(String name) Returns the enum constant of this type with the specified name.
static Region[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

US_Standard

public static final Region US_Standard

The US Standard Amazon S3 Region. This region uses Amazon S3 servers located in the United States.

This is the default Amazon S3 Region. All requests sent to s3.amazonaws.com go to this region unless a location constraint is specified when creating a bucket. The US Standard Region automatically places data in either Amazon's east or west coast data centers depending on which one provides the lowest latency. The US Standard Region provides eventual consistency for all requests.

US_West

public static final Region US_West

The US-West (Northern California) Amazon S3 Region. This region uses Amazon S3 servers located in Northern California.

When using buckets in this region, optionally set the client endpoint to s3-us-west-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

In Amazon S3, the US-West (Northern California) Region provides read-after-write consistency for PUTS of new objects in Amazon S3 buckets and eventual consistency for overwrite PUTS and DELETES.

US_West_2

public static final Region US_West_2

The US-West-2 (Oregon) Region. This region uses Amazon S3 servers located in Oregon.

When using buckets in this region, optionally set the client endpoint to s3-us-west-2.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

EU_Ireland

public static final Region EU_Ireland

The EU (Ireland) Amazon S3 Region. This region uses Amazon S3 servers located in Ireland.

In Amazon S3, the EU (Ireland) Region provides read-after-write consistency for PUTS of new objects in Amazon S3 buckets and eventual consistency for overwrite PUTS and DELETES.

AP_Singapore

public static final Region AP_Singapore

The Asia Pacific (Singapore) Region. This region uses Amazon S3 servers located in Singapore.

When using buckets in this region, optionally set the client endpoint to s3-ap-southeast-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

AP_Tokyo

public static final Region AP_Tokyo

The Asia Pacific (Tokyo) Region. This region uses Amazon S3 servers located in Tokyo.

When using buckets in this region, optionally set the client endpoint to s3-ap-northeast-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

SA_SaoPaulo

public static final Region SA_SaoPaulo

The South America (Sao Paulo) Region. This region uses Amazon S3 servers located in Sao Paulo.

When using buckets in this region, optionally set the client endpoint to s3-sa-east-1.amazonaws.com on all requests to these buckets to reduce any latency experienced after the first hour of creating a bucket in this region.

Method Detail

values

public static Region[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Region c : Region.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Region valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

toString

public String toString()

Overrides:

toString in class Enum<Region>

fromValue

public static Region fromValue(String s3RegionString)
                        throws IllegalArgumentException

Returns the Amazon S3 Region enumeration value representing the specified Amazon S3 Region ID string. If specified string doesn't map to a known Amazon S3 Region, then an IllegalArgumentException is thrown.

Parameters:

s3RegionString - The Amazon S3 region ID string.

Returns:

The Amazon S3 Region enumeration value representing the specified Amazon S3 Region ID.

Throws:

IllegalArgumentException - If the specified value does not map to one of the known Amazon S3 regions.