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

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求和返回结果文档。

请求语法

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 HTTP/1.1
公共请求头
{
"resource_type": "CLUSTER",
"resource_ids":["xxx","yyy"],
"tags":[{"key":"env","value":"dev"},{"key":"dep","value":"IT"}]
}

请求示例补充说明

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>xxxx****</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"
            }
        ]
    }
}

错误码

访问错误中心查看更多错误码。