com.amazonaws.services.s3.model

## 列挙型 Permission

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

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

      public enum Permission
      extends java.lang.Enum<Permission>

  Specifies constants defining an access permission, as granted to grantees in an `AccessControlList`. Only a limited set of permission are available; each one is represented as a value in this enumeration.

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

    列挙型定数
    列挙型定数と説明
    `FullControl` Provides READ, WRITE, READ_ACP, and WRITE_ACP permissions.
    `Read` Grants permission to list the bucket when applied to a bucket.
    `ReadAcp` Grants permission to read the ACL for the applicable bucket or object.
    `Write` Grants permission to create, overwrite, and delete any objects in the bucket.
    `WriteAcp` Gives permission to overwrite the ACP for the applicable bucket or object.

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `java.lang.String` | `getHeaderName()` Returns the name of the header used to grant this permission.
    `static Permission` | `parsePermission(java.lang.String str)` Returns the `Permission` enumeration value representing the specified Amazon S3 Region ID string.
    `java.lang.String` | `toString()` Gets the string representation of this permission object as defined by Amazon S3, eg.
    `static Permission` | `valueOf(java.lang.String name)` 指定した名前を持つこの型の列挙型定数を返します。
    `static Permission[]` | `values()` この列挙型の定数を含む配列を宣言されている順序で返します。

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

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

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

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

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

    - #### FullControl

          public static final Permission FullControl

      Provides READ, WRITE, READ_ACP, and WRITE_ACP permissions.

      It does not convey additional rights and is provided only for convenience.

    - #### Read

          public static final Permission Read

      Grants permission to list the bucket when applied to a bucket. Grants permission to read object data and/or metadata when applied to an object.

    - #### Write

          public static final Permission Write

      Grants permission to create, overwrite, and delete any objects in the bucket.

      This permission is not supported for objects.

    - #### ReadAcp

          public static final Permission ReadAcp

      Grants permission to read the ACL for the applicable bucket or object.

      The owner of a bucket or object always implicitly has this permission.

    - #### WriteAcp

          public static final Permission WriteAcp

      Gives permission to overwrite the ACP for the applicable bucket or object.

      The owner of a bucket or object always has this permission implicitly.

      Granting this permission is equivalent to granting `FULL_CONTROL`because the grant recipient can make any changes to the ACP.

  - ### メソッドの詳細

    - #### values

          public static Permission[] values()

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

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

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

    - #### valueOf

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

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

    - #### getHeaderName

          public java.lang.String getHeaderName()

      Returns the name of the header used to grant this permission.

    - #### toString

          public java.lang.String toString()

      Gets the string representation of this permission object as defined by Amazon S3, eg. `FULL_CONTROL`.
      オーバーライド:
        `toString` クラス内 `java.lang.Enum<Permission>`
      戻り値:
        The string representation of this permission object as defined by Amazon S3, eg. `FULL_CONTROL`.

    - #### parsePermission

          public static Permission parsePermission(java.lang.String str)

      Returns the `Permission` enumeration value representing the specified Amazon S3 Region ID string. If specified string doesn't map to a known Amazon S3 Region, returns `null`.
      パラメータ:
        `str` - A string representation of an Amazon S3 permission, eg. `FULL_CONTROL`
      戻り値:
        The `Permission` object represented by the given permission string, Returns `null` if the string isn't a valid representation of an Amazon S3 permission.