put-object-tagging -

Perintah put-object-tagging digunakan untuk menambahkan atau mengedit tag pada sebuah objek.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk menambahkan atau mengedit tag sebuah objek. Jika menggunakan pengguna RAM atau Security Token Service (STS), diperlukan izin oss:PutObjectTagging. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Setiap tag yang ditambahkan ke sebuah objek adalah pasangan nilai-kunci. Anda dapat menambahkan hingga 10 tag ke sebuah objek. Tag harus memiliki kunci unik. Kunci tag dapat mencapai panjang hingga 128 karakter, sedangkan nilai tag dapat mencapai panjang hingga 256 karakter. Kunci dan nilai bersifat peka terhadap huruf besar/kecil serta dapat berisi huruf, angka, spasi, dan karakter khusus berikut: +-=._:/.
Mengedit tag sebuah objek tidak memperbarui parameter Last-Modified dari objek tersebut.

Sintaks perintah

ossutil api put-object-tagging --bucket value --key value --tagging value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--key	string	Jalur lengkap objek.
--tagging	string	Tag.
--version-id	string	ID versi objek.

Catatan

Perintah put-object-tagging sesuai dengan operasi PutObjectTagging. Untuk detail lebih lanjut tentang parameter dalam operasi PutObjectTagging, lihat PutObjectTagging.

--tagging

Opsi konfigurasi --tagging mendukung format XML dan JSON. Jika nilai opsi ini diawali dengan 'file://', parameter konfigurasi akan dibaca dari file yang ditentukan.

Format XML:

<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

Format JSON:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "string",
        "Value": "string"
      },
      ...
    ]
  }
}

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah.

Contoh

Tambahkan atau edit tag untuk exampleobject.

Buat file konfigurasi bernama tagging.xml dan tambahkan kode berikut:

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

Contoh perintah:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.xml

Buat file konfigurasi bernama tagging.json dan tambahkan kode berikut:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "key1",
        "Value": "value1"
      },
      {
        "Key": "key2",
        "Value": "value2"
      }
    ]
  }
}

Contoh perintah:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.json

Konfigurasikan parameter dalam perintah berikut dalam format JSON:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging "{\"TagSet\":{\"Tag\":[{\"Key\":\"key1\",\"Value\":\"value1\"},{\"Key\":\"key2\",\"Value\":\"value2\"}]}}"