Deleting Tags from an ECS in a Batch
Function
- This API is used to delete tags from a specified ECS in a batch.
- The Tag Management Service (TMS) uses this API to batch manage the tags of an ECS.
- This API is idempotent. When you delete a tag but the tag does not exist, a successful result is returned.
Constraints
An ECS allows a maximum of 10 tags.
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, delete indicates the deletion operation. |
Response
None
Example Request
Batch delete two pairs of tags from a specified ECS.
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags/action { "action": "delete", "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