Object Storage Service:ListObjectVersions (GetBucketVersions)

注意事項

• ListObjectVersions (GetBucketVersions) は、削除マーカーを含むすべてのオブジェクトバージョンを返します。ListObjects (GetBucket) は、削除マーカーを含まない現在のバージョンのみを返します。

• ListObjectVersions (GetBucketVersions) を呼び出すと、オブジェクトは名前のアルファベット順に返され、同じオブジェクトのバージョンは、バージョン ID のアルファベット順に関係なく、最新のものから最も古いものへと順に返されます。

• ロギングとリアルタイムログクエリがバケットで有効になっている場合、生成されたログの operation フィールドは GetBucket になります。

• ListObjectVersions (GetBucketVersions) の呼び出しは、「API 操作の呼び出し料金」で説明されているように、PUT リクエストの数に基づいて課金されます。

リクエスト構文

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

リクエストヘッダー

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

リクエストパラメーター

結果をフィルターリングするには、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: 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>

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

  バケット oss-example には 2 つのオブジェクトが含まれています。1 つは example で、3 つのバージョン (作成時刻の降順で 111222、削除マーカーとして 000123、222333) があり、もう 1 つは pic.jpg で、1 つのバージョン (232323) があります。

  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 つのオブジェクトはすべてコールドアーカイブストレージクラスにあります。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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  レスポンスの例

  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="Thu, 24 Sep 2020 12:40:33 GMT"</RestoreInfo>
          <Owner>
            <ID>1234512528586****</ID>
            <DisplayName>12345125285864390</DisplayName>
          </Owner>
       </Version>
  </ListVersionsResult>

OSS SDK

次の OSS SDK を使用してこの操作を呼び出します。

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil コマンドラインインターフェイス

ListObjectVersions 操作に対応する ossutil コマンドについては、「list-object-versions」をご参照ください。

エラーコード