panggil ListBucketInventory untuk mendapatkan tugas inventaris untuk suatu bucket - Object Storage Service

ListBucketInventory mengambil semua tugas inventaris untuk suatu bucket secara batch.

Catatan

Untuk memanggil ListBucketInventory guna mengambil semua tugas inventaris dari suatu bucket secara batch, Anda harus memiliki izin oss:GetBucketInventory. Untuk informasi selengkapnya, lihat Berikan kebijakan akses kustom kepada Pengguna RAM.

Catatan

Satu permintaan dapat mengambil maksimal 100 item konfigurasi inventaris. Untuk mengambil lebih dari 100 item, kirimkan beberapa permintaan dan gunakan token dari setiap respons sebagai parameter pada permintaan berikutnya.
Pastikan Anda memiliki izin yang cukup untuk mengelola tugas inventaris bucket tersebut saat memanggil operasi ini. Pemilik bucket memiliki izin ini secara default. Jika Anda tidak memilikinya, mintalah kepada pemilik bucket.

Sintaksis permintaan

Dengan continuation-token

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

Tanpa continuation-token
```
GET /?inventory HTTP/1.1
```

Elemen respons

Name	Type	Description
InventoryConfiguration	Container	Container untuk parameter konfigurasi inventaris.
IsTruncated	Boolean	Menunjukkan apakah semua tugas inventaris telah terdaftar. Nilai valid: true atau false Jika false, semua tugas inventaris dalam bucket telah terdaftar. Jika true, tidak semua tugas inventaris dalam bucket telah terdaftar. Gunakan nilai bidang NextContinuationToken sebagai parameter continuation-token untuk permintaan daftar berikutnya guna mendapatkan halaman konfigurasi inventaris berikutnya.
NextContinuationToken	String	Jika IsTruncated dalam respons bernilai true dan NextContinuationToken tidak kosong, gunakan bidang ini sebagai parameter continuation-token untuk permintaan daftar berikutnya.
Id	String	Nama inventaris yang ditentukan pengguna. Nama ini harus unik secara global dalam bucket saat ini.
IsEnabled	Boolean	Menunjukkan apakah inventaris diaktifkan. Nilai valid: true atau false Jika diatur ke true, fitur inventaris berlaku. Jika diatur ke false, tidak ada inventaris yang dihasilkan.
Filter	Container	Awalan untuk penyaringan inventaris. Setelah menentukan awalan, inventaris akan menyaring objek yang sesuai dengan pengaturan awalan tersebut.
Prefix	String	Awalan yang cocok untuk aturan penyaringan. Node induk: Filter
Destination	Container	Container untuk informasi tentang hasil inventaris.
OSSBucketDestination	Container	Informasi tentang bucket tempat hasil inventaris yang diekspor disimpan. Node induk: Destination
Format	String	Format file dari file inventaris yang diekspor. Nilai valid: CSV Node induk: OSSBucketDestination
AccountId	String	AccountId yang diberikan oleh pemilik bucket. Node induk: OSSBucketDestination
RoleArn	String	Nama role yang diberikan izin operasi oleh pemilik bucket. Format: acs:ram::uid:role/rolename Node induk: OSSBucketDestination
Bucket	String	Bucket yang menyimpan file inventaris yang diekspor. Node induk: OSSBucketDestination
Prefix	String	Awalan jalur penyimpanan untuk file inventaris. Node induk: OSSBucketDestination
Encryption	Container	Metode enkripsi untuk file inventaris. Nilai valid: SSE-OSS, SSE-KMS, atau Null Node induk: OSSBucketDestination
SSE-OSS	Container	Container untuk metode enkripsi SSE-OSS. Node induk: Encryption
SSE-KMS	Container	Container untuk kunci yang digunakan dalam metode enkripsi SSE-KMS. Node induk: Encryption
KeyId	String	ID kunci KMS. Node induk: SSE-KMS
Schedule	Container	Container untuk informasi siklus ekspor inventaris.
Frequency	String	Siklus ekspor untuk file inventaris. Nilai valid: Daily atau Weekly Node induk: Schedule
IncludedObjectVersions	String	Menunjukkan apakah informasi versi objek disertakan dalam inventaris. Nilai valid: All atau Current Jika All, ekspor semua informasi versi objek. Jika Current, ekspor hanya informasi versi objek saat ini.
OptionalFields	Container	Container untuk item konfigurasi yang disertakan dalam hasil inventaris.
Field	Container	Item konfigurasi yang disertakan dalam hasil inventaris. Item konfigurasi opsional: Size, LastModifiedDate, TransitionTime, ETag, StorageClass, IsMultipartUploaded, EncryptionStatus, ObjectAcl, TaggingCount, ObjectType, Crc64 Node induk: OptionalFields
IncrementalInventory	Container	Informasi konfigurasi untuk inventaris inkremental.
IsEnabled	Boolean	Menunjukkan apakah inventaris inkremental diaktifkan. Nilai valid: true: diaktifkan false: dinonaktifkan Jika true, fitur inventaris inkremental diaktifkan dan tidak terpengaruh oleh pengaturan enable=false di tingkat atas. Node induk: IncrementalInventory
Schedule	Container	Siklus ekspor untuk inventaris inkremental. Node induk: IncrementalInventory
Frequency	Positive integer	Frekuensi ekspor untuk inventaris inkremental, dalam satuan detik. Sistem saat ini menggunakan siklus tetap 600 detik. Setiap siklus secara otomatis membuat awalan direktori dan menghasilkan file manifest yang sesuai serta beberapa file CSV yang dihasilkan dalam siklus tersebut. Pengaturan frekuensi kustom tidak didukung. Node induk: Schedule
OptionalFields	Container	Tetapkan item konfigurasi yang disertakan dalam inventaris inkremental. Node induk: IncrementalInventory
Field	String	Item konfigurasi yang disertakan dalam inventaris inkremental. Node induk: OptionalFields SequenceNumber: Nomor seri. SequenceNumber setiap catatan bersifat unik. Catatan dalam bucket dan objek yang sama dapat diurutkan berdasarkan SequenceNumber, yang biasanya menjamin bahwa catatan yang diurutkan mengikuti urutan kronologis. RecordType: Jenis peristiwa: CREATE, UPDATE_METADATA, DELETE CREATE: Semua metode unggah yang terjadi di bawah awalan yang dipilih, seperti Put/Post/Append/MultipartUpload/Copy. UPDATE_METADATA: Semua pembaruan metadata di bawah awalan yang dipilih dicatat dalam jenis ini. DELETE: Semua metode penghapusan file di bawah awalan yang dipilih, seperti DeleteObject/DeleteMultipleObjects, pembuatan DeleteMarker setelah Pengendalian versi diaktifkan, dan penghapusan melalui lifecycle. Penghapusan mencakup DeleteMarker dan penghapusan permanen. Catatan penghapusan permanen hanya menyimpan bidang inti: `Bucket`, `Key`, `SequenceNumber`, `RecordType`, `RecordTimestamp`, dan `VersionId`. Semua kolom lainnya kosong (null). RecordTimestamp: Timestamp dalam Greenwich Mean Time (GMT) dengan presisi milidetik. Contoh: "2024-08-25 18:08:01.024". Requester: ID Alibaba Cloud atau Principal ID 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 jika aturan inventaris yang dikonfigurasi mengatur untuk mengekspor semua versi. Jika Pengendalian versi tidak diaktifkan untuk bucket yang dikonfigurasi dalam aturan inventaris, bidang ini akan kosong. Jika Pengendalian versi diaktifkan untuk bucket yang dikonfigurasi dalam aturan inventaris, bidang ini menampilkan VersionId objek tersebut. IsDeleteMarker: Menunjukkan apakah versi objek tersebut merupakan penanda hapus. Bidang ini hanya muncul jika aturan inventaris yang dikonfigurasi mengatur untuk mengekspor semua versi. Jika Pengendalian versi tidak diaktifkan untuk bucket yang dikonfigurasi dalam aturan inventaris, bidang ini secara default bernilai false. Jika Pengendalian versi diaktifkan untuk bucket yang dikonfigurasi dalam aturan inventaris dan objek tersebut merupakan penanda hapus, bidang ini menampilkan true. Jika objek tersebut 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 konten objek. ETag dibuat saat objek dihasilkan untuk mengidentifikasi kontennya. Untuk objek yang dibuat menggunakan antarmuka PutObject, nilai ETag adalah Hash MD5 dari kontennya. Untuk objek yang dibuat dengan metode lain, nilai ETag adalah nilai unik yang dihasilkan berdasarkan aturan perhitungan 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: CRC-64 objek. EncryptionStatus: Menunjukkan apakah objek dienkripsi.

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>

SDK

SDK untuk antarmuka ini adalah sebagai berikut:

Alat baris perintah ossutil

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