文档首页/ 镜像服务 IMS/ API参考/ 公共参数/ 镜像标签数据格式
更新时间:2026-06-23 GMT+08:00
分享

镜像标签数据格式

概念

镜像标签可供给用户对私有镜像进行自定义标记。通过镜像标签,用户可以自由地对私有镜像分类管理。

每个镜像最多可以添加20个标签,实际请以控制台显示为准。

镜像标签数据格式

  • tag标签数据规范的格式为“key.value”,新增key为增加标签,否则为修改标签。

    当标签数据出现多个小数点时,定义第一个小数点之前的为key,之后为value。如果分割后的value中依然包含小数点,将视为value的一部分;如果没有小数点,则value视为空字符串。

  • image_tags新规范标签数据格式为{"key":"keyA","value":"valueA"},如果添加的keyA已存在,视为更新标签。
  • key的长度范围为1~128个字符,key不允许为空。
  • value的长度范围为0~255个字符,value可以为空字符串。
  • 多个标签的key不允许重复。
  • key的取值可以包含如下字符:
    • UNICODE字符(\u4E00-\u9FFF)
    • A-Z、a-z
    • 0-9
    • 标准空格以及_ . : + - @

      key不能以空格字符作为开头和结尾。

  • value的取值可以包含如下字符:
    • UNICODE字符(\u4E00-\u9FFF)
    • A-Z、a-z
    • 0-9
    • 标准空格以及_ . : / + - @

      value不能以空格字符作为开头和结尾。

镜像标签数据格式(OpenStack原生)

tag数据格式:
  • 标签数据规范的格式为“key”,新增key为增加标签,否则为修改标签。
  • key的长度不超过255个字符。
  • 字符串中不能包含“=”。

相关文档