文档首页/ 配置审计 Config/ API参考/ API/ 资源清单/ 列举资源标签
更新时间：2024-10-22 GMT+08:00
查看PDF
分享

列举资源标签

功能介绍

查询当前账号下所有资源的标签。

调用方法

请参见如何调用API。

URI

GET /v1/resource-manager/domains/{domain_id}/all-resources/tags

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

账号ID。

最大长度：36
表2 Query参数

参数

是否必选

参数类型

描述

key

否

String

标签键名。

最大长度：128

marker

否

String

分页参数，通过上一个请求中返回的marker信息作为输入，获取当前页。

最小长度：4

最大长度：400

limit

否

Integer

最大的返回数量。

最小值：1

最大值：200

缺省值：100

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

tags

Array of TagEntity objects

标签列表。

page_info

PageInfo object

分页对象。
表5 TagEntity

参数

参数类型

描述

key

String

标签键。

value

Array of strings

标签键对应的标签值列表。
表6 PageInfo

参数

参数类型

描述

current_count

Integer

当前页的资源数量。

最小值：0

最大值：200

next_marker

String

下一页的marker。

最小长度：4

最大长度：400

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

请求示例

GET https://{endpoint}/v1/resource-manager/domains/059b5c937100d3e40ff0c00a7675a0a0/all-resources/tags

响应示例

状态码： 200

操作成功。

{
  "tags" : [ {
    "key" : "chloe",
    "value" : [ "a", "b" ]
  } ],
  "page_info" : {
    "current_count" : 1,
    "next_marker" : null
  }
}

状态码

状态码

描述

200

操作成功。

400

输入参数不合法。

403

用户认证失败。

500

服务器内部错误。

错误码

请参见错误码。

父主题： 资源清单

相关文档