All Products
Search

This Product

    Object Storage Service:ListBucketInventory

    Document Center

    Object Storage Service:ListBucketInventory

    Last Updated:Sep 10, 2026

    ListBucketInventory mencantumkan semua konfigurasi inventory untuk sebuah bucket.

    Catatan penggunaan

    Pemanggilan operasi ListBucketInventory memerlukan izin oss:GetBucketInventory. Untuk informasi selengkapnya, lihat Berikan kebijakan izin kustom kepada 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 untuk bucket tersebut. Secara default, hanya pemilik bucket yang memiliki izin ini. Jika Anda bukan pemiliknya, mintalah izin yang diperlukan.

    Sintaksis permintaan

    • Dengan continuation-token 

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

    • Tanpa continuation-token 

      GET /?inventory HTTP/1.1

    Elemen respons

    Parameter

    Tipe

    Deskripsi

    InventoryConfiguration

    container

    Kontainer untuk parameter konfigurasi inventory.

    IsTruncated

    Boolean

    Menunjukkan apakah daftar konfigurasi inventory terpotong.

    Nilai yang valid: true atau false

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

    • 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 yang valid: true atau false

    • Jika true, inventory diaktifkan.

    • Jika false, tidak ada inventory yang dihasilkan.

    Filter

    container

    Kontainer untuk aturan filter. Inventory hanya mencakup objek yang sesuai dengan filter.

    Prefix

    String

    Awalan objek yang digunakan untuk filtering.

    Node induk: Filter

    Destination

    container

    Kontainer untuk informasi tentang tempat publikasi hasil inventory.

    OSSBucketDestination

    container

    Berisi detail tentang bucket tujuan tempat laporan inventory disimpan.

    Node induk: Destination

    Format

    String

    Format file inventory yang diekspor.

    Nilai yang valid: CSV, Parquet (format Parquet saat ini hanya didukung di wilayah UK (London).)

    Node induk: OSSBucketDestination

    AccountId

    String

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

    Node induk: OSSBucketDestination

    RoleArn

    String

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

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

    Node induk: OSSBucketDestination

    Bucket

    String

    Bucket tujuan untuk laporan inventory.

    Node induk: OSSBucketDestination

    Prefix

    String

    Awalan dalam bucket tujuan tempat laporan inventory disimpan.

    Node induk: OSSBucketDestination

    Encryption

    container

    Metode enkripsi sisi server untuk laporan inventory.

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

    Node induk: OSSBucketDestination

    SSE-OSS

    container

    Kontainer untuk enkripsi SSE-OSS.

    Node induk: Encryption

    SSE-KMS

    container

    Kontainer untuk kunci yang digunakan untuk enkripsi SSE-KMS.

    Node induk: Encryption

    KeyId

    String

    ID kunci KMS.

    Node induk: SSE-KMS

    Schedule

    container

    Kontainer untuk jadwal ekspor inventory.

    Frequency

    String

    Frekuensi ekspor inventory.

    Nilai yang valid: Daily, Weekly, Monthly, atau Once

    Node induk: Schedule

    DayOfMonth

    Integer

    Hari dalam bulan untuk mengekspor inventory ketika Frequency diatur ke Monthly. Nilai yang valid: 1 hingga 31.

    Node induk: Schedule

    AutoDelete

    Boolean

    Menentukan apakah akan menghapus konfigurasi inventory secara otomatis setelah mengekspor inventory satu kali. Elemen ini hanya berlaku ketika Frequency diatur ke Once.

    Nilai yang valid: true, false

    Node induk: Schedule

    IncludedObjectVersions

    String

    Menentukan versi objek mana yang disertakan dalam inventory.

    Nilai yang valid: All atau Current

    • Jika nilainya All, semua versi objek diekspor.

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

    OptionalFields

    container

    Kontainer untuk bidang opsional yang disertakan dalam inventory.

    Field

    container

    Bidang opsional yang disertakan dalam inventory.

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

    Node induk: OptionalFields

    IncrementalInventory

    container

    Kontainer untuk konfigurasi inventory inkremental.

    IsEnabled

    Boolean

    Menunjukkan apakah inventory inkremental diaktifkan.

    Nilai yang valid:

    • true: diaktifkan

    • false: dinonaktifkan

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

    Node induk: IncrementalInventory

    Schedule

    container

    Kontainer untuk jadwal ekspor inventory inkremental.

    Node induk: 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.

    Node induk: Schedule

    OptionalFields

    container

    Kontainer untuk bidang opsional yang disertakan dalam inventory inkremental.

    Node induk: IncrementalInventory

    Field

    String

    Bidang yang disertakan dalam inventory inkremental.

    Node induk: 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 yang valid: CREATE, UPDATE_METADATA, dan DELETE.

      • CREATE: Semua operasi unggah, seperti PutObject, PostObject, AppendObject, unggah multi-bagian, dan CopyObject, yang terjadi pada 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 bidang 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 pihak yang berwenang dari pemohon.

    • RequestId: ID unik dari permintaan tersebut.

    • SourceIp: Alamat IP sumber dari pemohon.

    • Key: Nama objek dalam bucket. Key tersebut dikodekan URL.

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

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

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

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

      • Jika Pengendalian versi tidak diaktifkan untuk bucket, bidang ini bernilai default false.

      • Jika Pengendalian versi diaktifkan dan versi objek adalah penanda hapus, bidang 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.

    Contoh

    • Permintaan contoh

        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

    • Respons contoh

        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

    Anda dapat memanggil operasi ini menggunakan SDK berikut:

    Ossutil CLI

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