Object Storage Service:ListObjectVersions (GetBucketVersions)

使用上の注意

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

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

• ListObjectVersions (GetBucketVersions) 操作を呼び出すバケットに対してロギングおよびリアルタイムログクエリを有効にした場合、操作を呼び出すことによって生成されるログの操作フィールドの値は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という名前のオブジェクトには、作成時間ごとに111222、000123 (削除マーカー) 、222333の3つのバージョンがあります。 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リクエストが期限切れになります。

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

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

  リクエストの例

  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>

SDK

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

• Java

• Python

• 行く

• C ++

• . NET

• Node.js

エラーコード