更新时间:2022-01-25 GMT+08:00

添加资源标签

功能介绍

为指定实例添加标签。

一个资源上最多有10个标签。

此接口为幂等接口:

创建时,如果创建的标签已经存在(key相同),则覆盖。

URI

POST /v2/{project_id}/{resource_type}/{resource_id}/tags

参数说明请参见表1
表1 URI格式的参数说明

名称

是否必选

参数类型

说明

project_id

String

项目ID。通过获取项目ID获取。

resource_type

String

资源的类型:DNS-public_zone,DNS-private_zone,DNS-public_recordset,DNS-private_recordset,DNS-ptr_record。

resource_id

String

资源id。

请求

  • 参数说明
    表2 请求样例的参数说明

    名称

    是否必选

    参数类型

    说明

    tag

    Object

    标签。

    详细信息请参见表3

    表3 tag参数数据结构说明

    名称

    是否必选

    参数类型

    说明

    key

    String

    键。最大长度36个unicode字符。 key不能为空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

    value

    String

    值。每个值最大长度43个unicode字符,可以为空字符串。 不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

  • 请求样例
    为Zone ID为“ff8080825b8fc86c015b94bc6f8712c3”的内网域名添加标签。
    POST https://{DNS_Endpoint}/v2/{project_id}/DNS-private_zone/ff8080825b8fc86c015b94bc6f8712c3/tags
    {
        "tag": {
            "key": "key1", 
            "value": "value1"
        }
    }

响应

返回值

接口正常的返回值为2xx,例如200、202或者204。

返回值含义以及更多返回值请参考状态码