Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:ListBucketInventory

    Belge Merkezi

    Object Storage Service:ListBucketInventory

    Son Güncelleme:Oct 01, 2026

    ListBucketInventory, bir paket için tüm envanter yapılandırmalarını listeler.

    Kullanım notları

    ListBucketInventory işlemi çağrıldığında oss:GetBucketInventory izni gerekir. Daha fazla bilgi için bkz. RAM kullanıcıya özel izin ilkeleri atama.

    Not

    • Tek bir istekle en fazla 100 envanter yapılandırması alınabilir. Yanıt kesilmişse, sonraki sonuç sayfasını almak için yanıtta dönen NextContinuationToken değerini sonraki isteğinizde continuation-token parametresi olarak kullanın.

    • Paketin envanter yapılandırmalarını yönetme iznine sahip olduğunuzdan emin olun. Varsayılan olarak bu izne yalnızca paket sahibi sahiptir. Paket sahibi değilseniz gerekli izni isteyin.

    İstek sözdizimi

    • continuation-token ile

      GET /?inventory&continuation-token=xxx HTTP/1.1

    • continuation-token olmadan

      GET /?inventory HTTP/1.1

    Yanıt öğeleri

    Parametre

    Tür

    Açıklama

    InventoryConfiguration

    konteyner

    Envanter yapılandırma parametreleri için bir kapsayıcı.

    IsTruncated

    Boolean

    Envanter yapılandırmaları listesinin kesilip kesilmediğini belirtir.

    Geçerli değerler: true veya false

    • false ise pakete ait tüm envanter yapılandırmaları listelenir.

    • true ise liste kesilmiş demektir. Sonraki sonuç sayfasını almak için NextContinuationToken kullanın.

    NextContinuationToken

    String

    Yanıt kesildiyse (IsTruncated true), sonraki sonuç sayfasını almak için bu belirteci sonraki isteğinizin continuation-token parametresinde kullanın.

    Id

    String

    Envanter yapılandırması için kullanıcı tarafından belirtilen ad. Ad, paket içinde benzersiz olmalıdır.

    IsEnabled

    Boolean

    Envanterin etkin olup olmadığını belirtir.

    Geçerli değerler: true veya false

    • true ise envanter etkindir.

    • false ise envanter oluşturulmaz.

    Filter

    konteyner

    Filtre kuralları için bir kapsayıcı. Envanter yalnızca filtreye uyan nesneleri içerir.

    Prefix

    String

    Filtreleme için kullanılacak nesne ön eki.

    Üst düğüm: Filter

    Destination

    konteyner

    Envanter sonuçlarının yayımlanacağı konum hakkındaki bilgiler için bir kapsayıcı.

    OSSBucketDestination

    konteyner

    Envanter raporunun depolandığı hedef paketle ilgili ayrıntıları içerir.

    Üst düğüm: Destination

    Format

    String

    Dışa aktarılan envanterin dosya biçimi.

    Geçerli değerler: CSV, Parquet (Parquet biçimi şu anda yalnızca Birleşik Krallık (Londra) bölgesinde desteklenmektedir.)

    Üst düğüm: OSSBucketDestination

    AccountId

    String

    Envanter raporunu hedef pakete yazma izni verilen hesabın ID'si.

    Üst düğüm: OSSBucketDestination

    RoleArn

    String

    Envanter raporunu hedef pakete yazma izni verilen rolün ARN'si.

    Biçim: acs:ram::uid:role/rolename

    Üst düğüm: OSSBucketDestination

    Bucket

    String

    Envanter raporu için hedef paket.

    Üst düğüm: OSSBucketDestination

    Prefix

    String

    Envanter raporunun depolandığı hedef paketteki ön ek.

    Üst düğüm: OSSBucketDestination

    Encryption

    konteyner

    Envanter raporu için sunucu tarafı şifreleme yöntemi.

    Geçerli değerler: SSE-OSS, SSE-KMS veya Null

    Üst düğüm: OSSBucketDestination

    SSE-OSS

    konteyner

    SSE-OSS şifrelemesi için bir kapsayıcı.

    Üst düğüm: Encryption

    SSE-KMS

    konteyner

    SSE-KMS şifrelemesinde kullanılan anahtar için bir kapsayıcı.

    Üst düğüm: Encryption

    KeyId

    String

    KMS anahtar ID'si.

    Üst düğüm: SSE-KMS

    Schedule

    konteyner

    Envanter dışa aktarma zamanlaması için bir kapsayıcı.

    Frequency

    String

    Envanterin dışa aktarma sıklığı.

    Geçerli değerler: Daily, Weekly, Monthly veya Once

    Üst düğüm: Schedule

    DayOfMonth

    Integer

    Frequency değeri Monthly olarak ayarlandığında envanterin dışa aktarılacağı ayın günü. Geçerli değerler: 1 ila 31.

    Üst düğüm: Schedule

    AutoDelete

    Boolean

    Tek seferlik bir envanter dışa aktarıldıktan sonra envanter yapılandırmasının otomatik olarak silinip silinmeyeceğini belirtir. Bu öğe yalnızca Frequency değeri Once olarak ayarlandığında geçerlidir.

    Geçerli değerler: true, false

    Üst düğüm: Schedule

    IncludedObjectVersions

    String

    Envantere hangi nesne sürümlerinin dahil edileceğini belirtir.

    Geçerli değerler: All veya Current

    • Değer All ise nesnelerin tüm sürümleri dışa aktarılır.

    • Değer Current ise yalnızca nesnelerin mevcut sürümleri dışa aktarılır.

    OptionalFields

    konteyner

    Envantere dahil edilecek isteğe bağlı alanlar için bir kapsayıcı.

    Field

    konteyner

    Envantere dahil edilecek isteğe bağlı alanlar.

    İsteğe bağlı alanlar şunlardır: Size, LastModifiedDate, TransitionTime, ETag, StorageClass, IsMultipartUploaded, EncryptionStatus, ObjectAcl, TaggingCount, ObjectType ve Crc64

    Üst düğüm: OptionalFields

    IncrementalInventory

    konteyner

    Artımlı envanter yapılandırması için bir kapsayıcı.

    IsEnabled

    Boolean

    Artımlı envanterin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    Geçerli değerler:

    • true: etkin

    • false: devre dışı

    true ise üst düzey IsEnabled false olsa bile artımlı envanter etkinleştirilir.

    Üst düğüm: IncrementalInventory

    Schedule

    konteyner

    Artımlı envanter dışa aktarma zamanlaması için bir kapsayıcı.

    Üst düğüm: IncrementalInventory

    Frequency

    Integer

    Artımlı envanterin dışa aktarma sıklığı (saniye cinsinden).

    Sistem, artımlı envanterleri sabit 600 saniyelik aralıklarla dışa aktarır. Her aralıkta sistem otomatik olarak bir dizin ön eki oluşturur ve bir manifest dosyası ile birden çok CSV dosyası üretir. Özel sıklıklar desteklenmez.

    Üst düğüm: Schedule

    OptionalFields

    konteyner

    Artımlı envantere dahil edilecek isteğe bağlı alanlar için bir kapsayıcı.

    Üst düğüm: IncrementalInventory

    Field

    String

    Artımlı envantere dahil edilen alanlar.

    Üst düğüm: OptionalFields

    • SequenceNumber: Sıra numarası. Her kaydın benzersiz bir sıra numarası vardır. Aynı paketteki aynı nesneye ait kayıtlar SequenceNumber'a göre sıralanabilir. Sıralanan kayıtlar genellikle kronolojik bir düzeni takip eder.

    • RecordType: Olay türü. Geçerli değerler: CREATE, UPDATE_METADATA ve DELETE.

      • CREATE: Belirtilen ön eke sahip nesneler için gerçekleşen PutObject, PostObject, AppendObject, çok parçalı yükleme ve CopyObject gibi tüm yükleme işlemleri.

      • UPDATE_METADATA: Belirtilen ön eke sahip nesneler için yapılan tüm meta veri güncellemeleri bu olay türü olarak kaydedilir.

      • DELETE: Belirtilen ön eke sahip nesneler için DeleteObject, DeleteMultipleObjects, sürüm oluşturma etkinleştirildikten sonra silme işaretçisi oluşturma ve yaşam döngüsü tabanlı silmeler gibi tüm silme işlemleri. Silmeler; silme işaretçisi oluşturmayı ve kalıcı silmeleri içerir. Kalıcı silmeler için yalnızca Bucket, Key, SequenceNumber, RecordType, RecordTimestamp ve VersionId temel alanları korunur. Diğer sütunlar boş (null) olur.

    • RecordTimestamp: Olayın UTC zaman damgası. Örnek: "2024-08-25 18:08:01.024". Zaman damgası milisaniye hassasiyetindedir.

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

    • RequestId: İsteğin benzersiz ID'si.

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

    • Key: Paketteki nesnenin adı. Anahtar URL kodlamalıdır.

    • VersionId: Nesnenin sürüm ID'si. Bu alan yalnızca envanter yapılandırması tüm sürümleri içerecek şekilde ayarlandığında görünür.

      • Paket için sürüm oluşturma etkin değilse bu alan boştur.

      • Paket için sürüm oluşturma etkinse bu alan nesnenin sürüm ID'sini gösterir.

    • IsDeleteMarker: Nesne sürümünün bir silme işaretçisi olup olmadığını belirtir. Bu alan yalnızca envanter yapılandırması tüm sürümleri içerecek şekilde ayarlandığında görünür.

      • Paket için sürüm oluşturma etkin değilse bu alan varsayılan olarak false değerini alır.

      • Paket için sürüm oluşturma etkinse ve nesne sürümü bir silme işaretçisiyse bu alan true olur. Aksi takdirde false olur.

    • Size: Nesnenin boyutu.

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

    • LastModifiedDate: Nesnenin son değiştirilme zamanı.

    • ETag: Bir nesne oluşturulduğunda içeriğini tanımlamak için bir ETag üretilir.

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

      • Diğer yöntemlerle oluşturulan bir nesne için ETag, belirli kurallara göre hesaplanan benzersiz bir değerdir ancak 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 (ACL).

    • Crc64: Nesnenin CRC-64 değeri.

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

    Örnekler

    • Örnek istek

        GET /?inventory HTTP/1.1
  Host: BucketName.oss.aliyuncs.com
  Date: Fri, 24 Feb 2012 03:55:00 GMT
  Authorization: authorization string
  Content-Type: text/plain

    • Örnek yanıt

        HTTP/1.1 200 OK
  x-oss-request-id: 56594298207FB304438516F9
  Date: Sat, 30 Apr 2016 23:29:37 GMT
  Content-Type: application/xml
  Content-Length: length
  Connection: close
  Server: AliyunOSS

  <?xml version="1.0" encoding="UTF-8"?>
  <ListInventoryConfigurationsResult>
     <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:::destination-bucket</Bucket>
              <Prefix>prefix1</Prefix>
           </OSSBucketDestination>
        </Destination>
        <Schedule>
           <Frequency>Daily</Frequency>
        </Schedule>
        <Filter>
           <Prefix>prefix/One</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>
     <InventoryConfiguration>
        <Id>report2</Id>
        <IsEnabled>true</IsEnabled>
        <Destination>
           <OSSBucketDestination>
              <Format>CSV</Format>
              <AccountId>1000000000000000</AccountId>
              <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
              <Bucket>acs:oss:::destination-bucket</Bucket>
              <Prefix>prefix2</Prefix>
           </OSSBucketDestination>
        </Destination>
        <Schedule>
           <Frequency>Daily</Frequency>
        </Schedule>
        <Filter>
           <Prefix>prefix/Two</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>
     <InventoryConfiguration>
        <Id>report3</Id>
        <IsEnabled>true</IsEnabled>
        <Destination>
           <OSSBucketDestination>
              <Format>CSV</Format>
              <AccountId>1000000000000000</AccountId>
              <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
              <Bucket>acs:oss:::destination-bucket</Bucket>
              <Prefix>prefix3</Prefix>
           </OSSBucketDestination>
        </Destination>
        <Schedule>
           <Frequency>Daily</Frequency>
        </Schedule>
        <Filter>
           <Prefix>prefix/Three</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>
      ...
     <IsTruncated>true</IsTruncated>
     <NextContinuationToken>...</NextContinuationToken> 
  </ListInventoryConfigurationsResult>

    SDK'lar

    Bu işlemi aşağıdaki SDK'ları kullanarak çağırabilirsiniz:

    Ossutil CLI

    Bu işlemi ossutil kullanarak gerçekleştirmek için list-bucket-inventory komutuna bakın.