更新时间:2024-11-15 GMT+08:00

批量添加资源标签

功能介绍

为指定实例批量添加标签。

调用方法

请参见如何调用API

URI

POST /v5/{project_id}/{resource_type}/{resource_id}/tags/create

表1 参数说明

名称

类型

是否必选

说明

project_id

String

项目ID,可以通过获取项目ID获取项目ID。

resource_type

String

  • 功能说明:资源类型。
  • 取值范围:vpn-gateway,customer-gateway,vpn-connection。

resource_id

String

资源ID。

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    是否必选

    描述

    tags

    Array of ResourceTag objects

    • 功能说明:标签列表。
    • 约束:最多填写20个。
    表3 ResourceTag

    名称

    类型

    是否必选

    描述

    key

    String

    • 功能说明:标签的键。
    • 取值范围:1-128个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。

    value

    String

    • 功能说明:标签的值。
    • 取值范围:0-255个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。
  • 请求样例
    POST https://{Endpoint}/v5/{project_id}/{resource_type}/{resource_id}/tags/create
    {
        "tags": [{
            "key": "key1",
            "value": "value1"
        }]
    }

响应消息

  • 响应参数

    返回状态码为 204: 添加标签成功。

状态码

请参见状态码