All Products
Search
Document Center

Object Storage Service:put-bucket-tags

Last Updated:Jul 02, 2025

Menambahkan atau memodifikasi tag pada sebuah bucket.

Catatan penggunaan

  • Secara default, akun Alibaba Cloud memiliki izin untuk menambahkan atau memodifikasi tag bucket. Untuk melakukan ini menggunakan RAM user atau Security Token Service (STS), Anda harus memiliki izin oss:PutBucketTags. Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke RAM user.

  • Saat menjalankan perintah put-bucket-tags untuk menambahkan tag ke bucket, tag baru akan menimpa tag yang sudah ada.

  • Anda dapat mengonfigurasi hingga 20 tag untuk sebuah bucket. Setiap tag merupakan pasangan key-value.

Sintaks perintah

ossutil api put-bucket-tags --bucket value --tagging value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--tagging

string

Kontainer tempat tag disimpan.

Catatan

Perintah put-bucket-tags sesuai dengan operasi PutBucketTags. Untuk informasi lebih lanjut tentang parameter dalam operasi PutBucketTags, lihat PutBucketTags.

--tagging

Opsi --tagging mendukung format XML dan JSON. Jika nilai opsi berisi awalan file://, ossutil membaca konfigurasi dari file konfigurasi.

  • 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 Global.

Contoh

Berikut adalah contoh cara menambahkan atau memodifikasi tag pada bucket bernama examplebucket.

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

    <?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-bucket-tags --bucket examplebucket --tagging file://tagging.xml
  • Buat file konfigurasi bernama tagging.json dan tambahkan kode berikut ke file konfigurasi:

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

    Contoh perintah:

    ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.json
  • Konfigurasikan parameter dalam perintah berikut dalam format JSON:

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