All Products
Search
Document Center

:Buat dan tambahkan tag

Last Updated:May 29, 2026

Anda dapat memanggil operasi TagResources untuk membuat dan menambahkan tag ke instans.

Jika Anda memiliki banyak instans, Anda dapat membuat beberapa tag dan menambahkannya ke instans tersebut, lalu memfilter instans berdasarkan tag.

  • Tag terdiri dari kunci dan nilai. Setiap kunci harus unik dalam satu wilayah untuk satu Akun Alibaba Cloud. Kunci yang berbeda dapat memiliki nilai yang sama.
  • Jika tag yang Anda tentukan belum ada, tag tersebut akan dibuat secara otomatis dan ditambahkan ke instans yang ditentukan.
  • Jika kunci tag yang ditentukan sama dengan kunci tag yang sudah ada, tag yang ditentukan akan menggantikan tag yang sudah ada.
  • Anda dapat menambahkan hingga 20 tag ke satu instans.
  • Anda dapat menambahkan tag ke maksimal 50 instans dalam satu panggilan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter Type Wajib Contoh Deskripsi
Action String Yes TagResources

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke TagResources.

RegionId String Yes cn-hangzhou

ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

ResourceType String Yes INSTANCE

Jenis resource. Tetapkan nilainya ke INSTANCE.

ResourceId.N String Yes rm-uf6wjk5xxxxxxx

ID instans. Anda dapat menambahkan tag ke N instans sekaligus. Nilai N yang valid: 1 hingga 50.

Tag.N.Key String Yes testkey1

Kunci tag yang ingin Anda tambahkan ke instans. Anda dapat membuat N kunci tag sekaligus. Nilai N yang valid: 1 hingga 20. Parameter ini tidak boleh berupa string kosong.

Tag.N.Value String No testvalue1

Nilai tag yang terkait dengan kunci tag yang ditentukan. Anda dapat membuat N nilai tag sekaligus. Nilai N yang valid: 1 hingga 20. Parameter ini boleh berupa string kosong.

Parameter respons

Parameter Type Contoh Deskripsi
RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

ID permintaan.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
<RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

Kode kesalahan

Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
400 NumberExceed.Tags The maximum number of Tags is exceeded. The maximum value is 20. Pesan kesalahan yang dikembalikan karena jumlah tag yang dibuat melebihi batas maksimum. Anda dapat membuat hingga 20 tag untuk satu instans.
400 MissingParameter The parameter - Tags should not be null Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key tidak ditentukan.
400 InvalidTagKey.Malformed The Tag.N.Key parameter is blank Pesan kesalahan yang dikembalikan karena nilai parameter Tag.N.Key merupakan string kosong.
400 InvalidTagValue.Malformed The Tag.N.Value parameter is blank Pesan kesalahan yang dikembalikan karena nilai parameter Tag.N.Value kosong.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key menentukan kunci yang duplikat.
400 OperationDenied.QuotaExceed The maximum number of Tags is exceeded. Pesan kesalahan yang dikembalikan karena jumlah tag yang dibuat melebihi batas maksimum.
400 NumberExceed.ResourceIds The maximum number of ResourceIds is exceeded. The maximum value is 50. Pesan kesalahan yang dikembalikan karena jumlah ID instans melebihi batas maksimum. Anda dapat menentukan hingga 50 ID instans.
400 InvalidTagKey.Malformed The operator is not permission for the system tag Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk melakukan operasi pada tag sistem.
400 Request.NotFound The requested resource is not available. Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia.
400 InvalidTagValue.Malformed The Tag.N.Value parameter is invalid. Pesan kesalahan yang dikembalikan karena nilai parameter Tag.N.Value tidak valid.

Untuk daftar kode kesalahan, kunjungi API Error Center.