- HOME
- 開発者ガイドブック(APIリファレンス)
- オブジェクトストレージ
- サービス操作
- オブジェクト操作
- GET Object ACL
GET Object ACL
処理概要
GET Object ACLはaclサブリソースを利用して、アクセスコントロールリスト(ACL)を返します。
このメソッドを利用するには、objectに対してREAD_ACP権限が必要です。
リクエスト
リクエストパラメタ
Name | Type | Description |
---|---|---|
– | 使用不可 |
リクエストヘッダー
このオペレーションはすべての操作に共通するリクエストヘッダのみを使用しています。詳細については、一般的なリクエストヘッダを参照してください。
リクエストボディ
なし
リクエストサンプル
GET /sample-bucket/sample-object.txt?acl HTTP/1.1 Host: 192.168.0.1 Connection: keep-alive Date: Tue, 01 Sep 2015 10:00:00 +0000 Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr
レスポンス
レスポンスヘッダ
このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。
レスポンスボディ
Name | Type | Description |
---|---|---|
AccessControlList | container | Grant, Grantee, Permissionのコンテナ |
AccessControlPolicy | container | Grantee毎のobjectのACL permissionを内包します |
DisplayName | string | bucketオーナーのスクリーン名 |
Grant | container | grantee とそのpermissionのコンテナ |
Grantee | string | permissionを付与する対象 |
ID | string | bucketオーナーかgranteeのID |
Owner | container | bucketオーナーのスクリーン名とIDのコンテナ |
Permission | string | granteeに設定されたpermission (FULL_CONTROL, WRITE, READ_ACP) |
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <AccessControlList> <Grant> <Grantee> <ID>string</ID> <Permission>string</Permission> </Grantee> </Grant> </AccessControlList> <Owner> <ID>string</ID> <DisplayName>string</DisplayName> </Owner> </AccessControlPolicy>
レスポンスサンプル
HTTP/1.1 200 OK Date: Tue, 01 Sep 2015 10:00:00 GMT X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef Accept-Ranges: bytes Server: Cleversafe/3.5.1.0 X-Clv-S3-Version: 2.4 x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/xml Content-Length: 508
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Owner> <ID>56789abc-def0-1234-5678-9abcdef01234</ID> <DisplayName>abc0001</DisplayName> </Owner> <AccessControlList> <Grant> <Grantee xsi:type="CanonicalUser" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ID>56789abc-def0-1234-5678-9abcdef01234</ID> <DisplayName>abc0001</DisplayName> </Grantee> <Permission>FULL_CONTROL</Permission> </Grant> </AccessControlList> </AccessControlPolicy>