クラウド API（オブジェクトストレージ：Put Object acl）

Put Object acl

処理概要

指定したオブジェクトに対して、アクセス権限を設定します。

バージョン管理

特定のバージョンのACLを設定するにはversionIdを指定します。

指定するパラメーター

パラメーター	説明	必須	サンプル値
acl	ACLリクエスト値 : なし	○
versionId	オブジェクトのバージョンID Type : int		999122348912293847

指定するヘッダー

パラメーター	説明	必須	サンプル値
x-amz-acl	CannedACL Type : String Default : private 値 : private \| public-read \| authenticated-read

指定するボディ

フィールド	説明	サンプル値
AccessControlPolicy	AccessControlPolicyリクエスト Type : Container Ancestor : なし Children : Owner,AccessControlList
Owner	Ownerリクエスト Type : Container Ancestor : AccessControlPolicy Children : ID,DisplayName
ID	オーナーID Type : xsd:string Ancestor : AccessControlPolicy.Owner \| AccessControlPolicy.AccessControlList.Grant.Grantee Children : なし	ABC12345
DisplayName	オーナー名 Type : xsd:string Ancestor : AccessControlPolicy.Owner \| AccessControlPolicy.AccessControlList.Grant.Grantee Children : なし	ABC12345
AccessControlList	AccessControlListリクエスト Type : Container Ancestor : AccessControlPolicy Children : Grant
Grant	Grantリクエスト Type : Container Ancestor : AccessControlPolicy.AccessControlList.Grant Children : Grantee
Grantee	Granteeリクエスト Type : Container Ancestor : AccessControlPolicy.AccessControlList.Grant Children : ID,DisplayName
Permission	アクセス権限 FULL_CONTROL \| WRITE \| WRITE_ACP \| READ \| READ_ACP Type : xsd:string Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee Children : なし

Grantee

設定対象ユーザーと指定は以下となります。

特定ユーザー


                <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

					  <ID>Owner ID</ID>

					  <DisplayName>Owner DisplayName(Owner ID)</DisplayName>

				</Grantee>

認証ユーザー

<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

					  <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>

				</Grantee>

未認証ユーザー

<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

				  <URI>http://acs.nifty.com/groups/global/AllUsers</URI>

				</Grantee>

応答フィールド

応答フィールドはありません。

リクエストサンプル（versionId指定なし）

PUT /sample.txt?acl= HTTP/1.1

						Host: my-first-bucket.jp-east-2.os.cloud.nifty.com

						Date: Wed, 29 Jun 2016 12:00:00 GMT

						Authorization: AWS 07cbb45fc128390123f4:wW2I1mKrZhXwIGLBnGSgQ0XbACo=

						Content-Length: 961

						Content-Type: text/plain

						

					<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">

					  <Owner>

					    <ID>ABC12345</ID>

					    <DisplayName>ABC12345</DisplayName>

					  </Owner>

					  <AccessControlList>

					    <Grant>

					      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

					        <ID>ABC12345</ID>

					        <DisplayName>ABC12345</DisplayName>

					      </Grantee>

					      <Permission>FULL_CONTROL</Permission>

					    </Grant>

					    <Grant>

					      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

					        <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>

					      </Grantee>

					      <Permission>WRITE</Permission>

					    </Grant>

					    <Grant>

					      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

					        <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>

					      </Grantee>

					      <Permission>READ</Permission>

					    </Grant>

					    <Grant>

					      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

					        <URI>http://acs.nifty.com/groups/global/AllUsers</URI>

					      </Grantee>  

					      <Permission>READ</Permission>

					    </Grant>

					  </AccessControlList>

          </AccessControlPolicy>

応答サンプル

HTTP/1.1 200 OK 

					x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a

					Content-Length:  0

リクエストサンプル（versionId指定あり）

PUT /sample.txt?acl&versionId=999122348912293847 HTTP/1.1

Host: my-first-bucket.jp-east-2.os.cloud.nifty.com

Date: Wed, 29 Jun 2016 12:00:00 GMT

Authorization: AWS 07cbb45fc128390123f4:wW2I1mKrZhXwIGLBnGSgQ0XbACo=

Content-Length: 961

Content-Type: text/plain



<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">

  <Owner>

    <ID>ABC12345</ID>

    <DisplayName>ABC12345</DisplayName>

  </Owner>

  <AccessControlList>

    <Grant>

    <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

      <ID>ABC12345</ID>

      <DisplayName>ABC12345</DisplayName>

    </Grantee>

      <Permission>FULL_CONTROL</Permission>

    </Grant>

    <Grant>

    <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

      <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>

    </Grantee>

      <Permission>WRITE</Permission>

    </Grant>

    <Grant>

      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

      <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>

    </Grantee>

      <Permission>READ</Permission>

    </Grant>

    <Grant>

    <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">

      <URI>http://acs.nifty.com/groups/global/AllUsers</URI>

    </Grantee>

      <Permission>READ</Permission>

    </Grant>

  </AccessControlList>

</AccessControlPolicy>

応答サンプル

HTTP/1.1 200 OK 

          x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a

          x-amz-version-id: 999122348912293847

					Content-Length:  0