Object Storage Service：PutBucketInventory

Catatan

Gunakan inventaris untuk mendapatkan informasi tentang objek dalam sebuah bucket, seperti jumlah, ukuran, kelas penyimpanan, dan status enkripsi. Saat mengonfigurasi inventaris untuk bucket, perhatikan hal-hal berikut:

• Hanya pemilik bucket atau pengguna dengan izin oss:PutBucketInventory yang dapat memulai permintaan PutBucketInventory. Untuk detail lebih lanjut, lihat Melampirkan kebijakan kustom ke pengguna RAM.

• Sebelum mengonfigurasi inventaris untuk bucket, buat Peran RAM. Peran ini harus memiliki izin untuk membaca semua objek dari bucket sumber dan menulis objek ke bucket tujuan. Jika menggunakan fitur daftar bucket untuk pertama kalinya, disarankan untuk mengonfigurasi inventaris di konsol Object Storage Service (OSS). Setelah konfigurasi, Anda dapat memperoleh Peran RAM dengan izin untuk melakukan semua operasi pada sumber daya OSS. Untuk informasi lebih lanjut, lihat Daftar Bucket.

• Anda dapat mengonfigurasi hingga 1.000 inventaris untuk sebuah bucket.

• Bucket sumber yang ingin dikonfigurasi inventarisnya harus berada di wilayah yang sama dengan bucket tujuan tempat daftar inventaris disimpan.

Sintaks permintaan

  PUT /?inventory&inventoryId=report1 HTTP/1.1
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Authorization: authorization string
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Filter>
           <Prefix>filterPrefix/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass>Standard,IA</StorageClass>
     </Filter>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::destination-bucket</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-KMS>
                 <KeyId>keyId</KeyId>
              </SSE-KMS>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>TransistionTime</Field>
        <Field>ETag</Field>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>

Elemen permintaan

Header respons

Semua header dalam respons terhadap permintaan PutBucketInventory adalah header respons umum, seperti Content-Length dan Date. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

• Permintaan Contoh

    PUT /?inventory&inventoryId=report1 HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Mon, 31 Oct 2016 12:00:00 GMT
    Authorization: authorization string
    Content-Length: length
  
    <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
       <Id>report1</Id>
       <IsEnabled>true</IsEnabled>
       <Filter>
           <Prefix>Pics/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass>Standard,IA</StorageClass>
       </Filter>
       <Destination>
          <OSSBucketDestination>
            <Format>CSV</Format>
            <AccountId>100000000000000</AccountId>
            <RoleArn>acs:ram::100000000000000:role/AliyunOSSRole</RoleArn>
            <Bucket>acs:oss:::destbucket</Bucket>
            <Prefix>prefix1/</Prefix>
            <Encryption>
               <SSE-KMS>
                  <KeyId>keyId</KeyId>
               </SSE-KMS>
             </Encryption>
          </OSSBucketDestination>
       </Destination>
       <Schedule>
          <Frequency>Daily</Frequency>
       </Schedule>
       <IncludedObjectVersions>All</IncludedObjectVersions>
       <OptionalFields>
          <Field>Size</Field>
          <Field>LastModifiedDate</Field>
          <Field>TransistionTime</Field> 
          <Field>ETag</Field>
          <Field>StorageClass</Field>
          <Field>IsMultipartUploaded</Field>
          <Field>EncryptionStatus</Field>
       </OptionalFields>
    </InventoryConfiguration>

• Respons Contoh

    HTTP/1.1 200 OK
    x-oss-request-id: 56594298207FB3044385****
    Date: Mon, 31 Oct 2016 12:00:00 GMT
    Content-Length: 0
    Server: AliyunOSS

OSS SDK

Gunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil PutBucketInventory:

• Java

• Python

• Go V2

• Node.js

• C++

• .NET

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketInventory, lihat put-bucket-inventory.

Kode kesalahan