com.amazonaws.services.s3.model

## 列挙型 Region

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

- すべての実装されたインタフェース:
    java.io.Serializable, java.lang.Comparable<Region>

      public enum Region
      extends java.lang.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.

- - ### 列挙型定数の概要

    列挙型定数
    列挙型定数と説明
    `AP_Singapore` The Asia Pacific (Singapore) Region.
    `AP_Sydney` The Asia Pacific (Sydney) 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_GovCloud` The US GovCloud 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.

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `static Region` | `fromValue(java.lang.String s3RegionString)` Returns the Amazon S3 Region enumeration value representing the specified Amazon S3 Region ID string.
    `java.lang.String` | `toString()`
    `static Region` | `valueOf(java.lang.String name)` 指定した名前を持つこの型の列挙型定数を返します。
    `static Region[]` | `values()` この列挙型の定数を含む配列を宣言されている順序で返します。

    - ### クラスから継承されたメソッド java.lang.Enum

      `clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf`

    - ### クラスから継承されたメソッド java.lang.Object

      `getClass, notify, notifyAll, wait, wait, wait`

- - ### 列挙型定数の詳細

    - #### 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, 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, 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.

    - #### 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, 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_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.

    - #### 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.

  - ### メソッドの詳細

    - #### values

          public static Region[] values()

      この列挙型の定数を含む配列を宣言されている順序で返します。 このメソッドは次のようにして定数を反復するために 使用できます:

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

      戻り値:
        この列挙型の定数を宣言されている順序で 含む配列

    - #### valueOf

          public static Region valueOf(java.lang.String name)

      指定した名前を持つこの型の列挙型定数を返します。 文字列は、この型の列挙型定数を宣言するのに使用した識別子と正確に 一致している必要があります。 (余分な空白文字を含めることはできません。)
      パラメータ:
        `name` - 返される列挙型定数の名前
      戻り値:
        指定された名前を持つ列挙型定数
      例外:
        `java.lang.IllegalArgumentException` - 指定された名前を持つ定数を この列挙型が持っていない場合
        `java.lang.NullPointerException` - 引数がnullの場合

    - #### toString

          public java.lang.String toString()

      オーバーライド:
        `toString` クラス内 `java.lang.Enum<Region>`

    - #### fromValue

          public static Region fromValue(java.lang.String s3RegionString)
                                  throws java.lang.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.
      パラメータ:
        `s3RegionString` - The Amazon S3 region ID string.
      戻り値:
        The Amazon S3 Region enumeration value representing the specified Amazon S3 Region ID.
      例外:
        `java.lang.IllegalArgumentException` - If the specified value does not map to one of the known Amazon S3 regions.