更新时间:2024-10-22 GMT+08:00

列举资源标签

功能介绍

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

调用方法

请参见如何调用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

服务器内部错误。

错误码

请参见错误码