调用 ListTagResources,查询可见的资源标签关系。

请求语法

GET /tags HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
resource_type String CLUSTER 资源类型定义。
next_token String 1d2db86sca4384811e0b5e8707e****** 下一个查询开始的 Token。
resource_ids String ["xxxxx","xxxxxx"] 要查询的集群 ID 列表。
tags String [{"key":"env","value","dev"},{"key":"dev", "value":"IT"}] 要查询的 tag 列表,采用 JSON 字符串的形式,最多包含 20 个子项限制。
说明
  • 参数 resource_ids 和 tags 二者需要选一个传入,否则提示异常信息。
  • 用户查询结果仅为可见标签,不可见标签无法查询。

返回参数

名称 类型 示例值 描述
request_id String F99407AB-2FA9-489E-A259-40CF6D****** 当前请求的 Request ID。
tag_resources Struct - 标签资源组。
tag_resource Array - 标签资源。
resource_id String xxxxx 集群 ID。
resource_type String ALIYUN::CS::CLUSTER 资源类型。
tag_key String env 标签键。
tag_value String dev 标签值。

示例

请求示例

GET /tags?
resource_ids=["xxx","yyy"]
&resource_type=CLUSTER
&tags=[{"key":"env","value":"dev"},{"key":"dep","value":"IT"}]

正常返回示例

XML格式

<request_id>3D8795D9-8FF5-46B2-86E6-E3B4073169BE</request_id>
<tag_resources>
    <tag_resource>
        <resource_type>ALIYUN::CS::CLUSTER</resource_type>
        <resource_id>xxxxx****</resource_id>
        <tag_key>env</tag_key>
        <tag_value>dev</tag_value>
    </tag_resource>
</tag_resources>

JSON格式

{
    "request_id": "3D8795D9-8FF5-46B2-86E6-E3B4073169BE",
    "tag_resources": {
        "tag_resource": [
            {
                "resource_type": "ALIYUN::CS::CLUSTER",
                "resource_id": "xxxx****",
                "tag_key": "env",
                "tag_value": "dev"
            }
        ]
    }
}