public class Region extends AbstractEnum
An instance of this class can be retrieved by referencing one of the static constants defined in this class
(eg. US_EAST_1
) or by using the of(String)
method if the region you want is not
included in this release of the SDK.
Each AWS region corresponds to a separate geographical location where a set of Amazon services is deployed. These regions
(except for the special AWS_GLOBAL
and AWS_CN_GLOBAL
regions) are separate from each other, with their own
set of resources. This means a resource created in one region (eg. an SQS queue) is not available in another region.
To programmatically determine whether a particular service is deployed to a region, you can use the serviceMetadata
method on the service's client interface. Additional metadata about a region can be discovered using
RegionMetadata.of(Region)
.
The AbstractEnum.value()
will be used as the signing region for all requests to AWS services unless an explicit region
override is available in RegionMetadata
. This value will also be used to construct the endpoint for accessing a
service unless an explicit endpoint is available for that region in RegionMetadata
.
Modifier and Type | Class and Description |
---|---|
static class |
Region.GovCloud
AWS Gov Cloud Partition Regions.
|
Modifier and Type | Field and Description |
---|---|
static Region |
AP_NORTHEAST_1 |
static Region |
AP_NORTHEAST_2 |
static Region |
AP_SOUTH_1 |
static Region |
AP_SOUTHEAST_1 |
static Region |
AP_SOUTHEAST_2 |
static Region |
AWS_CN_GLOBAL |
static Region |
AWS_GLOBAL |
static Region |
CA_CENTRAL_1 |
static Region |
CN_NORTH_1 |
static Region |
CN_NORTHWEST_1 |
static Region |
EU_CENTRAL_1 |
static Region |
EU_WEST_1 |
static Region |
EU_WEST_2 |
static List<Region> |
REGIONS |
static Region |
SA_EAST_1 |
static Region |
US_EAST_1 |
static Region |
US_EAST_2 |
static Region |
US_WEST_1 |
static Region |
US_WEST_2 |
Modifier and Type | Method and Description |
---|---|
static List<Region> |
getRegions()
Retrieve an unmodifiable list of the public regions in this release of the AWS SDK.
|
static Region |
of(String value)
Load the region associated with the provided region name.
|
equals, hashCode, toString, value
public static final Region AP_NORTHEAST_1
public static final Region AP_NORTHEAST_2
public static final Region AP_SOUTH_1
public static final Region AP_SOUTHEAST_1
public static final Region AP_SOUTHEAST_2
public static final Region CA_CENTRAL_1
public static final Region EU_CENTRAL_1
public static final Region EU_WEST_1
public static final Region EU_WEST_2
public static final Region SA_EAST_1
public static final Region US_EAST_1
public static final Region US_EAST_2
public static final Region US_WEST_1
public static final Region US_WEST_2
public static final Region AWS_GLOBAL
public static final Region CN_NORTH_1
public static final Region CN_NORTHWEST_1
public static final Region AWS_CN_GLOBAL
public static Region of(String value)
This API is idempotent and will always return the same region instance if the same input value is provided.
For example, the following conditions will always evaluated to true:
Region.of("us-east-1") == Region.of("us-east-1")
, Region.US_EAST_1 == Region.of("us-east-1")
.
value
- The name of the region to load. Can't be null, empty or blankCopyright © 2017 Amazon Web Services, Inc. All Rights Reserved.