All Products
Search
Document Center

Object Storage Service:ListBucketInventory

Last Updated:Jun 12, 2026

ListBucketInventory menampilkan semua konfigurasi inventory untuk suatu bucket.

Usage notes

Operasi ListBucketInventory memerlukan izin oss:GetBucketInventory. Untuk informasi selengkapnya, lihat Grant custom permission policies to a RAM user.

Catatan
  • Satu permintaan dapat mengambil maksimal 100 konfigurasi inventory. Jika respons terpotong, gunakan nilai NextContinuationToken dari respons sebagai continuation-token pada permintaan berikutnya untuk mengambil halaman hasil berikutnya.

  • Pastikan Anda memiliki izin untuk mengelola konfigurasi inventory bucket tersebut. Secara default, hanya pemilik bucket yang memiliki izin ini. Jika Anda bukan pemiliknya, mintalah izin yang diperlukan.

Request syntax

  • Dengan continuation-token

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

    GET /?inventory HTTP/1.1

Response elements

Parameter

Type

Description

InventoryConfiguration

container

A container for inventory configuration parameters.

IsTruncated

Boolean

Menunjukkan apakah daftar konfigurasi inventory terpotong.

Nilai valid: true atau false

  • Jika false, semua konfigurasi inventory untuk bucket tersebut ditampilkan.

  • Jika true, daftar terpotong. Gunakan NextContinuationToken untuk mengambil halaman hasil berikutnya.

NextContinuationToken

String

Jika respons terpotong (IsTruncated bernilai true), gunakan token ini sebagai parameter continuation-token pada permintaan berikutnya untuk mendapatkan halaman hasil berikutnya.

Id

String

Nama yang ditentukan pengguna untuk konfigurasi inventory. Nama tersebut harus unik dalam bucket.

IsEnabled

Boolean

Menentukan apakah inventory diaktifkan.

Nilai valid: true atau false

  • Jika true, inventory diaktifkan.

  • Jika false, tidak ada inventory yang dihasilkan.

Filter

container

A container for the filter rules. Inventory hanya mencakup objek yang sesuai dengan filter.

Prefix

String

Awalan objek yang digunakan untuk filtering.

Parent node: Filter

Destination

container

A container for information about where to publish the inventory results.

OSSBucketDestination

container

Berisi detail tentang bucket tujuan tempat laporan inventory disimpan.

Parent node: Destination

Format

String

Format file dari inventory yang diekspor.

Nilai valid: CSV

Parent node: OSSBucketDestination

AccountId

String

ID akun yang diberikan izin untuk menulis laporan inventory ke bucket tujuan.

Parent node: OSSBucketDestination

RoleArn

String

ARN dari role yang diberikan izin untuk menulis laporan inventory ke bucket tujuan.

Format: acs:ram::uid:role/rolename

Parent node: OSSBucketDestination

Bucket

String

Bucket tujuan untuk laporan inventory.

Parent node: OSSBucketDestination

Prefix

String

Awalan dalam bucket tujuan tempat laporan inventory disimpan.

Parent node: OSSBucketDestination

Encryption

container

Metode enkripsi sisi server untuk laporan inventory.

Nilai valid: SSE-OSS, SSE-KMS, atau Null

Parent node: OSSBucketDestination

SSE-OSS

container

A container for SSE-OSS encryption.

Parent node: Encryption

SSE-KMS

container

A container for the key used for SSE-KMS encryption.

Parent node: Encryption

KeyId

String

ID kunci KMS.

Parent node: SSE-KMS

Schedule

container

A container for the inventory export schedule.

Frequency

String

Frekuensi ekspor inventory.

Nilai valid: Daily, Weekly, Monthly, atau Once

Parent node: Schedule

DayOfMonth

Integer

Hari dalam bulan ketika inventory diekspor jika Frequency diatur ke Monthly. Nilai valid: 1 hingga 31.

Parent node: Schedule

AutoDelete

Boolean

Menentukan apakah konfigurasi inventory dihapus secara otomatis setelah mengekspor inventory satu kali. Elemen ini hanya berlaku jika Frequency diatur ke Once.

Nilai valid: true, false

Parent node: Schedule

IncludedObjectVersions

String

Menentukan versi objek mana yang dimasukkan dalam inventory.

Nilai valid: All atau Current

  • Jika nilainya All, semua versi objek diekspor.

  • Jika nilainya Current, hanya versi terkini objek yang diekspor.

OptionalFields

container

A container for the optional fields to include in the inventory.

Field

container

Field opsional yang dimasukkan dalam inventory.

Field opsional meliputi: Size, LastModifiedDate, TransitionTime, ETag, StorageClass, IsMultipartUploaded, EncryptionStatus, ObjectAcl, TaggingCount, ObjectType, dan Crc64

Parent node: OptionalFields

IncrementalInventory

container

A container for the incremental inventory configuration.

IsEnabled

Boolean

Menunjukkan apakah inventory inkremental diaktifkan.

Nilai valid:

  • true: diaktifkan

  • false: dinonaktifkan

Jika true, inventory inkremental diaktifkan meskipun IsEnabled induk bernilai false.

Parent node: IncrementalInventory

Schedule

container

A container for the incremental inventory export schedule.

Parent node: IncrementalInventory

Frequency

Integer

Frekuensi ekspor inventory inkremental, dalam detik.

Sistem mengekspor inventory inkremental pada interval tetap 600 detik. Pada setiap interval, sistem secara otomatis membuat awalan direktori dan menghasilkan file manifest serta beberapa file CSV. Frekuensi kustom tidak didukung.

Parent node: Schedule

OptionalFields

container

A container for the optional fields to include in the incremental inventory.

Parent node: IncrementalInventory

Field

String

Field yang dimasukkan dalam inventory inkremental.

Parent node: OptionalFields

  • SequenceNumber: Nomor urut. Setiap catatan memiliki nomor urut unik. Catatan untuk objek yang sama dalam bucket yang sama dapat diurutkan berdasarkan SequenceNumber. Catatan yang diurutkan biasanya mengikuti urutan kronologis.

  • RecordType: Jenis event. Nilai valid: CREATE, UPDATE_METADATA, dan DELETE.

    • CREATE: Semua operasi unggah, seperti PutObject, PostObject, AppendObject, unggah multi-bagian, dan CopyObject, yang terjadi untuk objek dengan awalan tertentu.

    • UPDATE_METADATA: Semua pembaruan metadata untuk objek dengan awalan tertentu dicatat sebagai jenis event ini.

    • DELETE: Semua operasi penghapusan untuk objek dengan awalan tertentu, seperti DeleteObject, DeleteMultipleObjects, pembuatan penanda hapus setelah Pengendalian versi diaktifkan, dan penghapusan berbasis siklus hidup. Penghapusan mencakup pembuatan penanda hapus dan penghapusan permanen. Untuk penghapusan permanen, hanya field inti Bucket, Key, SequenceNumber, RecordType, RecordTimestamp, dan VersionId yang dipertahankan. Kolom lainnya kosong (null).

  • RecordTimestamp: Timestamp UTC dari event tersebut. Contoh: "2024-08-25 18:08:01.024". Timestamp akurat hingga milidetik.

  • Requester: ID Alibaba Cloud atau ID principal dari pihak yang meminta.

  • RequestId: ID unik dari permintaan tersebut.

  • SourceIp: Alamat IP sumber dari pihak yang meminta.

  • Key: Nama objek dalam bucket. Key tersebut di-encode dalam URL.

  • VersionId: ID versi objek. Field ini muncul hanya jika konfigurasi inventory diatur untuk menyertakan semua versi.

    • Jika Pengendalian versi tidak diaktifkan untuk bucket, field ini kosong.

    • Jika Pengendalian versi diaktifkan untuk bucket, field ini menampilkan ID versi objek.

  • IsDeleteMarker: Menunjukkan apakah versi objek tersebut merupakan penanda hapus. Field ini muncul hanya jika konfigurasi inventory diatur untuk menyertakan semua versi.

    • Jika Pengendalian versi tidak diaktifkan untuk bucket, field ini default ke false.

    • Jika Pengendalian versi diaktifkan dan versi objek tersebut adalah penanda hapus, field ini bernilai true. Jika tidak, bernilai false.

  • Size: Ukuran objek.

  • StorageClass: Kelas penyimpanan objek.

  • LastModifiedDate: Waktu terakhir objek dimodifikasi.

  • ETag: Saat objek dibuat, ETag dihasilkan untuk mengidentifikasi kontennya.

    • Untuk objek yang dibuat dengan memanggil operasi PutObject, ETag adalah Hash MD5 dari kontennya.

    • Untuk objek yang dibuat dengan metode lain, ETag adalah nilai unik yang dihitung berdasarkan aturan tertentu, tetapi bukan Hash MD5 dari kontennya.

  • IsMultipartUploaded: Menunjukkan apakah objek diunggah menggunakan unggah multi-bagian.

  • ObjectType: Jenis objek.

  • ObjectAcl: Daftar kontrol akses (ACL) objek.

  • Crc64: Nilai CRC-64 objek.

  • EncryptionStatus: Menunjukkan apakah objek dienkripsi.

Examples

  • Contoh permintaan

      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
  • Contoh respons

      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>

SDKs

Anda dapat memanggil operasi ini menggunakan SDK berikut:

Ossutil CLI

Untuk menjalankan operasi ini menggunakan ossutil, lihat perintah list-bucket-inventory.