公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ IoTサービス オンラインマニュアル

GET Object acl

オブジェクトのACL設定内容を取得します。
この操作を行うユーザは、オブジェクトに対してREAD_ACP権限を付与されていなければなりません。

 

リクエスト情報

シンタックス
GET /{bucket name}/{object key}?acl HTTP/1.1
Host: s3api.iot.iij.jp
Date: {date}
Authorization: {authorization string}
Range: bytes={byte range}

 

リクエストパラメータ
この操作ではリクエストパラメータは使用しません。
リクエストヘッダー

この操作では基本リクエストヘッダーのみ使用します。

リクエストエレメント

この操作ではリクエストエレメントは使用しません。

 

レスポンス情報

レスポンスヘッダー

この操作では基本レスポンスヘッダーのみ返します。

レスポンスエレメント

この操作では以下のレスポンスエレメントを返します。

表. GET Object acl レスポンスエレメント一覧

名前説明
AccessControlList

Grantを含むコンテナ

  • 型:Container
  • 子:Grantee, Permission
  • 親:AccessControlPolicy
AccessControlPolicy

AccessControlList、Ownerを含むコンテナ

  • 型:Container
  • 子:AccessControlList, Owner
  • 親:なし
DisplayName

オブジェクト所有者の表示名または権限付与対象者の表示名

  • 型:String
  • 親:AcessControlPolicy.Owner
    または AcessControlPolicy.AccessControlList.Grant.Grantee
Grant

GranteeとPermissionを含むコンテナ

  • 型:Container
  • 子:Grantee, Permission
  • 親:AcessControlPolicy.AccessControlList
Grantee

権限付与の対象についての情報。 DisplayName, IDを含むコンテナ

  • 型:Container
  • 子:DisplayName, ID
  • 親:AcessControlPolicy.AccessControlList.Grant
ID

オブジェクト所有者のID、または権限付与対象者のID

  • 型:String
  • 親:AcessControlPolicy.Owner
    または AcessControlPolicy.AccessControlList.Grant.Grantee
Owner

オブジェクト所有者の情報。DisplayNameとIDを含むコンテナ

  • 型:Container
  • 子:DisplayName, ID
  • 親:AcessControlPolicy
Permission

Granteeに与える権限

  • 型:String
  • 有効な値:FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
  • 親:AcessControlPolicy.AccessControlList.Grant

 

エラー情報

この操作では以下のエラーを返します。

表. GET Object acl エラーコード一覧

コードステータス内容
InvalidAccessKeyId403 Forbidden指定のアクセスキーIDを持つユーザが存在しません。
SignatureDoesNotMatch403 Forbidden指定されたリクエストのシグネチャが一致しません。
AccessDenied403 Forbiddenバケットに対するREAD_ACP権限がありません。
NoSuchKey404 Not Found指定オブジェクトキーのオブジェクトが存在しません。

 

サンプル

オブジェクトのACLを取得するサンプル

リクエスト
GET /bucket/my-image.jpg?acl HTTP/1.1
Host: s3api.iot.iij.jp
Date: Wed, 28 Oct 2009 22:32:00 GMT
Authorization: IIJGIO 02236Q3V0WHVSRW0EXG2:0RQf4/cRonhpaBX5sCYVf1bNRuU=
レスポンス
HTTP/1.1 200 OK
x-iijgio-id-2: eftixk72aD6Ap51TnqcoF8eFidJG9Z/2mkiDFu8yU9AS1ed4OpIszj7UDNEHGran
x-iijgio-request-id: 318BC8BC148832E5
x-iijgio-version-id: 4HL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nrjfkd
Date: Wed, 28 Oct 2009 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Server: s3api.iot.iij.jp
<AccessControlPolicy>
  <Owner>
    <ID>8a6925ce4adf588a4532aa379004fef</ID>
    <DisplayName>mtd@dag.iijgio.com</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>8a6925ce4adf588a453214a379004fef</ID>
        <DisplayName>mtd@dag.iijgio.com</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>