Membuat dan menyambungkan tag ke resource tertentu.
Deskripsi operasi
Tag adalah label yang Anda tetapkan pada instans. Setiap tag terdiri dari pasangan kunci-nilai (Key-Value). Perhatikan hal-hal berikut saat Anda menggunakan tag:
-
Kunci tag dari setiap tag pada instans harus unik.
-
Tag kosong yang tidak terikat pada resource tidak didukung. Tag harus disambungkan ke resource.
-
Informasi tag tidak dibagikan lintas wilayah.
Sebagai contoh, tag yang dibuat di wilayah China (Hangzhou) tidak terlihat di wilayah China (Shanghai).
-
Dalam akun dan wilayah yang sama, informasi tag dari VPC, tabel rute, vSwitch, dan EIP dibagikan.
Sebagai contoh, dalam akun dan wilayah yang sama, jika tag disambungkan ke VPC, Anda dapat langsung memilih tag pada halaman Edit Tag dari vSwitch, tabel rute, atau EIP untuk menyambungkan tag ke resource tanpa perlu memasukkan pasangan kunci tag dan nilai tag secara manual. Anda dapat mengubah kunci dan nilai tag, atau menghapus tag resource kapan saja. Jika Anda menghapus resource, semua tag yang disambungkan ke resource tersebut juga akan dihapus.
-
Maksimal 20 tag dapat disambungkan ke resource. Sebelum Anda menyambungkan tag, Alibaba Cloud memeriksa jumlah tag yang ada pada resource. Pesan error akan dikembalikan jika batas atas terlampaui.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| ResourceType |
string |
Yes |
Tipe resource. Nilai valid:
Catatan
Nilai ResourceType tidak peka huruf besar/kecil. |
VPC |
| ResourceId |
array |
Yes |
ID resource. Anda dapat menentukan hingga 50 ID resource. |
vpc-bp16qjewdsunr41m1**** |
|
string |
No |
ID resource. Anda dapat menentukan hingga 50 ID resource. Catatan
ResourceId.N wajib diisi saat Anda memanggil API ini. |
vpc-bp16qjewdsunr41m1**** |
|
| RegionId |
string |
Yes |
ID wilayah resource tempat Anda ingin membuat dan menyambungkan tag. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah. |
cn-hangzhou |
| Tag |
array<object> |
Yes |
Informasi tag. |
TagResources |
|
object |
No |
Informasi tag. |
||
| Key |
string |
No |
Kunci tag. Anda harus menentukan setidaknya satu kunci tag dan dapat menentukan hingga 20 kunci tag. Panjang kunci tag dapat mencapai 128 karakter, dan tidak boleh diawali dengan Catatan
Tag.N.Key wajib diisi saat Anda memanggil API ini. Nilai tidak boleh berupa string kosong. |
FinanceDept |
| Value |
string |
No |
Nilai tag. Anda harus menentukan setidaknya satu nilai tag dan dapat menentukan hingga 20 nilai tag. Panjang nilai tag dapat mencapai 128 karakter, dan tidak boleh diawali dengan Catatan
Tag.N.Value wajib diisi saat Anda memanggil API ini. Nilai dapat berupa string kosong. |
FinanceJoshua |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Informasi yang dikembalikan. |
||
| RequestId |
string |
ID permintaan. |
C46FF5A8-C5F0-4024-8262-B16B639225A0 |
Contoh
Respons sukses
JSONformat
{
"RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidTagKey | The tag keys are not valid. | |
| 400 | InvalidTagValue | The tag values are not valid. | |
| 400 | MissingParam | %s | |
| 400 | InvalidInstanceType.NotFound | The instance type is not found | |
| 400 | InvalidInstanceIds.NotFound | The instanceIds are not found | |
| 400 | Forbidden.TagKeys | The request do not allow to operate the tag keys | |
| 400 | QuotaExceeded.TagNum | Custom Tags quota exceeded | |
| 400 | InvalidTagScope.NotFound | The tag scope is not found | |
| 400 | Forbidden.NotAllowedCategary | The System tag is not valid | |
| 400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | |
| 400 | SizeLimitExceeded.TagNum | The maximum number of tags is exceeded. | |
| 400 | SizeLimitExceeded.ResourceId | The maximum number of resource IDs is exceeded. | |
| 400 | MissingParameter.TagValue | The input parameter TagValue that is mandatory for processing this request is not supplied. | |
| 400 | MissingParameter.TagKey | The input parameter TagKey that is mandatory for processing this request is not supplied. | |
| 400 | MissingParam.Tags | You must specify the Tags parameter. | |
| 400 | DuplicatedParam.ResourceIds | The parameter of ResourceIds contains duplicate values. | |
| 403 | Forbidden | User not authorized to operate on the specified resource. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.