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