public enum Region extends Enum<Region>
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 transferred to another region.
In Amazon S3, all the regions provides read-after-write consistency for PUTS of new objects in Amazon S3 buckets and eventual consistency for overwrite PUTS and DELETES.
Enum Constant and Description |
---|
AF_CapeTown
The Africa South (Cape Town) Region.
|
AP_HongKong
The Asia Pacific (Hong Kong) Region.
|
AP_Jakarta
The Asia Pacific (Jakarta) Region.
|
AP_Mumbai
The Asia Pacific (Mumbai) Region.
|
AP_Osaka
The Asia Pacific (Osaka) Region.
|
AP_Seoul
The Asia Pacific (Seoul) Region.
|
AP_Singapore
The Asia Pacific (Singapore) Region.
|
AP_Sydney
The Asia Pacific (Sydney) Region.
|
AP_Tokyo
The Asia Pacific (Tokyo) Region.
|
CA_Central
The Canada (Central) Region.
|
CN_Beijing
The China (Beijing) Region.
|
CN_Northwest_1
The China (Ningxia) Region.
|
EU_Frankfurt
The EU (Frankfurt) Amazon S3 Region.
|
EU_Ireland
The EU (Ireland) Amazon S3 Region.
|
EU_London
The EU (London) Amazon S3 Region.
|
EU_North_1
The EU (Stockholm) Amazon S3 Region.
|
EU_Paris
The EU (Paris) Amazon S3 Region.
|
EU_South_1
The EU (Milan) Amazon S3 Region.
|
ME_Bahrain
The Middle East (Bahrain) Region.
|
SA_SaoPaulo
The South America (Sao Paulo) Region.
|
US_East_2
The US-East-2 (Ohio) Region.
|
US_Gov_East_1
The US GovCloud (East) Region.
|
US_GovCloud
The US GovCloud Region.
|
US_ISO_EAST_1
The US ISO East Region.
|
US_ISO_WEST_1
The US ISO West Region.
|
US_ISOB_EAST_1
The US ISOB East (Ohio) 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.
|
Modifier and Type | Field and Description |
---|---|
static Pattern |
S3_REGIONAL_ENDPOINT_PATTERN
Used to extract the S3 regional id from an S3 end point.
|
Modifier and Type | Method and Description |
---|---|
static Region |
fromValue(String s3RegionId)
Returns the Amazon S3 Region enumeration value representing the specified Amazon
S3 Region ID string.
|
String |
getFirstRegionId()
Returns the first region id or null for
US_Standard . |
Region |
toAWSRegion()
Returns the respective Amazon Web Services region.
|
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.
|
public static final Region US_Standard
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.
public static final Region US_East_2
When using buckets in this region, set the client
endpoint to s3.us-east-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.
public static final Region US_West
When using buckets in this region, 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.
public static final Region US_West_2
When using buckets in this region, 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.
public static final Region US_GovCloud
public static final Region US_Gov_East_1
public static final Region EU_Ireland
public static final Region EU_London
public static final Region EU_Paris
public static final Region EU_Frankfurt
The EU (Frankfurt) Region requires Amazon Web Services V4 authentication, therefore when accessing buckets inside this region, you need to explicitly configure the "eu-central-1" endpoint for the AmazonS3Client in order to enable V4 signing:
AmazonS3Client s3 = new AmazonS3Client(); s3.setRegion(RegionUtils.getRegion("eu-central-1"));
public static final Region EU_North_1
The EU (Stockholm) Region requires Amazon Web Services V4 authentication, therefore when accessing buckets inside this region, you need to explicitly configure the "eu-north-1" endpoint for the AmazonS3Client in order to enable V4 signing:
AmazonS3Client s3 = new AmazonS3Client(); s3.setRegion(RegionUtils.getRegion("eu-north-1"));
public static final Region EU_South_1
The EU (Milan) Region requires Amazon Web Services V4 authentication, therefore when accessing buckets inside this region, you need to explicitly configure the "eu-south-1" endpoint for the AmazonS3Client in order to enable V4 signing:
AmazonS3Client s3 = new AmazonS3Client(); s3.setRegion(RegionUtils.getRegion("eu-south-1"));
public static final Region AP_HongKong
When using buckets in this region, set the client
endpoint to s3.ap-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.
public static final Region AP_Singapore
When using buckets in this region, 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.
public static final Region AP_Sydney
When using buckets in this region, set the client endpoint to
s3-ap-southeast-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.
public static final Region AP_Jakarta
When using buckets in this region, set the client endpoint to
s3-ap-southeast-3.amazonaws.com
on all requests to these buckets
to reduce any latency experienced after the first hour of creating a
bucket in this region.
public static final Region AP_Tokyo
When using buckets in this region, 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.
public static final Region AP_Seoul
When using buckets in this region, set the client endpoint to
s3.ap-northeast-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.
public static final Region AP_Osaka
public static final Region AP_Mumbai
When using buckets in this region, set the client endpoint to
s3.ap-south-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.
public static final Region SA_SaoPaulo
When using buckets in this region, 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.
public static final Region CA_Central
When using buckets in this region, set the client endpoint to
s3.ca-central-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.
public static final Region CN_Beijing
When using buckets in this region, you must set the client endpoint to
s3.cn-north-1.amazonaws.com.cn
.
public static final Region CN_Northwest_1
When using buckets in this region, you must set the client endpoint to
s3.cn-northwest-1.amazonaws.com.cn
.
public static final Region ME_Bahrain
When using buckets in this region, you must set the client endpoint to
s3.me-south-1.amazonaws.com
.
public static final Region AF_CapeTown
When using buckets in this region, you must set the client endpoint to
s3.af-south-1.amazonaws.com
.
public static final Region US_ISO_EAST_1
When using buckets in this region, you must set the client endpoint to
s3.us-iso-east-1.c2c.ic.gov
.
public static final Region US_ISOB_EAST_1
When using buckets in this region, you must set the client endpoint to
s3.us-isob-east-1.sc2s.sgov.gov
.
public static final Region US_ISO_WEST_1
When using buckets in this region, you must set the client endpoint to
s3.us-iso-west-1.c2c.ic.gov
.
public static final Pattern S3_REGIONAL_ENDPOINT_PATTERN
s3-eu-west-1.amazonaws.com s3.cn-north-1.amazonaws.com.cn
public static Region[] values()
for (Region c : Region.values()) System.out.println(c);
public static Region valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is nullpublic String getFirstRegionId()
US_Standard
.public static Region fromValue(String s3RegionId) throws IllegalArgumentException
IllegalArgumentException
is thrown.s3RegionId
- The Amazon S3 region ID string.IllegalArgumentException
- If the specified value does not map to one of the known
Amazon S3 regions.public Region toAWSRegion()
Copyright © 2022. All rights reserved.