文档首页/ 企业路由器 ER/ API参考 (联盟区域) / API/ 标签/ 创建资源标签
更新时间：2026-01-08 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建资源标签

功能介绍

为特定类型的资源创建标签。

接口约束

  • 一个资源上最多有20个标签。

  • 此接口为幂等接口。

  • 创建时，如果创建的标签已经存在（key相同），则覆盖。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

resource_id

是

String

资源ID

resource_type

是

String

标签资源类型:

  • instance: 企业路由器实例

  • route-table: 路由表

  • vpc-attachment: VPC连接

  • vpn-attachment: VPN网关连接

  • gdgw-attachment: 下一代网关连接

  • cfw-attachment: 云防火墙连接

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tag

是

Tag object

资源标签
表3 Tag

参数

是否必选

参数类型

描述

key

否

String

标签键，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • _sys_开头属于系统标签，租户不能输入。

  • 标签key不能为空（长度不能为0）。

  • 长度在1-128之间。

最小长度：1

最大长度：128

value

否

String

标签值，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • 资源标签值可以为空（empty or null）。

  • 长度在0-255之间。

最小长度：0

最大长度：255

响应参数

状态码：204

No Content

无

请求示例

为企业路由器资源添加标签，标签值为key1，标签键为value1

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

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

响应示例

无

状态码

状态码

描述

204

No Content

错误码

请参见错误码。

父主题： 标签