GetBucketVersions(ListObjectVersions) - 对象存储 OSS

注意事项

对于已开启版本控制的Bucket，调用GetBucketVersions(ListObjectVersions)与GetBucket(ListObjects)接口的返回结果区别如下：

• GetBucket(ListObjects)接口仅返回Object的当前版本，且当前版本不能为删除标记。
• GetBucketVersions(ListObjectVersions)接口返回Bucket中所有Object的所有版本。

  不同Object之间按字母排序返回，同一个Object的不同版本则按从新到旧排序，与版本ID的字母序无关。

请求头

此接口仅涉及公共请求头，例如Authorization、Host等更多信息，请参见公共请求头（Common Request Headers）。

请求参数

调用GetBucketVersions(ListObjectVersions)接口时，可通过设置prefix、key-marker、version-id-marker、delimiter和max-keys参数限制仅返回部分结果。

响应元素

此接口涉及的其他公共响应头，例如x-oss-request-id、Content-Type等的更多信息，请参见公共响应头（Common Response Headers）。

示例

• 未启用版本控制

  请求示例

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

  返回示例

  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-cos-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>
      </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的Bucket中有example和pic.jpg 2个Object，其中example这个Object有3个版本，从新到旧排序的版本ID依次为111222、000123（删除标记）、222333 。pic.jpg这个Object仅有1个版本，其版本ID为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 ami4tq0x76o****:WFx4kLpx+e7Rc0jawCsh7hlk****

  返回示例：

  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>

SDK

此接口所对应的各语言SDK如下：

• Java
• Python
• Go
• C++
• .NET
• Node.js

错误码