Object Storage Service:GetBucketInventory

Kullanım notları

Varsayılan olarak, bir Alibaba Cloud hesabı bir paketin belirtilen envanter yapılandırmasını görüntüleme iznine sahiptir. Bu işlemi bir Resource Access Management (RAM) kullanıcısı olarak veya Security Token Service (STS) kullanarak çağırmak için oss:GetBucketInventory iznine sahip olmanız gerekir.

İstek sözdizimi

GET /?inventory&inventoryId=inventoryId HTTP/1.1

İstek parametreleri

Yanıt öğeleri

Aşağıdaki tabloda yanıtta döndürülen öğeler açıklanmaktadır. Bazı öğeler yalnızca belirli envanter yapılandırmaları için geçerlidir. Örneğin, DayOfMonth yalnızca Frequency değeri Monthly olarak ayarlandığında geçerlidir ve AutoDelete yalnızca Frequency değeri Once olarak ayarlandığında geçerlidir. Artımlı envanterlere özgü öğeler aşağıdaki alt bölümde açıklanmıştır.

Artımlı envanter kayıt alanları

Aşağıdaki alanlar bir artımlı envanter dosyasındaki kayıtları açıklar:

• SequenceNumber: Kaydın seri numarası. Her kaydın SequenceNumber değeri benzersizdir. Aynı paketteki aynı nesneye ait kayıtlar SequenceNumber değerine göre sıralanabilir ve sıralanan kayıtlar genellikle kronolojik sırada olur.

• RecordType: Olay türü. Geçerli değerler:

  • CREATE: Seçilen önek altında gerçekleşen tüm yükleme işlemleri; örneğin Put, Post, Append, MultipartUpload ve Copy.

  • UPDATE_METADATA: Seçilen önek altındaki tüm meta veri güncellemeleri.

  • DELETE: Seçilen önek altındaki nesnelerin tüm silme işlemleri; örneğin DeleteObject ve DeleteMultipleObjects, sürüm oluşturma etkinleştirildikten sonra bir silme işaretçisinin oluşturulması ve yaşam döngüsü tabanlı silme. Silme işlemleri arasında silme işaretçisi oluşturma ve kalıcı silme bulunur. Kalıcı silme durumunda kayıt yalnızca Bucket, Key, SequenceNumber, RecordType, RecordTimestamp ve VersionId temel alanlarını korur ve diğer tüm sütunlar null olur.

• RecordTimestamp: Kaydın zaman damgası (Greenwich Ortalama Saati, milisaniye hassasiyetinde). Örnek: 2024-08-25 18:08:01.024.

• Requester: İsteği yapan kişinin Alibaba Cloud kimliği veya Principal ID'si.

• RequestId: İsteğin benzersiz tanımlayıcısı.

• SourceIp: İsteği yapan kişinin kaynak IP adresi.

• Key: Paketteki nesnenin URL kodlamalı adı.

• VersionId: Nesnenin sürüm kimliği. Bu alan yalnızca yapılandırılan envanter kuralı tüm sürümleri dışa aktardığında görünür.

  • Envanter kuralının yapılandırıldığı pakette sürüm oluşturma etkin değilse bu alan boş olur.

  • Envanter kuralının yapılandırıldığı pakette sürüm oluşturma etkinse bu alan nesnenin VersionId değerini gösterir.

• IsDeleteMarker: Nesne sürümünün bir silme işaretçisi olup olmadığını belirtir. Bu alan yalnızca yapılandırılan envanter kuralı tüm sürümleri dışa aktardığında görünür.

  • Envanter kuralının yapılandırıldığı pakette sürüm oluşturma etkin değilse bu alan varsayılan olarak false değerini alır.

  • Envanter kuralının yapılandırıldığı pakette sürüm oluşturma etkinse nesne bir silme işaretçisi olduğunda bu alan true, silme işaretçisi olmadığında false olur.

• Size: Nesnenin boyutu.

• StorageClass: Nesnenin depolama sınıfı.

• LastModifiedDate: Nesnenin son değiştirilme tarihi.

• ETag: Nesnenin ETag değeri. ETag, nesne oluşturulduğunda oluşturulur ve nesnenin içeriğini tanımlar.

  • PutObject işlemi kullanılarak oluşturulan bir nesne için ETag, içeriğinin MD5 karmasıdır.

  • Diğer yöntemler kullanılarak oluşturulan bir nesne için ETag, belirli hesaplama kurallarına göre oluşturulan benzersiz bir değerdir ve içeriğinin MD5 karması değildir.

• IsMultipartUploaded: Nesnenin çok parçalı yükleme kullanılarak yüklenip yüklenmediğini belirtir.

• ObjectType: Nesnenin türü.

• ObjectAcl: Nesnenin erişim kontrol listesi.

• Crc64: Nesnenin CRC-64 değeri.

• EncryptionStatus: Nesnenin şifrelenip şifrelenmediğini belirtir.

Örnekler

• Örnek istek

GET /?inventory&inventoryId=report1 HTTP/1.1

• Örnek yanıt

HTTP/1.1 200 OK
  x-oss-request-id: 56594298207FB304438516F9
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Server: AliyunOSS
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
  <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::bucket_0001</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-OSS/>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <Filter>
       <Prefix>myprefix/</Prefix>
     </Filter>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>ETag</Field>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>

SDK'ler

Aşağıdaki SDK'ler bu işlemi destekler:

• Java

• Python V2

• Go V2

• Node.js

• C++

• .NET

ossutil CLI

GetBucketInventory işlemine karşılık gelen ossutil komutu için bkz. get-bucket-inventory.