Updated on 2026-07-07 GMT+08:00

Image Tag Format

Description

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

A maximum of 20 tags can be added to an image. You can check on the console how many tags you can add.

Format

  • For 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.

  • For image_tags, the format is {"key":"keyA", "value":"valueA"}. If a key already exists when you add it, the tag will be updated.
  • A key contains 1 to 128 characters and cannot be left blank.
  • A value contains 0 to 255 characters and can be an empty string.
  • Keys must be unique for each tag.
  • Keys can be:
    • Unicode characters (\u4E00 to \u9FFF)
    • Letters
    • Digits
    • Spaces and underscores (_) :+-@

      A key cannot start or end with a space.

  • Values can be:
    • Unicode characters (\u4E00 to \u9FFF)
    • Letters
    • Digits
    • Spaces and underscores (_) :/+-@

      A value cannot start or end with a space.

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 (=).