Object Storage Service:GetBucketInventory

Catatan penggunaan

Secara default, Akun Alibaba Cloud memiliki izin untuk melihat konfigurasi inventaris tertentu dari sebuah bucket. Untuk memanggil operasi ini sebagai Pengguna Resource Access Management (RAM) atau menggunakan Security Token Service (STS), Anda harus memiliki izin oss:GetBucketInventory.

Sintaksis permintaan

GET /?inventory&inventoryId=inventoryId HTTP/1.1

Parameter permintaan

Elemen respons

Tabel berikut menjelaskan elemen-elemen yang dikembalikan dalam respons. Beberapa elemen hanya berlaku untuk konfigurasi inventaris tertentu. Misalnya, DayOfMonth hanya berlaku ketika Frequency diatur ke Monthly, dan AutoDelete hanya berlaku ketika Frequency diatur ke Once. Elemen-elemen yang spesifik untuk inventaris inkremental dijelaskan pada subbagian berikut.

Bidang catatan inventaris inkremental

Bidang-bidang berikut menjelaskan catatan dalam file inventaris inkremental:

• SequenceNumber: Nomor seri catatan. SequenceNumber setiap catatan bersifat unik. Catatan objek yang sama dalam bucket yang sama dapat diurutkan berdasarkan SequenceNumber, dan catatan yang diurutkan biasanya mengikuti urutan kronologis.

• RecordType: Jenis event. Nilai valid:

  • CREATE: semua operasi unggah yang terjadi di bawah awalan yang dipilih, seperti Put, Post, Append, MultipartUpload, dan Copy.

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

  • DELETE: semua operasi penghapusan objek di bawah awalan yang dipilih, seperti DeleteObject dan DeleteMultipleObjects, pembuatan penanda hapus setelah Pengendalian versi diaktifkan, serta penghapusan berbasis siklus hidup. Penghapusan mencakup pembuatan penanda hapus dan penghapusan permanen. Untuk penghapusan permanen, catatan hanya menyimpan bidang inti Bucket, Key, SequenceNumber, RecordType, RecordTimestamp, dan VersionId, sedangkan semua kolom lain bernilai null.

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

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

• RequestId: Pengidentifikasi unik permintaan.

• SourceIp: Alamat IP sumber pihak yang melakukan permintaan.

• Key: Nama objek dalam bucket yang telah di-URL-encoded.

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

  • Jika Pengendalian versi tidak diaktifkan pada bucket tempat aturan inventaris dikonfigurasi, bidang ini kosong.

  • Jika Pengendalian versi diaktifkan pada bucket tempat aturan inventaris dikonfigurasi, bidang ini menampilkan VersionId objek.

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

  • Jika Pengendalian versi tidak diaktifkan pada bucket tempat aturan inventaris dikonfigurasi, bidang ini secara default bernilai false.

  • Jika Pengendalian versi diaktifkan pada bucket tempat aturan inventaris dikonfigurasi, bidang ini bernilai true ketika objek merupakan penanda hapus, dan false ketika objek bukan penanda hapus.

• Size: Ukuran objek.

• StorageClass: Kelas penyimpanan objek.

• LastModifiedDate: Waktu terakhir objek dimodifikasi.

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

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

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

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

• ObjectType: Jenis objek.

• ObjectAcl: Daftar kontrol akses objek.

• Crc64: Nilai CRC-64 objek.

• EncryptionStatus: Menentukan apakah objek dienkripsi.

Contoh

• Permintaan contoh

GET /?inventory&inventoryId=report1 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 berikut mendukung operasi ini:

• Java

• Python V2

• Go V2

• Node.js

• C++

• .NET

CLI ossutil

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