ニフクラAPI（オブジェクトストレージ：Get Object acl）

Get Object acl

処理概要

指定したオブジェクトのアクセス権限情報を取得します。

バージョン管理

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

指定するパラメーター

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

指定するヘッダー

必要なヘッダーはありません。

指定するボディ

必要なボディはありません。

応答フィールド

フィールド	説明	サンプル値
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 : なし

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

GET /sample.txt?acl= HTTP/1.1

Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com

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

Authorization: AWS 07cbb45fc128390123f4:DqvngOELb9qE8e1fv8dKpH7b2fM=

応答サンプル

HTTP/1.0 200 OK

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

        x-amz-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9

        Content-Length: 439

				

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

				  </AccessControlList>

				</AccessControlPolicy>

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

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

Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com

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

Authorization: AWS 07cbb45fc128390123f4:DqvngOELb9qE8e1fv8dKpH7b2fM=

応答サンプル

HTTP/1.0 200 OK

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

        x-amz-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9

        x-amz-version-id: 999122348912293847

        Content-Length: 439

				

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

				  </AccessControlList>

				</AccessControlPolicy>