更新时间:2025-09-04 GMT+08:00
分享

查询资源标签

功能介绍

云资源较多时,可以通过标签管理服务管理账户下的云资源,可以通过查询资源标签 查询资源信息等。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/resources/{resource_id}/tags

表1 路径参数

参数

是否必选

参数类型

描述

resource_id

String

参数解释:

需要添加标签对应的资源id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

[数组元素]

Array of TagResponse objects

参数解释:

标签键值对。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 TagResponse

参数

参数类型

描述

key

String

参数解释:

标签的key。

取值范围:

标签的键允许包含任意语种字母、数字、空格和_ . : = + - @特殊字符,但首尾不能含有空格,不能以_sys_开头,限制长度最长128个字符。

value

String

参数解释:

标签的value。

取值范围:

标签的值允许包含任意语种字母、数字、空格和_ . : / = + - @特殊字符,但首尾不能含有空格,限制长度最长255个字符。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

字符串,长度8~36个字符之间。

error_msg

String

参数解释:

错误描述。

取值范围:

字符串,长度2~512个字符之间。

请求示例

查询资源标签。

GET https://{Endpoint}/v1/resources/{resource_id}/tags

响应示例

状态码:200

查询资源标签成功。

[ {
  "key" : "string",
  "value" : "string"
} ]

状态码

状态码

描述

200

查询资源标签成功。

400

查询资源标签失败。

错误码

请参见错误码

相关文档