ListBucketInventory - Object Storage Service

Operasi ini digunakan untuk menanyakan semua tugas inventaris yang dikonfigurasi untuk sebuah bucket.

Catatan

Anda dapat menanyakan hingga 100 konfigurasi inventaris dalam satu permintaan. Untuk menanyakan lebih dari 100 konfigurasi, kirimkan beberapa permintaan dan gunakan token dari setiap permintaan sebagai parameter pada permintaan berikutnya.
Untuk memanggil operasi ini, pastikan Anda memiliki izin untuk mengelola tugas-tugas inventaris bucket tersebut. Pemilik bucket secara default memiliki izin ini. Jika tidak memiliki izin, ajukan permohonan kepada pemilik bucket.

Sintaksis permintaan

Permintaan dengan continuation-token

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

Permintaan tanpa continuation-token
```
GET /? inventory HTTP/1.1
```

Elemen respons

Elemen	Tipe	Deskripsi
InventoryConfiguration	Container	Wadah yang menyimpan konfigurasi inventaris.
IsTruncated	Boolean	Menentukan apakah semua tugas inventaris yang dikonfigurasi untuk bucket terdaftar. Nilai valid: true dan false Nilai false menunjukkan bahwa semua tugas inventaris yang dikonfigurasi untuk bucket terdaftar. Nilai true menunjukkan bahwa tidak semua tugas inventaris yang dikonfigurasi untuk bucket terdaftar. Untuk mendaftarkan halaman berikutnya dari konfigurasi inventaris, atur parameter continuation-token dalam permintaan berikutnya ke nilai header NextContinuationToken dalam respons terhadap permintaan saat ini.
NextContinuationToken	String	Jika nilai IsTruncated dalam respons adalah true dan nilai header ini tidak null, atur parameter continuation-token dalam permintaan berikutnya ke nilai header ini.
Id	String	Nama daftar inventaris yang ditentukan, yang harus unik secara global di dalam bucket.
IsEnabled	Boolean	Menunjukkan apakah fungsi inventaris diaktifkan. Nilai valid: true dan false Nilai true menunjukkan bahwa fungsi inventaris diaktifkan. Nilai false menunjukkan bahwa tidak ada daftar inventaris yang dihasilkan.
Filter	Container	Wadah yang menyimpan prefix yang digunakan untuk memfilter objek dalam daftar inventaris. Hanya objek dengan prefix tertentu yang disertakan dalam daftar inventaris.
Prefix	String	Prefix yang ditentukan dalam aturan inventaris. Node induk: Filter
Destination	Container	Wadah yang digunakan untuk menyimpan informasi tentang bucket yang menyimpan 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 yang menyimpan daftar inventaris yang diekspor. Node induk: OSSBucketDestination
Prefix	String	Path daftar inventaris yang diekspor. Node induk: OSSBucketDestination
Encryption	Container	Wadah yang menyimpan metode enkripsi daftar inventaris. 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 CMK yang digunakan dalam metode enkripsi SSE-KMS. Node induk: Encryption
KeyId	String	CMK yang digunakan dalam metode enkripsi SSE-KMS. Node induk: SSE-KMS
Schedule	Container	Wadah yang menyimpan frekuensi ekspor daftar inventaris.
Frequency	String	Frekuensi ekspor daftar inventaris. Nilai valid: Daily dan Weekly Node induk: Schedule
IncludedObjectVersions	String	Menentukan apakah informasi versi tentang objek disertakan 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 disertakan dalam daftar inventaris.
Field	Container	Bidang konfigurasi yang disertakan dalam daftar inventaris. Nilai valid: Size, LastModifiedDate, ETag, StorageClass, IsMultipartUploaded, dan EncryptionStatus Node induk: OptionalFields

Contoh

Contoh Permintaan

  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

Contoh Respons

  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>

OSS SDKs

Gunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi ListBucketInventory:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListBucketInventory, lihat list-bucket-inventory.