Get Object ACL#

オブジェクトのACLを表示します。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/{bucket}/{object}?acl

HTTPステータスコード#

正常時:200

エラー時:400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
Bucket path string 必須 バケット名
Object body container 必須 オブジェクトの削除要求を記述するコンテナ要素
versionId query string 任意 バージョンID
バージョニング設定が有効なバケット内の特定バージョンのオブジェクトを削除する場合は必須
x-amz-content-sha256 header string 必須 ペイロード全体の計算されたSHA256チェックサム
x-amz-date header string 必須 リクエスト側で生成した現在日時
Authorization header string 必須 リクエスト認証に用いる文字列

レスポンスヘッダーの説明#

名前 Type Description
Date string トランザクションが実行された日時
Content-Type string MIME仕様で定義されているコンテントの形式
Content-Length string レスポンスボディのバイト数
Connection string 持続接続の状態を表示します。
x-amz-request-id string このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。
x-amz-id-2 string このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。
x-ntap-sg-trace-id string このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。
X-Fcx-Endpoint-Request string APIエンドポイントとしてリクエストを受け付けたことを示す番号

レスポンスボディ(正常系)の説明#

名前 Type Description
AccessControlPolicy container ACL権限を設定する要素
Owner container バケット所有者の表示名とIDのコンテナ
ID string バケット所有者のID、または権限対象者のID、テナントID
DisplayName string バケット所有者の表示名
AccessControlList container ACL
Grant container GranteeとPermissionが格納されるコンテナ
Grantee string 権限が設定されている件名
ID string Owner.IDと同じ内容が表示されます。
DisplayName string Owner.DisplayNameと同じ内容が表示されます。
Permission string 権限対象者に付与されている権限(FULL_CONTROL)が表示されます。

リクエスト例#

GET /general-bucket/object_data_1?acl HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T062455Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-3/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=282579cc446e94771ec894e2a98a35ad2a2d13f842d87c7ccb70dc3ba3c4705a

レスポンス例#

レスポンスヘッダー

HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 06:24:55 GMT
Content-Type: application/xml
Content-Length: 499
Connection: keep-alive
x-amz-request-id: 291741165
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 1affa0f9ec0ca4d3
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28849-848753-1_200

レスポンスボディ

<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>42242073901014718119</ID>
    <DisplayName>fj-k5objt-tenant-99</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>42242073901014718119</ID>
        <DisplayName>fj-k5objt-tenant-99</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>