文档首页/ 企业路由器 ER/ API参考/ API/ 标签/ 查询资源标签
更新时间：2024-04-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询资源标签

功能介绍

查询特定类型资源的标签信息。

调用方法

请参见如何调用API。

URI

GET /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连接

  • vgw-attachment: 虚拟网关连接

  • peering-attachment: 对等连接（Peering）连接

  • vpn-attachment: VPN网关连接

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

  • cfw-attachment: 云防火墙连接

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

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

请求示例

查询企业路由器实例标签

https://{erouter_endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/f1a28dfd-186f-4625-b6b1-f05e5e8609c0/tags

响应示例

状态码： 200

OK

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

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 标签

相关文档