Adding a Tag (Native OpenStack API)

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}

Table 1 lists the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
image_id	Yes	String	Specifies the image ID.
tag	Yes	String	Specifies the tag to be added. The character string cannot contain equal signs (=). 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

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.