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.os.cloud.nifty.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.os.cloud.nifty.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>
