更新时间:2025-03-20 GMT+08:00

查询项目标签

功能介绍

查询特定类型资源的标签集合。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

resource_type

String

标签资源类型:

  • instance: 企业路由器实例

  • route-table: 路由表

  • vpc-attachment: VPC连接

  • vgw-attachment: 虚拟网关连接

  • peering-attachment: 对等连接(Peering)连接

  • vpn-attachment: VPN网关连接

  • ecn-attachment: 企业连接网连接

  • cfw-attachment: 云防火墙连接

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

tags

Array of Tags objects

标签列表。

表3 Tags

参数

参数类型

描述

key

String

标签键,不能为空,最大长度127个unicode字符。

values

Array of strings

值列表,每个值最大长度255个unicode字符。

请求示例

查询企业路由器标签

https://{erouter_endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/tags

响应示例

状态码:200

OK

{
  "tags" : [ {
    "key" : "keys",
    "values" : [ "value" ]
  }, {
    "key" : "key3",
    "values" : [ "value3", "value33" ]
  }, {
    "key" : "key1",
    "values" : [ "value1" ]
  }, {
    "key" : "key2",
    "values" : [ "value2", "value22" ]
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码