This API is used to add a custom tag to an image. With tags, you can manage easily the images.
PUT /v2/images/{image_id}/tags/{tag}
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
image_id |
Yes |
String |
Specifies the image ID. |
tag |
Yes |
String |
Specifies the tag to be added. The tag can contain only digits, letters, underscores (_), and hyphens (-). NOTE:
This API can only be used to add a tag key. To add a tag value, use the PUT /v1/cloudimages/tags API. For details, see Adding or Modifying a Tag. |
Request parameters
None
Adding an image tag
PUT https://{Endpoint}/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/tags/aaaa
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. |