Adding or Modifying a Tag
Function
This API is used to add a tag to an image or modify a tag of an image. With tags, you can manage easily the images.
URI
PUT /v1/cloudimages/tags
Request
- Request parameters
Parameter
Mandatory
Type
Description
image_id
Yes
String
Specifies the image ID.
For details about how to obtain the image ID, see Querying Images.
tag
No
String
Specifies the tag.
Use either tag or image_tag.
image_tag
No
Object
Lists the image tags. For detailed description, see Image Tag Data Formats. This parameter is left blank by default.
Use either tag or image_tag.
Table 1 Data structure description of the image_tag field Parameter
Mandatory
Type
Description
key
Yes
String
Specifies the tag key.
value
Yes
String
Specifies the tag value.
Example Request
- Adding or modifying a tag (parameter: tags)
1 2 3 4 5
PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }
- Adding or modifying a tag (parameter: image_tag)
1 2 3 4 5
PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }
Returned Values
- Normal
- Abnormal
Returned Value
Description
400 Bad Request
Request error.
401 Unauthorized
Authentication failed.
403 Forbidden
You do not have the rights to perform the operation.
404 Not Found
The requested resource was not found.
500 Internal Server Error
Internal service error.
503 Service Unavailable
The service is unavailable.
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