Region (IBM COS SDK for Java 2.14.0 API)

java.lang.Object
- java.lang.Enum<Region>
- - com.ibm.cloud.objectstorage.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 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 Summary

Enum Constants
Enum Constant and Description
`AF_CapeTown` The Africa South (Cape Town) Region.
`AP_HongKong` The Asia Pacific (Hong Kong) Region.
`AP_Hyderabad` The Asia Pacific (Hyderabad) Region.
`AP_Jakarta` The Asia Pacific (Jakarta) Region.
`AP_Melbourne` The Asia Pacific (Melbourne) 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.
`EU_South_2` The EU (Spain) Amazon S3 Region.
`EU_Zurich` The EU (Zurich) Amazon S3 Region.
`ME_Bahrain` The Middle East (Bahrain) Region.
`ME_UAE` The Middle East (UAE) 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.

Field Summary

Fields
Modifier and Type Field and Description

static Pattern S3_REGIONAL_ENDPOINT_PATTERN
Used to extract the S3 regional id from an S3 end point.

Fields
Modifier and Type	Field and Description
`static Pattern`	`S3_REGIONAL_ENDPOINT_PATTERN` Used to extract the S3 regional id from an S3 end point.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
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 `Region.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.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, 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 is equivalent to 'us-east-1', see Amazon Simple Storage Service (S3) FAQs for more information.
    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.
  - US_East_2
```
public static final Region US_East_2
```
    The US-East-2 (Ohio) Region. This region uses Amazon S3 servers located in Ohio.
    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.
  - 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, 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.
  - 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, 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.
  - US_GovCloud
```
public static final Region US_GovCloud
```
    The US GovCloud Region. This region uses Amazon S3 servers located in the Northwestern region of the United States.
  - US_Gov_East_1
```
public static final Region US_Gov_East_1
```
    The US GovCloud (East) Region.
  - EU_Ireland
```
public static final Region EU_Ireland
```
    The EU (Ireland) Amazon S3 Region. This region uses Amazon S3 servers located in Ireland.
  - EU_London
```
public static final Region EU_London
```
    The EU (London) Amazon S3 Region. This region uses Amazon S3 servers located in London.
  - EU_Paris
```
public static final Region EU_Paris
```
    The EU (Paris) Amazon S3 Region. This region uses Amazon S3 servers located in Paris.
  - EU_Frankfurt
```
public static final Region EU_Frankfurt
```
    The EU (Frankfurt) Amazon S3 Region. This region uses Amazon S3 servers located in Frankfurt.
```
 AmazonS3Client s3 = new AmazonS3Client();
 s3.setRegion(RegionUtils.getRegion("eu-central-1"));
 
```
    See Also:
    
    AmazonS3Client.setRegion(com.ibm.cloud.objectstorage.regions.Region)
  - EU_Zurich
```
public static final Region EU_Zurich
```
    The EU (Zurich) Amazon S3 Region. This region uses Amazon S3 servers located in Zurich.
```
 AmazonS3Client s3 = new AmazonS3Client();
 s3.setRegion(RegionUtils.getRegion("eu-central-2"));
 
```
    See Also:
    
    AmazonS3Client.setRegion(com.ibm.cloud.objectstorage.regions.Region)
  - EU_North_1
```
public static final Region EU_North_1
```
    The EU (Stockholm) Amazon S3 Region. This region uses Amazon S3 servers located in Stockholm.
```
 AmazonS3Client s3 = new AmazonS3Client();
 s3.setRegion(RegionUtils.getRegion("eu-north-1"));
 
```
    See Also:
    
    AmazonS3Client.setRegion(com.ibm.cloud.objectstorage.regions.Region)
  - EU_South_1
```
public static final Region EU_South_1
```
    The EU (Milan) Amazon S3 Region. This region uses Amazon S3 servers located in Milan.
```
 AmazonS3Client s3 = new AmazonS3Client();
 s3.setRegion(RegionUtils.getRegion("eu-south-1"));
 
```
    See Also:
    
    AmazonS3Client.setRegion(com.ibm.cloud.objectstorage.regions.Region)
  - EU_South_2
```
public static final Region EU_South_2
```
    The EU (Spain) Amazon S3 Region. This region uses Amazon S3 servers located in Spain.
```
 AmazonS3Client s3 = new AmazonS3Client();
 s3.setRegion(RegionUtils.getRegion("eu-south-2"));
 
```
    See Also:
    
    AmazonS3Client.setRegion(com.ibm.cloud.objectstorage.regions.Region)
  - AP_HongKong
```
public static final Region AP_HongKong
```
    The Asia Pacific (Hong Kong) Region. This region uses Amazon S3 servers located in Hong Kong.
    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.
  - 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, 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_Sydney
```
public static final Region AP_Sydney
```
    The Asia Pacific (Sydney) Region. This region uses Amazon S3 servers located in Sydney, Australia.
    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.
  - AP_Jakarta
```
public static final Region AP_Jakarta
```
    The Asia Pacific (Jakarta) Region. This region uses Amazon S3 servers located in Jakarta, Indonesia.
    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.
  - AP_Melbourne
```
public static final Region AP_Melbourne
```
    The Asia Pacific (Melbourne) Region. This region uses Amazon S3 servers located in Melbourne, Australia.
    When using buckets in this region, set the client endpoint to s3-ap-southeast-4.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, 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.
  - AP_Seoul
```
public static final Region AP_Seoul
```
    The Asia Pacific (Seoul) Region. This region uses Amazon S3 servers located in 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.
  - AP_Osaka
```
public static final Region AP_Osaka
```
    The Asia Pacific (Osaka) Region. This region uses Amazon S3 servers located in Osaka.
  - AP_Mumbai
```
public static final Region AP_Mumbai
```
    The Asia Pacific (Mumbai) Region. This region uses Amazon S3 servers located in 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.
  - AP_Hyderabad
```
public static final Region AP_Hyderabad
```
    The Asia Pacific (Hyderabad) Region. This region uses Amazon S3 servers located in Hyderabad.
    When using buckets in this region, set the client endpoint to s3.ap-south-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.
  - 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, 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.
  - CA_Central
```
public static final Region CA_Central
```
    The Canada (Central) Region. This region uses Amazon S3 servers located in Canada.
    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.
  - CN_Beijing
```
public static final Region CN_Beijing
```
    The China (Beijing) Region. This region uses Amazon S3 servers located in Beijing.
    When using buckets in this region, you must set the client endpoint to s3.cn-north-1.amazonaws.com.cn.
  - CN_Northwest_1
```
public static final Region CN_Northwest_1
```
    The China (Ningxia) Region. This region uses Amazon S3 servers located in Ningxia.
    When using buckets in this region, you must set the client endpoint to s3.cn-northwest-1.amazonaws.com.cn.
  - ME_Bahrain
```
public static final Region ME_Bahrain
```
    The Middle East (Bahrain) Region. This region uses Amazon S3 servers located in Bahrain.
  - ME_UAE
```
public static final Region ME_UAE
```
    The Middle East (UAE) Region. This region uses Amazon S3 servers located in UAE.
  - AF_CapeTown
```
public static final Region AF_CapeTown
```
    The Africa South (Cape Town) Region. This region uses Amazon S3 servers located in Cape Town.
  - US_ISO_EAST_1
```
public static final Region US_ISO_EAST_1
```
    The US ISO East Region. This region uses Amazon S3 servers located in Virginia.
    When using buckets in this region, you must set the client endpoint to s3.us-iso-east-1.c2s.ic.gov.
  - US_ISOB_EAST_1
```
public static final Region US_ISOB_EAST_1
```
    The US ISOB East (Ohio) Region. This region uses Amazon S3 servers located in Ohio.
    When using buckets in this region, you must set the client endpoint to s3.us-isob-east-1.sc2s.sgov.gov.
  - US_ISO_WEST_1
```
public static final Region US_ISO_WEST_1
```
    The US ISO West Region. This region uses Amazon S3 servers located in Colorado.
    When using buckets in this region, you must set the client endpoint to s3.us-iso-west-1.c2s.ic.gov.
- Field Detail
  - S3_REGIONAL_ENDPOINT_PATTERN
```
public static final Pattern S3_REGIONAL_ENDPOINT_PATTERN
```
    Used to extract the S3 regional id from an S3 end point. Note this pattern will not match the S3 US standard endpoint by intent. Exampless:
```
 s3-eu-west-1.amazonaws.com
 s3.cn-north-1.amazonaws.com.cn
 
```
- 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>
  - getFirstRegionId
```
public String getFirstRegionId()
```
    Returns the first region id or null for Region.US_Standard.
  - fromValue
```
public static Region fromValue(String s3RegionId)
                        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:
    
    s3RegionId - 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.
  - toAWSRegion
```
public Region toAWSRegion()
```
    Returns the respective Amazon Web Services region.

Enum Region

Enum Constant Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

US_Standard

US_East_2

US_West

US_West_2

US_GovCloud

US_Gov_East_1

EU_Ireland

EU_London

EU_Paris

EU_Frankfurt

EU_Zurich

EU_North_1

EU_South_1

EU_South_2

AP_HongKong

AP_Singapore

AP_Sydney

AP_Jakarta

AP_Melbourne

AP_Tokyo

AP_Seoul

AP_Osaka

AP_Mumbai

AP_Hyderabad

SA_SaoPaulo

CA_Central

CN_Beijing

CN_Northwest_1

ME_Bahrain

ME_UAE

AF_CapeTown

US_ISO_EAST_1

US_ISOB_EAST_1

US_ISO_WEST_1

Field Detail

S3_REGIONAL_ENDPOINT_PATTERN

Method Detail

values

valueOf

toString

getFirstRegionId

fromValue

toAWSRegion