Adding Tags to an ECS in a Batch
Function
- This API is used to add tags to a specified ECS in a batch.
- The Tag Management Service (TMS) uses this API to batch manage the tags of an ECS.
Constraints
- An ECS allows a maximum of 10 tags.
- This API is idempotent.
During tag creation, if a tag exists (both the key and value are the same as those of an existing tag), the tag is successfully processed by default.
- A new tag will overwrite the original one if their keys are the same and values are different.
- This API supports checking fine-grained permissions for enterprise projects. For details, see ecs:cloudServers:batchSetServerTags.
URI
POST /v1/{project_id}/cloudservers/{server_id}/tags/action
Parameter |
Mandatory |
Description |
---|---|---|
project_id |
Yes |
Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
server_id |
Yes |
Specifies the ECS ID. |
Request
Table 2 describes the request parameters.
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tags |
Yes |
Array of objects |
Specifies tags. For details, see Table 3. |
action |
Yes |
String |
Specifies the operation. (Only lowercase letters are supported.) For example, create indicates the creation operation. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
Yes |
String |
Specifies the tag key.
|
value |
Yes |
String |
Specifies the tag value.
|
Response
None
Example Request
Batch add two pairs of tags to a specified ECS.
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
Example Response
None
Returned Values
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot