文档首页/云专线 DC/API参考（吉隆坡区域）/API/标签管理/添加资源标签
更新时间：2024-07-25 GMT+08:00
在线调试
CLI示例
查看PDF
分享

添加资源标签

功能介绍

  • 一个资源上最多有10个标签。
  • 此接口为幂等接口：
  • 创建时，如果创建的标签已经存在（key相同），则覆盖。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

resource_id

是

String

资源实例ID

resource_type

是

String

  • 专线服务资源类型，包括dc-directconnect/dc-vgw/dc-vif
  • dc-directconnect: 专线物理连接
  • dc-vgw： 虚拟网关
  • dc-vif： 虚拟接口

枚举值：

  • dc-directconnect
  • dc-vgw
  • dc-vif

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tag

是

Tag object

资源标签。

表3 Tag

参数

是否必选

参数类型

描述

key

是

String

标签键，最大长度36个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，中文。

最小长度：0

最大长度：36

value

否

String

标签值，最大长度43个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，点“.”，中文。

最小长度：0

最大长度：43

响应参数

无

请求示例

添加资源标签

POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags

{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}

响应示例

无

状态码

状态码

描述

204

No Content

错误码

请参见错误码。

父主题：标签管理