ニフクラAPI (オブジェクトストレージサービス: GetBucketObjectVersions)

GetBucketObjectVersions

処理概要

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

リクエストURL

GET /{Bucket}?versions

指定するパラメーター

ヘッダーパラメーター

パラメーター	型	説明	必須
x-amz-content-sha256	string	ペイロード全体の計算されたSHA256チェックサム	○
x-amz-date	string	リクエスト側で生成した現在日時	○
Authorization	string	リクエスト認証に用いる文字列	○

パスパラメーター

パラメーター	型	説明	必須
Bucket	string	バケット名	○

クエリパラメーター

パラメーター	型	説明	必須
delimiter	string	キーをグループ化するために使用する文字
encoding-type	string	レスポンスのエンコード方式を指定します。
key-marker	string	リスト作成時の検索開始位置を指定するオブジェクトキーのマーカー文字列 指定した文字列より辞書的に大きいキーだけがリストに含まれます。
max-keys	string	レスポンス本文に返されるキーの最大数を設定します。 Default: 1000
prefix	string	レスポンス本文に返されるキーを前方一致でフィルタする文字列
version-id-marker	string	一覧表示を開始するオブジェクトのバージョンを指定します。

応答フィールド

レスポンスヘッダー

フィールド (項目)	型	説明
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エンドポイントとしてリクエストを受け付けたことを示す番号

レスポンスボディ

フィールド (項目)	型	説明
ListVersionsResult	structure	レスポンスのコンテナ
␣Name	string	バケット名
␣VersionIdMarker	string	リクエスト時に指定したVersionIdMarker
␣Prefix	string	リクエスト時に指定したPrefix
␣KeyMarker	string	リクエスト時に指定したkey-marker
␣MaxKeys	string	レスポンスの最大オブジェクト数
␣IsTruncated	boolean	レスポンス数がMaxKeysで指定された値を超えた場合はTRUE、そうでない場合FALSEが表示されます。
␣Version	list	オブジェクトのVersion情報のコンテナ
␣␣Key	string	オブジェクトのキー
␣␣VersionId	string	オブジェクトのバージョンID
␣␣IsLatest	boolean	オブジェクトが現在のバージョンである場合はTRUE、そうでない場合はFASLEが表示されます。
␣␣LastModified	timestamp	最終更新日時
␣␣StorageClass	string	常に"STANDARD"を返します。
␣␣ETag	string	オブジェクトのハッシュ
␣␣Size	string	オブジェクトのサイズ
␣␣Owner	string	オブジェクトの所有者情報
␣␣␣ID	string	オブジェクト所有者のID
␣␣␣DisplayName	string	オブジェクトの所有者名

リクエストサンプル

    GET /general-bucket2?versions HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190606T012407Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190606/jp-east-1/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-1.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>