文档首页> 组织 Organizations> API参考> API> 标签管理> 查询资源标签
更新时间：2024-05-11 GMT+08:00
查看PDF

查询资源标签

功能介绍

查询资源标签。

URI

GET /v1/organizations/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

String

资源类型。枚举值：organizations:policies（服务策略）、organizations:ous（组织OU）、organizations:accounts（账号信息） 、organizations:roots：（根）。

枚举值：

  • organizations:policies

  • organizations:ous

  • organizations:accounts

  • organizations:roots

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

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

最小值：1

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

tags

Array of TagsDTO objects

自定义标签键值对。
表4 TagsDTO

参数

参数类型

描述

key

String

键。最大长度127个unicode字符。 key不能为空。

最小长度：1

最大长度：128

values

Array of strings

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

最小长度：0

最大长度：255

数组长度：0 - 10

请求示例

查询资源标签

GET https://{hostname}/v1/organizations/{resource_type}/tags

响应示例

状态码： 200

Successful

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "velua2" ]
  } ]
}

状态码

状态码

描述

200

Successful

错误码

请参见错误码。

父主题： 标签管理