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>