Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright 2010-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
   *
   * Licensed under the Apache License, Version 2.0 (the "License").
   * You may not use this file except in compliance with the License.
   * A copy of the License is located at
   *
   *  http://aws.amazon.com/apache2.0
   *
  * or in the "license" file accompanying this file. This file is distributed
  * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
  * express or implied. See the License for the specific language governing
  * permissions and limitations under the License.
  */
 package com.amazonaws.services.s3.model;
 
 import java.util.List;
 
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.

 
 public enum Region {

    
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_Standard((String[])null),

    
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.

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("us-west-1"),

    
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_West_2("us-west-2"),

    
The US GovCloud Region. This region uses Amazon S3 servers located in the Northwestern region of the United States.
 
     US_GovCloud("s3-us-gov-west-1"),

    
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.

 
    EU_Ireland("eu-west-1","EU"),

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

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

The EU (Frankfurt) Region requires AWS 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"));
 

    EU_Frankfurt("eu-central-1"),

    
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_Singapore("ap-southeast-1"),

    
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_Sydney("ap-southeast-2"),

    
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_Tokyo("ap-northeast-1"),

    
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.

    SA_SaoPaulo("sa-east-1"),

    
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_Beijing("cn-north-1");

   
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.
    public static final Pattern S3_REGIONAL_ENDPOINT_PATTERN = Pattern.compile("s3-([^.]+)\\.amazonaws\\.com");

    
The list of ID's representing each region.
    private final List<StringregionIds;

    
Constructs a new region with the specified region ID's.

Parameters:
regionIds The list of ID's representing the S3 region.
    private Region(String... regionIds) {
        this. = regionIds != null ? Arrays.asList(regionIds) : null;
    }
    /*
     * (non-Javadoc)
     *
     * @see java.lang.Enum#toString()
     */
    @Override
    public String toString() {
        return getFirstRegionId0();
    }

    
Returns the first region id or null for US_Standard.
    public String getFirstRegionId() {
        return getFirstRegionId0();
    }
    private String getFirstRegionId0() {
        return this. == null || .size() == 0
             ? null : this..get(0);
    }

    
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:
java.lang.IllegalArgumentException If the specified value does not map to one of the known Amazon S3 regions.
    public static Region fromValue(final String s3RegionIdthrows IllegalArgumentException
    {
        if (s3RegionId == null || s3RegionId.equals("US"))
            return .;
        for (Region region : Region.values()) {
            List<StringregionIds = region.regionIds;
            if (regionIds != null && regionIds.contains(s3RegionId))
                return region;
        }
        throw new IllegalArgumentException(
                "Cannot create enum from " + s3RegionId + " value!");
    }

    
Returns the respective AWS region.
    public com.amazonaws.regions.Region toAWSRegion() {
        String s3regionId = getFirstRegionId();
        if ( s3regionId == null ) { // US Standard
            return RegionUtils.getRegionByEndpoint(.);
        } else {
            return RegionUtils.getRegion(s3regionId);
        }
    }
New to GrepCode? Check out our FAQ X