更新时间:2024-03-25 GMT+08:00

为指定云硬盘批量添加标签

功能介绍

为指定云硬盘批量添加标签。

  • 添加标签时,如果云硬盘的标签已存在相同key,则会覆盖已有标签。
  • 单个云硬盘最多支持创建10个标签。

接口约束

URI

  • URI格式

    POST /v2/{project_id}/os-vendor-volumes/{volume_id}/tags/action

  • 参数说明

    参数

    是否必选

    描述

    project_id

    项目ID。

    获取方法请参见获取项目ID

    volume_id

    云硬盘ID。

请求消息

  • 请求参数

    参数

    参数类型

    是否必选

    描述

    tags

    List<resource_tag>

    标签列表,请参见•resource_tag 参数数据结构说明

    action

    String

    操作标识,请注意使用小写字母。

    create:添加标签

  • resource_tag参数数据结构说明

    参数

    参数类型

    是否必选

    描述

    key

    String

    标签键。同一资源的key值不能重复。
    • 最大长度36个字符。
    • 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

    value

    String

    标签值。
    • 每个值最大长度43个字符,可以为空字符串。
    • 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。
  • 请求样例
    {
        "action": "create", 
        "tags": [
            {
                "key": "key1", 
                "value": "value1"
            }, 
            {
                "key": "key2", 
                "value": "value3"
            }
        ]
    }

响应消息

状态码

  • 正常

    204

错误码

请参考错误码