All Products
Search

This Product

    Object Storage Service:GetBucketInventory

    Document Center

    Object Storage Service:GetBucketInventory

    Last Updated:Jun 12, 2026

    Operasi GetBucketInventory mengembalikan konfigurasi inventaris tertentu untuk sebuah bucket.

    Catatan penggunaan

    Secara default, pemilik Akun Alibaba Cloud dapat mengambil konfigurasi inventaris. Untuk melakukan operasi ini sebagai RAM user atau menggunakan token STS, Anda harus memiliki izin oss:GetBucketInventory.

    Sintaksis permintaan

    GET /?inventory&inventoryId=inventoryId HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Wajib

    Deskripsi

    inventoryId

    string

    Ya

    ID konfigurasi inventaris yang akan dikueri.

    Elemen respons

    Parameter

    Tipe

    Deskripsi

    Id

    string

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

    IsEnabled

    boolean

    Menunjukkan apakah inventaris diaktifkan.

    Nilai valid: true, false

    • true: Inventaris dihasilkan.

    • false: Tidak ada inventaris yang dihasilkan.

    Filter

    container

    Kontainer untuk awalan yang digunakan untuk memfilter objek. Hanya objek yang namanya sesuai dengan awalan yang ditentukan yang dimasukkan ke dalam inventaris.

    Prefix

    string

    Awalan yang digunakan untuk memfilter objek.

    Ancestor: Filter

    Destination

    container

    Kontainer untuk informasi tentang tempat penerbitan hasil inventaris.

    OSSBucketDestination

    container

    Kontainer untuk bucket OSS tempat hasil inventaris disimpan.

    Ancestor: Destination

    Format

    string

    Format file inventaris.

    Nilai valid: CSV

    Ancestor: OSSBucketDestination

    AccountId

    string

    ID Akun Alibaba Cloud yang memiliki bucket tujuan.

    Ancestor: OSSBucketDestination

    RoleArn

    string

    Nama Sumber Daya Alibaba Cloud (ARN) dari peran RAM yang diasumsikan oleh OSS untuk menulis ke bucket tujuan.

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

    Ancestor: OSSBucketDestination

    Bucket

    string

    Bucket tujuan tempat file inventaris disimpan.

    Ancestor: OSSBucketDestination

    Prefix

    string

    Awalan yang digunakan untuk path file inventaris.

    Ancestor: OSSBucketDestination

    Encryption

    container

    Kontainer untuk konfigurasi enkripsi sisi server untuk file inventaris.

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

    Ancestor: OSSBucketDestination

    SSE-OSS

    container

    Kontainer untuk konfigurasi enkripsi sisi server yang menggunakan kunci yang dikelola OSS (SSE-OSS).

    Ancestor: Encryption

    SSE-KMS

    container

    Kontainer untuk konfigurasi enkripsi sisi server yang menggunakan kunci yang dikelola KMS (SSE-KMS).

    Ancestor: Encryption

    KeyId

    string

    ID kunci utama KMS.

    Ancestor: SSE-KMS

    Schedule

    container

    Kontainer untuk jadwal pembuatan inventaris.

    Frequency

    string

    Menentukan seberapa sering inventaris dihasilkan.

    Nilai valid: Daily, Weekly, Monthly, Once

    Ancestor: Schedule

    DayOfMonth

    bilangan bulat positif

    Hari dalam bulan untuk menghasilkan inventaris ketika Frequency diatur ke Monthly. Nilai valid adalah bilangan bulat positif dari 1 hingga 31.

    Ancestor: Schedule

    AutoDelete

    boolean

    Menunjukkan apakah konfigurasi inventaris secara otomatis dihapus setelah dijalankan sekali. Parameter ini hanya berlaku ketika Frequency diatur ke Once.

    Nilai valid: true, false

    Ancestor: Schedule

    IncludedObjectVersions

    string

    Menentukan versi objek mana yang dimasukkan ke dalam inventaris.

    Nilai yang valid: Semua, Saat Ini

    • All: Memasukkan semua versi objek.

    • Current: Hanya memasukkan versi terkini objek.

    OptionalFields

    container

    Kontainer untuk bidang opsional yang dimasukkan ke dalam inventaris.

    Field

    string

    Bidang opsional yang dimasukkan ke dalam inventaris.

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

    Ancestor: OptionalFields

    IncrementalInventory

    container

    Kontainer untuk konfigurasi inventaris inkremental.

    IsEnabled

    boolean

    Menunjukkan apakah inventaris inkremental diaktifkan.

    Nilai valid:

    • true: Mengaktifkan inventaris inkremental.

    • false: Menonaktifkan inventaris inkremental.

    Jika parameter ini diatur ke true, inventaris inkremental diaktifkan meskipun parameter IsEnabled induk bernilai false.

    Ancestor: IncrementalInventory

    Schedule

    container

    Kontainer untuk jadwal pembuatan inventaris inkremental.

    Ancestor: IncrementalInventory

    Frequency

    bilangan bulat positif

    Frekuensi, dalam detik, untuk menghasilkan inventaris inkremental.

    Sistem saat ini menggunakan periode tetap 600 detik. Selama setiap periode, sistem secara otomatis membuat awalan direktori dan menghasilkan file manifest serta beberapa file CSV untuk periode tersebut. Pengaturan frekuensi kustom tidak didukung.

    Ancestor: Schedule

    OptionalFields

    container

    Kontainer untuk bidang opsional yang dimasukkan ke dalam inventaris inkremental.

    Ancestor: IncrementalInventory

    Field

    string

    Bidang opsional yang dimasukkan ke dalam inventaris inkremental.

    Ancestor: OptionalFields

    • SequenceNumber: Nomor urut. Ini merupakan pengidentifikasi unik untuk setiap catatan. Catatan yang termasuk dalam bucket dan objek yang sama dapat diurutkan berdasarkan SequenceNumber, yang biasanya menempatkannya dalam urutan kronologis.

    • RecordType: Jenis catatan: CREATE, UPDATE_METADATA, DELETE

      • CREATE: Memasukkan semua operasi unggah di bawah awalan yang dipilih, seperti PutObject, PostObject, AppendObject, MultipartUpload, dan CopyObject.

      • UPDATE_METADATA: Memasukkan semua pembaruan metadata untuk objek di bawah awalan yang dipilih.

      • DELETE: Memasukkan semua operasi penghapusan untuk objek di bawah awalan yang dipilih, seperti DeleteObject, DeleteMultipleObjects, pembuatan penanda hapus ketika versioning diaktifkan, dan penghapusan berbasis lifecycle. Penghapusan dapat berupa pembuatan penanda hapus atau penghapusan permanen objek. Untuk penghapusan permanen, catatan hanya menyimpan bidang inti berikut: Bucket, Key, SequenceNumber, RecordType, RecordTimestamp, dan VersionId. Semua kolom lainnya bernilai null.

    • RecordTimestamp: Timestamp dalam Greenwich Mean Time dan akurat hingga milidetik. Contoh: "2024-08-25 18:08:01.024".

    • Requester: ID Alibaba Cloud atau Principal ID dari pemohon.

    • RequestId: Pengidentifikasi unik untuk permintaan.

    • SourceIp: Alamat IP sumber dari pemohon.

    • Key: Nama objek dalam bucket, yang dikodekan URL.

    • VersionId: ID versi Objek. Bidang ini hanya dimasukkan jika aturan inventaris dikonfigurasi untuk mengekspor semua versi.

      • Jika versioning tidak diaktifkan pada bucket, bidang ini kosong.

      • Jika versioning diaktifkan pada bucket, bidang ini berisi ID versi objek.

    • IsDeleteMarker: Menentukan apakah versi objek merupakan penanda hapus. Bidang ini hanya dimasukkan ketika aturan inventaris dikonfigurasi untuk mengekspor semua versi.

      • Jika versioning tidak diaktifkan pada bucket, bidang ini secara default bernilai false.

      • Jika versioning diaktifkan pada bucket, bidang ini bernilai true untuk penanda hapus dan false untuk selain itu.

    • Size: Ukuran Objek.

    • StorageClass: Kelas penyimpanan objek.

    • LastModifiedDate: Waktu terakhir objek dimodifikasi.

    • ETag: ETag objek. ETag dihasilkan saat objek dibuat untuk mengidentifikasi konten objek.

      • Untuk objek yang dibuat menggunakan operasi PutObject, ETag adalah hash MD5 dari konten objek.

      • Untuk objek yang dibuat menggunakan metode lain, ETag adalah nilai unik yang dihasilkan berdasarkan aturan tertentu dan bukan hash MD5 dari konten objek.

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

    • ObjectType: Jenis objek.

    • ObjectAcl: Izin baca dan tulis Objek.

    • Crc64: CRC64 Objek.

    • EncryptionStatus: Menunjukkan apakah Objek dienkripsi.

    Contoh

    • Contoh permintaan 

      GET /?inventory&inventoryId=list1 HTTP/1.1

    • Contoh respons 

        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

    Operasi ini tersedia di SDK berikut:

    CLI ossutil

    Untuk informasi tentang perintah ossutil yang sesuai, lihat get-bucket-inventory.