全部产品
Search

搜索本产品

    Object Storage Service：GetBucketInventory

    文档中心

    Object Storage Service：GetBucketInventory

    更新时间：Feb 08, 2026

    GetBucketInventory mengambil konfigurasi tugas inventaris tertentu untuk sebuah bucket.

    Catatan penggunaan

    Secara default, Akun Alibaba Cloud memiliki izin untuk mengambil konfigurasi tugas inventaris bucket. Jika Anda menggunakan RAM user atau Security Token Service (STS), Anda harus memiliki izin oss:GetBucketInventory.

    Sintaksis permintaan

    GET /?inventory&inventoryId=inventoryId HTTP/1.1

    Parameter permintaan

    Name

    Type

    Required

    Description

    inventoryId

    String

    Yes

    ID tugas inventaris yang akan dikueri.

    Parameter respons

    Name

    Type

    Description

    Id

    String

    Nama inventaris yang Anda tentukan. Nama tersebut harus unik secara global dalam bucket.

    IsEnabled

    Boolean

    Menunjukkan apakah fitur inventaris diaktifkan.

    Nilai valid: true dan false

    • Jika diatur ke true, fitur inventaris diaktifkan.

    • Jika diatur ke false, tidak ada daftar inventaris yang dihasilkan.

    Filter

    Container

    Awalan yang digunakan untuk memfilter objek. Hanya objek yang namanya mengandung awalan tertentu yang dimasukkan ke dalam daftar inventaris.

    Prefix

    String

    Awalan yang digunakan dalam aturan filter.

    Parent node: Filter

    Destination

    Container

    Rincian hasil checklist.

    OSSBucketDestination

    Container

    Informasi tentang bucket yang menyimpan daftar inventaris yang diekspor.

    Parent node: Destination

    Format

    String

    Format daftar inventaris yang diekspor.

    Nilai valid: CSV

    Parent node: OSSBucketDestination

    AccountId

    String

    ID akun yang diberikan oleh Pemilik bucket.

    Parent node: OSSBucketDestination

    RoleArn

    String

    Nama role yang diberikan izin oleh Pemilik bucket.

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

    Parent node: OSSBucketDestination

    Bucket

    String

    Bucket yang menyimpan daftar inventaris yang diekspor.

    Parent node: OSSBucketDestination

    Prefix

    String

    Awalan dalam path tempat daftar inventaris yang diekspor disimpan.

    Parent node: OSSBucketDestination

    Encryption

    Container

    Metode enkripsi yang digunakan untuk daftar inventaris yang diekspor.

    Nilai valid: SSE-OSS, SSE-KMS, dan null

    Parent node: OSSBucketDestination

    SSE-OSS

    Container

    Container untuk metode enkripsi SSE-OSS.

    Parent node: Encryption

    SSE-KMS

    Container

    Container yang menyimpan kunci master pelanggan (CMK) yang digunakan dalam metode enkripsi SSE-KMS.

    Parent node: Encryption

    KeyId

    String

    ID kunci yang dikelola oleh Key Management Service (KMS).

    Parent node: SSE-KMS

    Schedule

    Container

    Container yang menyimpan informasi tentang seberapa sering daftar inventaris diekspor.

    Frequency

    String

    Seberapa sering daftar inventaris diekspor.

    Nilai yang valid: Harian dan Mingguan

    Parent node: Schedule

    IncludedObjectVersions

    String

    Menunjukkan apakah informasi versi objek dimasukkan ke dalam daftar inventaris.

    Nilai valid: All dan Current

    • Jika diatur ke All, semua versi objek diekspor.

    • Jika diatur ke Current, hanya versi terkini objek yang diekspor.

    OptionalFields

    Container

    Bidang konfigurasi yang dimasukkan ke dalam daftar inventaris.

    Field

    String

    Bidang konfigurasi yang dimasukkan ke dalam daftar inventaris.

    Nilai valid: Size, LastModifiedDate, TransitionTime, ETag, StorageClass, IsMultipartUploaded, EncryptionStatus, ObjectAcl, TaggingCount, ObjectType, dan CRC64

    Parent node: OptionalFields

    IncrementalInventory

    Container

    Informasi konfigurasi untuk inventaris inkremental.

    IsEnabled

    Boolean

    Menunjukkan apakah inventaris inkremental diaktifkan.

    Nilai valid:

    • true: Aktifkan

    • false: Nonaktifkan

    Jika diatur ke true, fitur inventaris inkremental diaktifkan terlepas dari apakah parameter IsEnabled tingkat atas diatur ke false.

    Parent node: IncrementalInventory

    Schedule

    Container

    Frekuensi ekspor untuk inventaris inkremental.

    Parent node: IncrementalInventory

    Frequency

    Positive integer

    Frekuensi ekspor untuk inventaris inkremental, dalam detik.

    Sistem menggunakan interval tetap 600 detik. Untuk setiap interval, sistem secara otomatis membuat awalan direktori dan menghasilkan file manifest serta beberapa file CSV untuk objek yang dibuat selama interval tersebut. Frekuensi kustom tidak didukung.

    Parent node: Schedule

    OptionalFields

    Container

    Bidang konfigurasi yang dimasukkan ke dalam inventaris inkremental.

    Parent node: IncrementalInventory

    Field

    String

    Bidang konfigurasi yang dimasukkan ke dalam inventaris inkremental.

    Parent node: OptionalFields

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

    • RecordType: Jenis event: CREATE, UPDATE_METADATA, atau DELETE.

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

      • UPDATE_METADATA: Semua pembaruan metadata di bawah awalan yang dipilih.

      • DELETE: Semua operasi penghapusan di bawah awalan yang dipilih, seperti DeleteObject dan DeleteMultipleObjects. Saat Pengendalian versi diaktifkan, ini mencakup penanda hapus. Penghapusan berbasis siklus hidup juga termasuk. Penghapusan permanen hanya mencatat bidang inti berikut: Bucket, Key, SequenceNumber, RecordType, RecordTimestamp, dan VersionId. Semua kolom lainnya bernilai null.

    • RecordTimestamp: Timestamp dalam format ISO 8601, seperti "2024-08-25 18:08:01.024". Menggunakan Greenwich Mean Time (GMT) dengan presisi milidetik.

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

    • RequestId: ID unik dari permintaan.

    • SourceIp: Alamat IP sumber dari pihak yang melakukan permintaan.

    • Key: Nama objek dalam bucket, dalam bentuk URL-encoded.

    • VersionId: ID versi objek. Bidang ini hanya muncul ketika aturan inventaris dikonfigurasi untuk mengekspor semua versi.

      • Jika Pengendalian versi dinonaktifkan untuk bucket, bidang ini kosong.

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

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

      • Jika Pengendalian versi dinonaktifkan untuk bucket, bidang ini default ke false.

      • Jika Pengendalian versi diaktifkan untuk bucket dan objek tersebut merupakan penanda hapus, bidang ini menampilkan true. Jika objek bukan penanda hapus, bidang ini menampilkan false.

    • Size: Ukuran objek.

    • StorageClass: Kelas penyimpanan objek.

    • LastModifiedDate: Waktu terakhir objek dimodifikasi.

    • ETag: Nilai ETag objek, digunakan untuk mengidentifikasi kontennya. ETag dihasilkan saat objek dibuat.

      • 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 oleh algoritma 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: Checksum CRC-64 objek.

    • EncryptionStatus: Menunjukkan apakah objek dienkripsi.

    Contoh

    • Permintaan contoh

      GET /?inventory&inventoryId=list1 HTTP/1.1

    • Respons contoh

        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

    SDK untuk API ini tersedia dalam bahasa pemrograman berikut:

    ossutil

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