Help Center/
Image Management Service/
API Reference/
IMS APIs/
Image Tagging/
Deleting Image Tags in a Batch
Updated on 2025-05-06 GMT+08:00
Deleting Image Tags in a Batch
Function
This API is used to batch delete tags from a specified image.
Constraints
- This API is idempotent. If any tag does not exist, it is considered as deleted by default.
- The system does not check characters of keys and values. A key cannot be left blank or be an empty string. Values are optional for keys. If a tag to be deleted does not exist, the system considers that it has been deleted. No error will be reported. The system will check key and value lengths. A key can contain a maximum of 127 characters, and a value can contain a maximum of 255 characters.
URI
DELETE /v1/{project_id}/cloudimages/{image_id}/tags/delete
Table 1 lists the parameters in the URI.
Request
- Request parameters
Parameter
Mandatory
Type
Description
tags
Yes
Array of objects
Lists the tags to be deleted. For details, see Table 2.
Example Request
Deleting image tags (key1:value1, key2:value2)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
DELETE https://{Endpoint}/v1/fd73a4a14a4a4dfb9771a8475e5198ea/cloudimages/67e17426-359e-49fb-aa12-0bd1756ec240/tags/delete { "tags": [ { "value": "value1", "key": "key1" }, { "value": "value2", "key": "key2" }, { "key": "key3", "value": "" } ] } |
Returned Values
Parent topic: Image Tagging
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.
The system is busy. Please try again later.
For any further questions, feel free to contact us through the chatbot.
Chatbot