Get Bucket Object versions#

バケット内のオブジェクトのすべてのバージョンに関するメタデータを一覧表示します。

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}?versions

HTTPステータスコード#

正常時：200

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

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

名前 In Type デフォルト値
/必須指定		 Description
Bucket path string 必須 バケット名
delimiter query string 任意 キーをグループ化するために使用する文字
encoding-type query string 任意 レスポンスのエンコード方式を指定します。
key-marker query string 任意 リスト作成時の検索開始位置を指定するオブジェクトキーのマーカー文字列
指定した文字列より辞書的に大きいキーだけがリストに含まれます。
max-keys query string 1000
任意		 レスポンス本文に返されるキーの最大数を設定します。
prefix query string 任意 レスポンス本文に返されるキーを前方一致でフィルタする文字列
version-id-marker query string 任意 一覧表示を開始するオブジェクトのバージョンを指定します。
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
ListVersionsResult container レスポンスののコンテナ
Name string バケット名
VersionIdMarker string リクエスト時に指定したVersionIdMarker
Prefix string リクエスト時に指定したPrefix
KeyMarker string リクエスト時に指定したkey-marker
MaxKeys string レスポンスの最大オブジェクト数
IsTruncated boolean レスポンス数がMaxKeysで指定された値を超えた場合はTRUE、そうでない場合FALSEが表示されます。
Version container オブジェクトのVersion情報のコンテナ
Key string オブジェクトのキー
VersionId string オブジェクトのバージョンID
IsLatest boolean オブジェクトが現在のバージョンである場合はTRUE、そうでない場合はFASLEが表示されます。
LastModified date 最終更新日時
StorageClass string 常に"STANDARD"を返します。
Etag string オブジェクトのハッシュ
Size string オブジェクトのサイズ
Owner container オブジェクトの所有者情報
ID string オブジェクト所有者のID
DisplayName string オブジェクトの所有者名

リクエスト例#

GET /general-bucket2?versions 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:20190606T012407Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190606/jp-east-3/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=be65f75a76bd431bb77805ba9f0cd2eee733fe723f6df7a2e2d4a2353a7f086d

レスポンス例#

レスポンスヘッダ

HTTP/1.1 200 OK
Date: Thu, 06 Jun 2019 01:24:08 GMT
Content-Type: application/xml
Content-Length: 1077
Connection: keep-alive
x-amz-request-id: 742037594
x-amz-id-2: 12174498
x-ntap-sg-trace-id: e756c8c6cdb0931a
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-28849-1815777-1_200

レスポンスボディ

<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>general-bucket2</Name>
  <VersionIdMarker/>
  <Prefix/>
  <KeyMarker/>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>false</IsTruncated>
  <Version>
    <Key>object_data_1</Key>
    <VersionId>ODBBQzEyQzMtODZBQi0xMUU5LThBQTYtMUYwODAwQzVDRjUx</VersionId>
    <IsLatest>true</IsLatest>
    <LastModified>2019-06-04T09:31:16.780Z</LastModified>
    <StorageClass>STANDARD</StorageClass>
    <ETag>"0acd0dd3a9121a41ed274bbfb11365cc"</ETag>
    <Size>252864</Size>
    <Owner>
      <ID>42242073901014718119</ID>
      <DisplayName>fj-k5objt-tenant-99</DisplayName>
    </Owner>
  </Version>
  <Version>
    <Key>object_data_1</Key>
    <VersionId>N0VFNEU3M0UtODZBQi0xMUU5LTkzRjctRUIzODAwQkU3RDNF</VersionId>
    <IsLatest>false</IsLatest>
    <LastModified>2019-06-04T09:31:13.797Z</LastModified>
    <StorageClass>STANDARD</StorageClass>
    <ETag>"0acd0dd3a9121a41ed274bbfb11365cc"</ETag>
    <Size>252864</Size>
    <Owner>
      <ID>42242073901014718119</ID>
      <DisplayName>fj-k5objt-tenant-99</DisplayName>
    </Owner>
  </Version>
</ListVersionsResult>