Object Storage Service:ListObjectVersions (GetBucketVersions)

Kullanım notları

• ListObjectVersions (GetBucketVersions), silme işaretçileri dahil olmak üzere tüm nesne sürümlerini döndürür. ListObjects (GetBucket) ise yalnızca silme işaretçisi olmayan geçerli sürümleri döndürür.

• ListObjectVersions (GetBucketVersions) işlemini çağırdığınızda nesneler ada göre alfabetik sırada, aynı nesnenin sürümleri ise sürüm kimliklerinin alfabetik sırasından bağımsız olarak en yeniden en eskiye doğru döndürülür.

• Paket için günlük kaydı ve gerçek zamanlı günlük sorgulama etkinleştirilmişse oluşturulan günlükteki işlem alanı GetBucket olur.

• ListObjectVersions (GetBucketVersions) çağrıları API işlemi çağırma ücretleri bölümünde açıklandığı gibi PUT isteklerinin sayısına göre faturalandırılır.

İstek sözdizimi

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

İstek üstbilgileri

DescribeRegions yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek parametreleri

Sonuçları filtrelemek için şu parametreleri kullanın: prefix, key-marker, version-id-marker, delimiter ve max-keys.

Yanıt parametreleri

ListObjectVersions (GetBucketVersions) isteğine verilen yanıtta x-oss-request-id ve Content-Type gibi ortak yanıt üstbilgileri hakkında daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

• Sürüm özelliği etkin olmayan bir paketteki nesne sürümlerini listeleme

  Örnek istekler

  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****************

  Örnek başarılı yanıt

  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>

• Sürüm özelliği etkin olan bir paketteki nesne sürümlerini listeleme

  oss-example paketi iki nesne içerir: example (üç sürüme sahip: 111222, silme işaretçisi olarak 000123 ve 222333, oluşturma zamanına göre azalan sırada) ve pic.jpg (bir sürüme sahip: 232323).

  key-marker değerini example ve version-id-marker değerini 111222 olarak ayarlarsanız aşağıdaki üç sürüm sırayla döndürülür: example'ın 000123 sürümü, example'ın 222333 sürümü ve pic.jpg'nin 232323 sürümü.

  Örnek istekler

  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****************

  Örnek başarılı yanıtlar

  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>

• İstenen pakette depolanan Arşiv nesneleri ve Soğuk Arşiv nesneleri

  examplebucket paketinin exampleobject1.txt, exampleobject2.txt ve exampleobject3.txt nesnelerini içerdiğini varsayalım. Üç nesne de Soğuk Arşiv depolama sınıfındadır. Üç nesnenin durumları şöyledir:

  • exampleobject1.txt için RestoreObject isteği gönderilmemiştir veya gönderilen RestoreObject isteğinin süresi dolmuştur.

  • exampleobject2.txt için RestoreObject isteği gönderilmiştir ve geri yükleme işlemi devam etmektedir.

  • exampleobject3.txt için RestoreObject isteği gönderilmiştir ve geri yükleme işlemi tamamlanmıştır.

  Örnek istek

  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

  Örnek yanıt

  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'ları

Bu işlemi aşağıdaki OSS SDK'ları ile çağırın:

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil komut satırı arabirimi

ListObjectVersions işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-object-versions.

Hata kodları