Help Center/ Image Management Service/ API Reference/ Common Parameters/ Image Tag Format
Updated on 2025-04-10 GMT+08:00
View PDF

Image Tag Format

Description

You can attach a custom tag to a private image to facilitate private image management.

Format

Format of tag
  • The format is key.value. If a key is added, a tag is added. In other cases, the tag is updated.
  • If a tag contains multiple decimal points, the content before the first decimal point is the key, and that after the first decimal point is the value. If a tag contains no decimal point, the value is regarded as an empty string.
  • The tag key can contain a maximum of 36 characters, and the tag value can contain a maximum of 43 characters. The tag value can be an empty character string.
  • The tag key can only consist of digits, letters, underscores (_), and hyphens (-).
  • The tag key must be unique and cannot be empty.
  • The tag value can only consist of digits, letters, underscores (_), periods (.), and hyphens (-).
Format of image_tags
  • The format is {"key":"keyA", "value":"valueA"}. If a key already exists when you add it, the tag will be updated.
  • The tag key can contain a maximum of 36 characters, and the tag value can contain a maximum of 43 characters. The tag value can be an empty character string.
  • The tag key can only consist of digits, letters, underscores (_), and hyphens (-).
  • The tag key must be unique and cannot be empty.
  • The tag value can only consist of digits, letters, underscores (_), periods (.), and hyphens (-).

Format (Native OpenStack)

Format of tag
  • The format is key. If a key is added, a tag is added. In other cases, the tag is updated.
  • The tag key can contain a maximum of 255 characters.
  • The character string cannot contain equal signs (=).
Parent topic: Common Parameters