本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/object-storage-service/api/GetBucketObjectVersions.htmへ移行しました。 今後は新ページをご参照ください。

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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上