Object Storage Service:ListObjectVersions (GetBucketVersions)

使用上の注意

• ListObjectVersions (GetBucketVersions) オペレーションを呼び出すと、削除マーカーを含む、バケット内のオブジェクトのすべてのバージョンが返されます。ListObjects (GetBucket) オペレーションを呼び出すと、削除マーカーを除く、バケット内のオブジェクトの現在のバージョンが返されます。

• ListObjectVersions (GetBucketVersions) オペレーションを呼び出すと、オブジェクトはアルファベット順に返されますが、各オブジェクトのバージョンは作成時刻の降順で返されます。

• ListObjectVersions (GetBucketVersions) オペレーションを呼び出すバケットに対して ロギング と リアルタイムログクエリ を有効にすると、オペレーションの呼び出しによって生成されたログの operation フィールドの値は GetBucket になります。

• ListObjectVersions (GetBucketVersions) オペレーションを呼び出すと、PUT リクエストの数に基づいて課金されます。詳細については、「API オペレーション呼び出し料金」をご参照ください。

リクエスト構造

GET /?versions HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

GetBucketVersions (ListObjectVersions) オペレーションを呼び出すときに、返される結果をフィルタリングするために、prefix、key-marker、version-id-marker、delimiter、max-keys のパラメーターを指定できます。

レスポンスパラメーター

ListObjectVersions (GetBucketVersions) リクエストへのレスポンスの x-oss-request-id や Content-Type などの共通レスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。

例

• バージョン管理されていないバケット内のオブジェクトのバージョンを一覧表示する

  リクエスト例

  GET /?versions HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 07:27:48 GMT
  Authorization: OSS qn6q**************:77Dv****************

  正常なレスポンス例

  HTTP/1.1 200 OK
  Content-Type: application/xml
  Content-Length: 1262
  Connection: keep-alive
  Date: Thu, Tue, 09 Apr 2019 07:27:48 GMT
  Server: AliyunOSS
  x-oss-request-id: 534B371674E88A4D8906****
  
  <ListVersionsResult>
      <Name>examplebucket-1250000000</Name>
      <Prefix/>
      <KeyMarker/>
      <VersionIdMarker/>
      <MaxKeys>1000</MaxKeys>
      <IsTruncated>false</IsTruncated>
      <Version>
          <Key>example-object-1.jpg</Key>
          <VersionId/>
          <IsLatest>true</IsLatest>
          <LastModified>2019-08-5T12:03:10.000Z</LastModified>    
          <ETag>5B3C1A2E053D763E1B669CC607C5A0FE1****</ETag>
          <Size>20</Size>
          <StorageClass>STANDARD</StorageClass>
          <Owner>
              <ID>1250000000</ID>
              <DisplayName>1250000000</DisplayName>
          </Owner>
          <TransitionTime>2024-04-23T07:21:42.000Z</TransitionTime>
      </Version>
      <Version>
          <Key>example-object-2.jpg</Key>
          <VersionId/>
          <IsLatest>true</IsLatest>
          <LastModified>2019-08-9T12:03:09.000Z</LastModified>
          <ETag>5B3C1A2E053D763E1B002CC607C5A0FE1****</ETag>
          <Size>20</Size>
          <StorageClass>STANDARD</StorageClass>
          <Owner>
              <ID>1250000000</ID>
              <DisplayName>1250000000</DisplayName>
          </Owner>
      </Version>
      <Version>
          <Key>example-object-3.jpg</Key>
          <VersionId/>
          <IsLatest>true</IsLatest>
          <LastModified>2019-08-10T12:03:08.000Z</LastModified>
          <ETag>4B3F1A2E053D763E1B002CC607C5AGTRF****</ETag>
          <Size>20</Size>
          <StorageClass>STANDARD</StorageClass>
          <Owner>
              <ID>1250000000</ID>
              <DisplayName>1250000000</DisplayName>
          </Owner>
      </Version>
  </ListVersionsResult>

• バージョン管理が有効なバケット内のオブジェクトのバージョンを一覧表示する

  この例では、example と pic.jpg という名前の 2 つのオブジェクトが oss-example という名前のバケットに格納されています。example という名前のオブジェクトには、作成時刻の降順で表示される 3 つのバージョン (111222、000123 (削除マーカー)、222333) があります。pic.jpg という名前のオブジェクトには、ID が 232323 のバージョンが 1 つだけあります。

  key-marker を example に、version-id-marker を 111222 に設定すると、example の 000123、example の 222333、pic.jpg の 232323 の 3 つのバージョンが順番に返されます。

  リクエスト例

  GET /?versions&key-marker=example&version-id-marker=CAEQMxiBgICbof2D0BYiIGRhZjgwMzJiMjA3MjQ0ODE5MWYxZDYwMzJlZjU1**** HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 07:27:48 GMT
  Authorization: OSS qn6q**************:77Dv****************

  正常なレスポンス例

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC4974B7AEADE01700****
  Date: Tue, 09 Apr 2019 07:27:48 GMT
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <ListVersionsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <Name>oss-example</Name>
      <Prefix></Prefix>
      <KeyMarker>example</KeyMarker>
      <VersionIdMarker>CAEQMxiBgICbof2D0BYiIGRhZjgwMzJiMjA3MjQ0ODE5MWYxZDYwMzJlZjU1****</VersionIdMarker>
      <MaxKeys>100</MaxKeys>
      <Delimiter></Delimiter>
      <IsTruncated>false</IsTruncated>
      <DeleteMarker>
          <Key>example</Key>
          <VersionId>CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****</VersionId>
          <IsLatest>false</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
      </DeleteMarker>
      <Version>
          <Key>example</Key>
          <VersionId>CAEQMxiBgMDNoP2D0BYiIDE3MWUxNzgxZDQxNTRiODI5OGYwZGMwNGY3MzZjN****</VersionId>
          <IsLatest>false</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <ETag>"250F8A0AE989679A22926A875F0A2****"</ETag>
          <Type>Normal</Type>
          <Size>93731</Size>
          <StorageClass>Standard</StorageClass>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
      </Version>
      <Version>
          <Key>pic.jpg</Key>
          <VersionId>CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx****</VersionId>
          <IsLatest>true</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <ETag>"3663F7B0B9D3153F884C821E7CF4****"</ETag>
          <Type>Normal</Type>
          <Size>574768</Size>
          <StorageClass>Standard</StorageClass>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
      </Version>
  </ListVersionsResult>

• リクエストされたバケットに格納されているアーカイブオブジェクトとコールドアーカイブオブジェクト

  この例では、examplebucket バケットには、exampleobject1.txt、exampleobject2.txt、exampleobject3.txt というコールドアーカイブオブジェクトが含まれています。3 つのオブジェクトは次の状態です。

  • exampleobject1.txt を復元するための RestoreObject リクエストが送信されていないか、オブジェクトを復元するために送信された RestoreObject リクエストの有効期限が切れています。

  • exampleobject2.txt を復元するための RestoreObject リクエストが送信され、オブジェクトは復元中です。

  • exampleobject3.txt を復元するための RestoreObject リクエストが送信され、オブジェクトは復元されています。

  リクエスト例

  GET / HTTP/1.1
  Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
  Date: Fri, 24 Feb 2012 08:43:27 GMT
  Authorization: OSS qn6q**************:77Dv****************

  正常なレスポンス例

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC4974B7AEADE01700****
  Date: Tue, 09 Apr 2019 07:27:48 GMT
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <ListVersionsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <Name>oss-example</Name>
      <Prefix></Prefix>
      <KeyMarker>example</KeyMarker>
      <VersionIdMarker>CAEQMxiBgICbof2D0BYiIGRhZjgwMzJiMjA3MjQ0ODE5MWYxZDYwMzJlZjU1****</VersionIdMarker>
      <MaxKeys>100</MaxKeys>
      <Delimiter></Delimiter>
      <IsTruncated>false</IsTruncated>
      <Version>
          <Key>exampleobject1.txt</Key>
          <VersionId>CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****</VersionId>
          <IsLatest>false</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
       </Version>
      <Version>
          <Key>exampleobject2.txt</Key>
          <VersionId>CAEQMxiBgMDNoP2D0BYiIDE3MWUxNzgxZDQxNTRiODI5OGYwZGMwNGY3MzZjN****</VersionId>
          <IsLatest>false</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <ETag>"250F8A0AE989679A22926A875F0A2****"</ETag>
          <Type>Normal</Type>
          <Size>93731</Size>
          <StorageClass>Standard</StorageClass>
          <RestoreInfo>ongoing-request="true"</RestoreInfo>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
       </Version>
      <Version>
          <Key>exampleobject3.txt</Key>
          <VersionId>CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx****</VersionId>
          <IsLatest>true</IsLatest>
          <LastModified>2019-04-09T07:27:28.000Z</LastModified>
          <ETag>"3663F7B0B9D3153F884C821E7CF4****"</ETag>
          <Type>Normal</Type>
          <Size>574768</Size>
          <StorageClass>Standard</StorageClass>
          <RestoreInfo>ongoing-request="false", expiry-date="Thr, 24 Mon 2020 12:40:33 GMT"</RestoreInfo>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
       </Version>
  </ListVersionsResult>

OSS SDK

次のプログラミング言語の OSS SDK を使用して、ListObjectVersions (GetBucketVersions) オペレーションを呼び出すことができます。

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil

ListObjectVersions オペレーションに対応する ossutil コマンドについては、「list-object-versions」をご参照ください。

エラーコード