Object Storage Service：daftar inventaris

Catatan penggunaan

• Untuk membuat Daftar Inventaris Bucket, Anda harus memiliki izin oss:PutBucketInventory. Untuk menanyakan Daftar Inventaris Bucket, Anda harus memiliki izin oss:GetBucketInventory. Untuk menghapus Daftar Inventaris Bucket, Anda harus memiliki izin oss:DeleteBucketInventory. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

• Untuk ossutil versi 1.6.16 dan yang lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil versi sebelum 1.6.16, Anda harus menentukan nama biner yang sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi Perintah ossutil.

• Untuk informasi lebih lanjut tentang fitur Daftar Inventaris Bucket, lihat Daftar Inventaris Bucket.

Buat daftar inventaris

Berikut adalah langkah-langkah untuk membuat Daftar Inventaris untuk sebuah bucket:

1. Buat Peran Manajemen Akses Sumber Daya (RAM) dan otorisasi peran tersebut untuk membaca semua objek dalam bucket sumber serta menulis objek ke bucket tujuan tempat Daftar Inventaris disimpan. Untuk informasi lebih lanjut, lihat Buat Peran RAM untuk Layanan Tepercaya Alibaba Cloud.

2. Buat file lokal dan konfigurasikan Daftar Inventaris dalam format XML di file tersebut.

3. Gunakan ossutil untuk membaca Daftar Inventaris dari file lokal dan asosiasikan Daftar Inventaris dengan bucket yang ditentukan.

• Sintaks Perintah

  ossutil inventory --method put oss://namabucket file_xml_lokal

  Tabel berikut menjelaskan parameter-parameter di atas.

  Parameter	Deskripsi
  namabucket	Nama bucket untuk mana Anda ingin membuat daftar inventaris.
  file_xml_lokal	Nama file XML lokal di mana Anda mengonfigurasi daftar inventaris. Contoh: localfile.xml.

• Contoh

  1. Buat file lokal bernama localfile.xml dan konfigurasikan Daftar Inventaris sesuai kebutuhan Anda.

     Contoh berikut menunjukkan Daftar Inventaris bernama inventorytest. Berdasarkan Daftar Inventaris ini, Object Storage Service (OSS) mengekspor informasi tentang semua objek yang namanya berisi awalan dir/ dalam bucket destbucket secara mingguan. Informasi yang diekspor mencakup kelas penyimpanan, tanggal terakhir dimodifikasi, dan status unggahan multipart dari objek. Daftar Inventaris yang diekspor dienkripsi menggunakan algoritma AES256.

     <?xml version="1.0" encoding="UTF-8"?>
       <InventoryConfiguration>
           <Id>inventorytest</Id>
           <IsEnabled>true</IsEnabled>
           <Filter>
             <Prefix>dir/</Prefix>
           </Filter>
           <Destination>
               <OSSBucketDestination>
                   <Format>CSV</Format>
                   <AccountId>1746495857602745</AccountId>
                   <RoleArn>acs:ram::174649585760****:role/AliyunOSSRole</RoleArn>
                   <Bucket>acs:oss:::destbucket</Bucket>
                   <Encryption>
                       <SSE-OSS></SSE-OSS>
                   </Encryption>
               </OSSBucketDestination>
           </Destination>
           <Schedule>
               <Frequency>Weekly</Frequency>
           </Schedule>
           <IncludedObjectVersions>All</IncludedObjectVersions>
           <OptionalFields>
               <Field>LastModifiedDate</Field>
               <Field>StorageClass</Field>
               <Field>IsMultipartUploaded</Field>
               <Field>ETag</Field>
               <Field>EncryptionStatus</Field>
               <Field>Size</Field>
           </OptionalFields>
       </InventoryConfiguration>

     Penting

     Anda dapat membuat beberapa Daftar Inventaris untuk sebuah bucket. Setiap Daftar Inventaris diidentifikasi secara unik oleh ID mereka. Jika ID Daftar Inventaris yang ingin dibuat sama dengan ID Daftar Inventaris yang sudah ada, kode status HTTP 409 akan dikembalikan.

  2. Buat Daftar Inventaris untuk bucket bernama examplebucket.

     ossutil inventory --method put oss://examplebucket localfile.xml

     Keluaran sampel berikut menunjukkan bahwa Daftar Inventaris telah berhasil dibuat.

     0.299514(s) elapsed

Tanyakan daftar inventaris yang ditentukan untuk sebuah bucket

• Sintaks Perintah

  ossutil inventory --method get oss://namabucket id_inventaris [--file_xml_lokal ]

  Tabel berikut menjelaskan parameter-parameter di atas.

  Parameter	Deskripsi
  namabucket	Nama bucket yang ingin Anda tanyakan daftar inventarisnya.
  id_inventaris	Nama daftar inventaris yang ingin Anda tanyakan.
  file_xml_lokal	Nama file lokal di mana Anda ingin menyimpan daftar inventaris. Contoh: localfile.txt. Jika parameter ini tidak ditentukan, daftar inventaris ditampilkan tanpa disimpan dalam file lokal.

• Contoh

  ossutil inventory --method get oss://examplebucket inventorytest localfile.txt

  Keluaran sampel berikut menunjukkan bahwa Daftar Inventaris inventorytest yang dikonfigurasi untuk bucket examplebucket diperoleh dan ditulis ke file localfile.txt:

  0.212407(s) elapsed

Tanyakan semua daftar inventaris yang dikonfigurasi untuk sebuah bucket

• Sintaks Perintah

  ossutil inventory --method list oss://namabucket [--file_xml_lokal ] [--marker <nilai>]

  Tabel berikut menjelaskan parameter-parameter di atas.

  Parameter	Deskripsi
  namabucket	Nama bucket yang ingin Anda tanyakan daftar inventarisnya.
  file_xml_lokal	Nama file XML lokal di mana Anda ingin menyimpan daftar inventaris. Jika parameter ini tidak ditentukan, daftar inventaris ditampilkan tanpa disimpan dalam file lokal.
  marker	Kondisi filter berbasis awalan untuk daftar inventaris. Daftar inventaris hanya dihasilkan untuk objek yang namanya berisi awalan yang ditentukan. Jika parameter ini tidak ditentukan, daftar inventaris dihasilkan untuk semua objek dalam bucket.

• Contoh

  ossutil inventory --method list oss://examplebucket localfile.txt dest

  Keluaran sampel berikut menunjukkan bahwa semua Daftar Inventaris untuk objek yang namanya berisi awalan dest dalam bucket examplebucket diperoleh dan ditulis ke file localfile.txt:

  0.216897(s) elapsed

Hapus daftar inventaris yang ditentukan untuk sebuah bucket

• Sintaks Perintah

  ossutil inventory --method delete oss://namabucket id_inventaris

  Tabel berikut menjelaskan parameter-parameter di atas.

  Parameter	Deskripsi
  namabucket	Nama bucket untuk mana Anda ingin menghapus daftar inventaris.
  id_inventaris	Nama daftar inventaris yang ingin Anda hapus.

• Contoh

  ossutil inventory --method delete oss://examplebucket inventorytest

  Keluaran sampel berikut menunjukkan bahwa sistem telah menghapus Daftar Inventaris inventorytest yang dikonfigurasi untuk bucket examplebucket.

  0.212407(s) elapsed

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berlokasi di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah di mana bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun yang ditentukan, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey dari akun yang ditentukan.

ossutil inventory --method put oss://examplebucket file_xml_lokal -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.