ListBucketInventory menampilkan semua konfigurasi inventory untuk suatu bucket.
Usage notes
Operasi ListBucketInventory memerlukan izin oss:GetBucketInventory. Untuk informasi selengkapnya, lihat Grant custom permission policies to a RAM user.
Satu permintaan dapat mengambil maksimal 100 konfigurasi inventory. Jika respons terpotong, gunakan nilai NextContinuationToken dari respons sebagai continuation-token pada permintaan berikutnya untuk mengambil halaman hasil berikutnya.
Pastikan Anda memiliki izin untuk mengelola konfigurasi inventory bucket tersebut. Secara default, hanya pemilik bucket yang memiliki izin ini. Jika Anda bukan pemiliknya, mintalah izin yang diperlukan.
Request syntax
Dengan continuation-token
GET /?inventory&continuation-token=xxx HTTP/1.1Tanpa continuation-token
GET /?inventory HTTP/1.1
Response elements
Parameter | Type | Description |
InventoryConfiguration | container | A container for inventory configuration parameters. |
IsTruncated | Boolean | Menunjukkan apakah daftar konfigurasi inventory terpotong. Nilai valid: true atau false
|
NextContinuationToken | String | Jika respons terpotong (IsTruncated bernilai true), gunakan token ini sebagai parameter continuation-token pada permintaan berikutnya untuk mendapatkan halaman hasil berikutnya. |
Id | String | Nama yang ditentukan pengguna untuk konfigurasi inventory. Nama tersebut harus unik dalam bucket. |
IsEnabled | Boolean | Menentukan apakah inventory diaktifkan. Nilai valid: true atau false
|
Filter | container | A container for the filter rules. Inventory hanya mencakup objek yang sesuai dengan filter. |
Prefix | String | Awalan objek yang digunakan untuk filtering. Parent node: Filter |
Destination | container | A container for information about where to publish the inventory results. |
OSSBucketDestination | container | Berisi detail tentang bucket tujuan tempat laporan inventory disimpan. Parent node: Destination |
Format | String | Format file dari inventory yang diekspor. Nilai valid: CSV Parent node: OSSBucketDestination |
AccountId | String | ID akun yang diberikan izin untuk menulis laporan inventory ke bucket tujuan. Parent node: OSSBucketDestination |
RoleArn | String | ARN dari role yang diberikan izin untuk menulis laporan inventory ke bucket tujuan. Format: acs:ram::uid:role/rolename Parent node: OSSBucketDestination |
Bucket | String | Bucket tujuan untuk laporan inventory. Parent node: OSSBucketDestination |
Prefix | String | Awalan dalam bucket tujuan tempat laporan inventory disimpan. Parent node: OSSBucketDestination |
Encryption | container | Metode enkripsi sisi server untuk laporan inventory. Nilai valid: SSE-OSS, SSE-KMS, atau Null Parent node: OSSBucketDestination |
SSE-OSS | container | A container for SSE-OSS encryption. Parent node: Encryption |
SSE-KMS | container | A container for the key used for SSE-KMS encryption. Parent node: Encryption |
KeyId | String | ID kunci KMS. Parent node: SSE-KMS |
Schedule | container | A container for the inventory export schedule. |
Frequency | String | Frekuensi ekspor inventory. Nilai valid: Parent node: Schedule |
DayOfMonth | Integer | Hari dalam bulan ketika inventory diekspor jika Parent node: Schedule |
AutoDelete | Boolean | Menentukan apakah konfigurasi inventory dihapus secara otomatis setelah mengekspor inventory satu kali. Elemen ini hanya berlaku jika Nilai valid: true, false Parent node: Schedule |
IncludedObjectVersions | String | Menentukan versi objek mana yang dimasukkan dalam inventory. Nilai valid:
|
OptionalFields | container | A container for the optional fields to include in the inventory. |
Field | container | Field opsional yang dimasukkan dalam inventory. Field opsional meliputi: Parent node: OptionalFields |
IncrementalInventory | container | A container for the incremental inventory configuration. |
IsEnabled | Boolean | Menunjukkan apakah inventory inkremental diaktifkan. Nilai valid:
Jika true, inventory inkremental diaktifkan meskipun IsEnabled induk bernilai false. Parent node: IncrementalInventory |
Schedule | container | A container for the incremental inventory export schedule. Parent node: IncrementalInventory |
Frequency | Integer | Frekuensi ekspor inventory inkremental, dalam detik. Sistem mengekspor inventory inkremental pada interval tetap 600 detik. Pada setiap interval, sistem secara otomatis membuat awalan direktori dan menghasilkan file manifest serta beberapa file CSV. Frekuensi kustom tidak didukung. Parent node: Schedule |
OptionalFields | container | A container for the optional fields to include in the incremental inventory. Parent node: IncrementalInventory |
Field | String | Field yang dimasukkan dalam inventory inkremental. Parent node: OptionalFields
|
Examples
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/plainContoh 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>
SDKs
Anda dapat memanggil operasi ini menggunakan SDK berikut:
Ossutil CLI
Untuk menjalankan operasi ini menggunakan ossutil, lihat perintah list-bucket-inventory.