Jalankan perintah object-tagging untuk mengelola tag objek - Object Storage Service

Object Storage Service (OSS) memungkinkan Anda menggunakan tag untuk mengklasifikasikan objek. Anda dapat mengelola objek dengan tag yang sama, seperti menentukan periode validitas atau mengubah kelas penyimpanan objek tersebut. Gunakan perintah object-tagging untuk menambah, memodifikasi, menanyakan, atau menghapus tag objek.

Catatan penggunaan

Untuk menambah atau memodifikasi tag objek, Anda memerlukan izin oss:PutObjectTagging. Untuk menanyakan tag objek, Anda memerlukan izin oss:GetObjectTagging. Untuk menghapus tag objek, Anda memerlukan izin oss:DeleteObjectTagging. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Mulai ossutil versi 1.6.16, Anda dapat langsung menggunakan nama biner ossutil di baris perintah tanpa memperbarui berdasarkan sistem operasi. Untuk versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai sistem operasi. Untuk detail lebih lanjut, lihat Referensi Perintah ossutil.
Untuk informasi lebih lanjut tentang tag objek, lihat Tag Objek.

Sintaks perintah

ossutil object-tagging oss://bucketname[/prefix][key#value]
--method <nilai>
[--encoding-type <nilai>]
[-r, --recursive]
[--payer <nilai>]
[--version-id <nilai>]

Tabel berikut menjelaskan parameter dan opsi dalam sintaks.

Parameter/Opsi	Deskripsi
bucketname	Nama bucket.
prefix	Awalan dalam nama sumber daya, seperti direktori dan objek.
key	Kunci dari tag. Tag adalah pasangan kunci-nilai. Anda dapat menambahkan hingga 10 tag ke setiap objek. Tag pada objek yang sama harus memiliki kunci tag yang unik. Kunci tag harus mematuhi persyaratan berikut: Kunci tag maksimal 128 karakter panjangnya dan peka terhadap huruf besar/kecil. Kunci tag dapat berisi huruf, angka, spasi, dan karakter khusus berikut: +=._:/
value	Nilai dari tag. Nilai tag harus mematuhi persyaratan berikut: Nilai tag maksimal 256 karakter panjangnya dan peka terhadap huruf besar/kecil. Nilai tag dapat berisi huruf, angka, spasi, dan karakter khusus berikut: +=._:/
--method	Jenis permintaan. Nilai yang valid: put: menambahkan tag ke objek atau memodifikasi tag objek. get: menanyakan tag objek. delete: menghapus tag objek.
--encoding-type	Metode yang digunakan untuk menyandikan awalan yang mengikuti `oss://bucket_name`. Nilai valid: url. Jika Anda tidak menentukan opsi ini, awalan tidak disandikan.
-r, --recursive	Jika Anda menentukan opsi ini dalam perintah, ossutil mengonfigurasi tagging untuk semua objek yang namanya mengandung awalan yang ditentukan oleh parameter prefix. Jika Anda tidak menentukan opsi ini dalam perintah, ossutil hanya mengonfigurasi tagging untuk objek yang ditentukan.
--version-id	ID versi objek. Parameter ini hanya berlaku untuk bucket yang memiliki versioning aktif atau ditangguhkan.
--payer	Pembayar permintaan. Jika Anda ingin peminta yang mengakses sumber daya di jalur tertentu membayar biaya yang dihasilkan oleh operasi, seperti lalu lintas dan biaya permintaan, atur parameter ini ke requester.

Tambah atau modifikasi tag objek

Hanya pemilik bucket dan pengguna RAM dengan izin PutObjectTagging yang dapat menambahkan atau memodifikasi tag objek di bucket.

Contoh berikut menunjukkan cara menambahkan dan memodifikasi tag objek:

Penting

Jika objek tidak memiliki tag dengan kunci yang sama seperti yang ditentukan dalam perintah, tag akan ditambahkan. Jika objek sudah memiliki tag dengan kunci yang sama, tag tersebut akan ditimpa.

Jalankan perintah berikut untuk mengonfigurasi tag dengan kunci tagkey dan nilai tagvalue untuk objek bernama exampleobject.txt di bucket examplebucket:
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey#tagvalue
```
Jalankan perintah berikut untuk mengonfigurasi tag berikut untuk objek bernama exampleobject.png di bucket examplebucket: tagkey1#tagvalue1 dan tagkey2#tagvalue2.
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey1#tagvalue1 tagkey2#tagvalue2
```
Jalankan perintah berikut untuk mengonfigurasi tag berikut untuk objek dengan awalan "test" di bucket examplebucket: tagkey3#tagvalue3, tagkey4#tagvalue4, dan tagkey5#tagvalue5.
```
ossutil object-tagging --method put oss://examplebucket/test -r tagkey3#tagvalue3 tagkey4#tagvalue4 tagkey5#tagvalue5
```
Jalankan perintah berikut untuk mengonfigurasi tag dengan kunci tagkey6 dan nilai tagvalue6 untuk versi tertentu dari objek bernama exampleobject.txt di bucket examplebucket:
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey6#tagvalue6 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****
```
Untuk informasi lebih lanjut tentang cara mencantumkan semua versi objek, lihat Is.
Setelah perintah berhasil, keluaran serupa berikut dikembalikan untuk menunjukkan waktu yang digunakan untuk mengonfigurasi tagging:
```
0.106852(s) elapsed
```

Tanyakan tag objek

Hanya pemilik bucket dan pengguna RAM dengan izin GetObjectTagging yang dapat menanyakan tag objek di bucket.

Contoh berikut menunjukkan cara menanyakan tag objek:

Menanyakan tag objek

Jalankan perintah berikut untuk menanyakan tag objek bernama exampleobject.txt di bucket examplebucket:

ossutil object-tagging --method get oss://examplebucket/exampleobject.txt

Keluaran berikut menunjukkan bahwa exampleobject.txt memiliki tag dengan kunci tagkey dan nilai tagvalue.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey"  "tagvalue"      oss://examplebucket/exampleobject.txt

0.068156(s) elapsed

Menanyakan tag beberapa objek

Jalankan perintah berikut untuk menanyakan tag semua objek dengan awalan "test" di bucket examplebucket:

ossutil object-tagging --method get oss://examplebucket/test -r

Keluaran berikut menunjukkan bahwa objek dengan awalan "test" memiliki tag berikut: tagkey3#tagvalue3, tagkey4#tagvalue4, dan tagkey5#tagvalue5.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey3" "tagvalue3"     oss://examplebucket/test
1              1              "tagkey4" "tagvalue4"     oss://examplebucket/test
1              2              "tagkey5" "tagvalue5"     oss://examplebucket/test

0.093040(s) elapsed

Hapus tag objek

Hanya pemilik bucket dan pengguna RAM dengan izin DeleteObjectTagging yang dapat menghapus tag objek di bucket.

Contoh berikut menunjukkan cara menghapus tag objek:

Menghapus tag objek
Jalankan perintah berikut untuk menghapus tag objek bernama exampleobject.txt di bucket examplebucket:
```
ossutil object-tagging --method delete oss://examplebucket/exampleobject.txt
```
Menghapus tag beberapa objek
Jalankan perintah berikut untuk menghapus tag semua objek dengan awalan "test" di bucket examplebucket:
```
ossutil object-tagging --method delete oss://examplebucket/test -r
```
Jika perintah berhasil, keluaran serupa berikut dikembalikan untuk menunjukkan waktu yang digunakan untuk menghapus tag:
```
0.148970(s) elapsed
```

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket di wilayah lain, tambahkan opsi -e untuk menentukan endpoint wilayah tempat bucket berada. Jika Anda beralih ke bucket milik akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey akun tersebut, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey akun tersebut.

Sebagai contoh, jalankan perintah berikut untuk mengonfigurasi tag dengan kunci tagkey7 dan nilai tagvalue7 untuk objek bernama example.png di bucket testbucket, yang berada di wilayah China (Shanghai) dan dimiliki oleh akun Alibaba Cloud lain:

ossutil object-tagging --method put oss://testbucket/exampletest.png tagkey7#tagvalue7 -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

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