GetBucketInventory - Object Storage Service

Meminta inventaris yang ditentukan dari sebuah bucket.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk meminta inventaris yang ditentukan dari sebuah bucket. Jika Anda ingin meminta inventaris menggunakan pengguna RAM atau STS, Anda harus memiliki izin oss:GetBucketInventory.

Sintaks permintaan

GET /?inventory&inventoryId=inventoryId HTTP/1.1

Parameter permintaan

Parameter	Tipe	Diperlukan	Deskripsi
inventoryId	String	Ya	ID inventaris yang ingin Anda minta.

Parameter respons

Parameter	Tipe	Deskripsi
Id	String	Nama inventaris yang ditentukan, yang harus unik secara global di dalam bucket.
IsEnabled	Nilai Boolean	Menunjukkan apakah fitur inventaris diaktifkan. Nilai valid: true dan false Nilai true menunjukkan bahwa fitur inventaris diaktifkan. Nilai false menunjukkan bahwa daftar inventaris tidak dibuat.
Filter	Container	Wadah yang menyimpan awalan yang digunakan untuk memfilter objek. Hanya objek dengan nama yang mengandung awalan tertentu yang termasuk dalam daftar inventaris.
Prefix	String	Awalan yang ditentukan dalam inventaris. Node induk: Filter
Destination	Container	Wadah yang menyimpan informasi tentang daftar inventaris yang diekspor.
OSSBucketDestination	Container	Informasi tentang bucket yang menyimpan daftar inventaris yang diekspor. Node induk: Destination
Format	String	Format daftar inventaris yang diekspor. Nilai valid: CSV Node induk: OSSBucketDestination
AccountId	String	ID akun yang diberikan oleh pemilik bucket. Node induk: OSSBucketDestination
RoleArn	String	Nama peran yang diberikan izin oleh pemilik bucket. Format: acs:ram::uid:role/rolename Node induk: OSSBucketDestination
Bucket	String	Bucket tempat daftar inventaris yang diekspor disimpan. Node induk: OSSBucketDestination
Prefix	String	Awalan yang terkandung dalam jalur tempat daftar inventaris yang diekspor disimpan. Node induk: OSSBucketDestination
Encryption	Container	Wadah yang menyimpan metode enkripsi daftar inventaris yang diekspor. Nilai valid: SSE-OSS, SSE-KMS, dan Null Node induk: OSSBucketDestination
SSE-OSS	Container	Wadah yang menyimpan informasi tentang metode enkripsi SSE-OSS. Node induk: Encryption
SSE-KMS	Container	Wadah yang menyimpan kunci master pelanggan (CMK) yang digunakan dalam metode enkripsi SSE-KMS. Node induk: Encryption
KeyId	String	ID kunci yang dikelola oleh Key Management Service (KMS). Node induk: SSE-KMS
Schedule	Container	Wadah yang menyimpan informasi tentang frekuensi ekspor daftar inventaris.
Frequency	String	Frekuensi ekspor daftar inventaris. Nilai valid: Daily dan Weekly Node induk: Schedule
IncludedObjectVersions	String	Menunjukkan apakah akan menyertakan informasi versi objek dalam daftar inventaris. Nilai valid: All dan Current Nilai All menunjukkan bahwa semua versi objek diekspor. Nilai Current menunjukkan bahwa hanya versi terbaru objek yang diekspor.
OptionalFields	Container	Wadah yang menyimpan bidang konfigurasi yang termasuk dalam daftar inventaris.
Field	String	Bidang konfigurasi yang termasuk dalam daftar inventaris. Nilai valid: Size, LastModifiedDate, ETag, StorageClass, IsMultipartUploaded, dan EncryptionStatus Node induk: OptionalFields

Contoh

Permintaan Sampel

GET /?inventory&inventoryId=list1 HTTP/1.1

Respons Sampel

  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>

OSS SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil GetBucketInventory:

ossutil

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