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

批量添加删除资源标签

功能介绍

  • 为指定实例批量添加或删除标签

  • 标签管理服务需要使用该接口批量管理实例的标签。

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

调用方法

请参见如何调用API。

URI

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

表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参数

参数

是否必选

参数类型

描述

action

是

String

功能说明：操作标识。

取值范围：

create（创建）

delete（删除）

tags

否

Array of Tag objects

标签列表。
表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

无

请求示例

  • 批量添加资源标签。

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

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

  • 批量删除资源标签。

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

{
  "action" : "delete",
  "tags" : [ {
    "key" : "key1"
  }, {
    "key" : "key2",
    "value" : "value3"
  } ]
}

响应示例

无

状态码

状态码

描述

204

No Content

错误码

请参见错误码。

父主题： 标签