Terapkan Tata Kelola Tag pada Instans CEN Menggunakan API TagResources - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Membuat dan menyambungkan tag ke Sumber daya.

Deskripsi operasi

A tag consists of a tag key and a tag value. Both the tag key and tag value are required.
If you attach multiple tags to a Cloud Enterprise Network (CEN) instance, the tag keys must be unique for that instance.
You can attach a maximum of 20 tags to a CEN instance.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cen:TagResources

update

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ResourceType	string	Yes	Tipe Sumber daya. Nilai valid: Cen: Instans CEN. BandwidthPackage: Paket bandwidth. TransitRouter: instans Router transit. TransitRouterVpcAttachment: koneksi VPC. TransitRouterVbrAttachment: koneksi VBR. TransitRouterPeerAttachment: koneksi antar-wilayah. TransitRouterVpnAttachment: koneksi VPN. TransitRouterRouteTable: tabel rute. Flowlog: Log aliran. TransitRouterMulticastDomain: domain multicast.	cen
ResourceId	array	Yes	Daftar ID Sumber daya.	cen-7qthudw0ll6jmc****
	string	No	The resource ID. You can enter multiple resource IDs. The value of N ranges from 1 to 20.	cen-pfa6ugf3xl0qsd****
Tag	array<object>	Yes	Daftar tag.
	object	Yes	The tag.
Key	string	Yes	The tag key. You can enter multiple tag keys. The value of N ranges from 1 to 20. The tag key can be up to 64 characters in length. It cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	TagKey
Value	string	Yes	The tag value. Each tag key must have a tag value. The value of N ranges from 1 to 20. The tag value can be up to 128 characters in length. It cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	TagValue
RegionId	string	No	ID wilayah Sumber daya. Parameter ini tidak diperlukan untuk Sumber daya bertipe Cen dan BandwidthPackage. Parameter ini diperlukan untuk semua tipe Sumber daya lainnya.	cn-hangzhou

Elemen respons

Element	Type	Description	Example
	object	The response that is returned.
RequestId	string	The request ID.	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.	The error message returned because the specified tag key is invalid.
400	InvalidTagValue	The tag values are not valid.	The error message returned because the specified tag value is invalid.
400	MissingParam	%s
400	InvalidInstanceType.NotFound	The instance type is not found	The error message returned because the specified instance type does not exist.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	The error message returned because the specified instance does not exist.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	The error message returned because you cannot manage the specified tag key.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	The error message returned because the number of tags has reached the upper limit.
400	InvalidTagScope.NotFound	The tag scope is not found	The error message returned because the specified tag scope is invalid.
400	Forbidden.NotAllowedCategary	The System tag is not valid	The error message returned because you cannot configure system tags.
400	SizeLimitExceeded.ResourceIdNum	The ResourceIds parameter's number is exceed , Valid : 20
400	MissingParameter.TagValue	The specified parameter TagValue is missing	The error message returned because the TagValue parameter is not set.
400	DuplicatedParam.TagKey	The parameter TagKey is duplicated.	The error message returned because the TagKey parameter already exists.
400	IllegalParamLength.Tag	The specified length of Tag is invalid.	The error message returned because the length of the specified tag is invalid. Check the tag and try again.
400	IllegalParam.Region	The specified region is invalid.
400	MissingParameter.TagKey	TagKey must be specified.	The error message returned because you must set the TagKey parameter.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.