Tags allow you to organize your container images. This gives you the possibility of sorting and filtering your images in any organizational pattern of your choice, which in turn helps you arrange, control and monitor your cloud resources. You can assign as many tags as you want to each image.
List tags
List all tags for a given image, specified by region. By default, the tags listed are ordered by creation date in ascending order. This can be modified via the order_by field. You can also define additional parameters for your query, such as the name.
path Parameters
regionThe region you want to target
image_idUUID of the image.
query Parameters
pageA positive integer to choose the page to display.
page_sizeA positive integer lower or equal to 100 to select the number of items to display.
order_byCriteria to use when ordering tag listings. Possible values are created_at_asc, created_at_desc, name_asc, name_desc, region, status_asc and status_desc. The default value is created_at_asc.
nameFilter by the tag name (exact match).
List tags › Responses
Paginated list of tags that match the selected filters.
total_countTotal number of tags that match the selected filters.
Get a tag
Retrieve information about a given image tag, specified by its tag_id and region. Full details about the tag, such as name, image_id, status, and digest are returned in the response.
path Parameters
regionThe region you want to target
tag_idUUID of the tag.
Get a tag › Responses
idUUID of the tag.
nameTag name, unique to an image.
image_idImage ID the of the image the tag belongs to.
statusTag status.
digestHash of the tag content. Several tags of a same image may have the same digest.
created_atDate and time of creation. (RFC 3339 format)
updated_atDate and time of last update. (RFC 3339 format)
Delete a tag
Delete a given image tag. You must specify, in the endpoint, the region and tag_id parameters of the tag you want to delete.
path Parameters
regionThe region you want to target
tag_idUUID of the tag.
query Parameters
forceIf two tags share the same digest the deletion will fail unless this parameter is set to true (deprecated).
Delete a tag › Responses
idUUID of the tag.
nameTag name, unique to an image.
image_idImage ID the of the image the tag belongs to.
statusTag status.
digestHash of the tag content. Several tags of a same image may have the same digest.
created_atDate and time of creation. (RFC 3339 format)
updated_atDate and time of last update. (RFC 3339 format)