调用ListTagResources，查询一个或多个EMR集群已经绑定的标签列表。

调用该接口时注意以下信息：

  • 请求中至少指定一个参数：ResourceId.N、Tag.N（Tag.N.Key与Tag.N.Value），以确定查询对象。
  • 同时指定Tag.N和ResourceId.N时，返回结果中仅包含同时满足这两个条件的EMR集群。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 ListTagResources

系统规定参数。对于您自行拼凑HTTP或HTTPS URL发起的API请求，该参数为必选参数。取值：ListTagResources。
RegionId String 是 cn-hangzhou

地域ID。您可以调用DescribeRegions接口查看最新的阿里云地域列表。

ResourceType String 是 cluster

资源类型。EMR集群为cluster。
ResourceId.N RepeatList 否 C-3652B95F65967***

EMR集群ID，您可以调用ListClusters查看集群的ID。N的取值范围：1~50。

Tag.N.Key String 否 DevDept

精确查找EMR集群时使用的标签键。标签键的取值范围：1~128。N的取值范围：1~20。

Tag.N用于精确查找绑定了指定标签的EMR集群，由一个键值对组成。

  • 仅指定Tag.N.Key时，则返回关联该标签键的所有集群。
  • 仅指定Tag.N.Value，则报错MissingParameter.TagKey。
  • 同时指定多个标签键值对时，仅同时满足所有标签键值对的EMR集群会被查找到。
Tag.N.Value String 否 DevNianmin

精确查找EMR集群时使用的标签值，您可以调用ListTagResources查看。标签值的取值范围：1~128。N的取值范围：1~20。

NextToken String 否 caeba0bbb2be03f84eb48b699f0a****

下一个查询开始Token。

返回数据

名称 类型 示例值 描述
NextToken String caeba0bbb2be03f84eb48b699f0a****

下一个查询开始Token。
RequestId String DE65F6B7-7566-4802-9007-96F2494AC5XX

请求ID。
TagResources Array of TagResource

由集群及其标签组成的集合，包含了集群ID、资源类型和标签键值等信息。
TagResource
ResourceId String C-3652B95F6596****

集群ID。
ResourceType String cluster

资源类型。EMR集群为cluster。
TagKey String DevDept

标签键。
TagValue String DevNianmin

标签值。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=cluster
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>DE65F6B7-7566-4802-9007-96F2494AC5XX</RequestId>
<NextToken>caeba0bbb2be03f84eb48b699f0a****</NextToken>
<TagResources>
    <TagResource>
        <ResourceId>C-3652B95F6596****</ResourceId>
        <TagKey>DevDept</TagKey>
        <ResourceType>cluster</ResourceType>
        <TagValue>DevNianmin</TagValue>
    </TagResource>
</TagResources>

JSON 格式 

{
    "RequestId":"DE65F6B7-7566-4802-9007-96F2494AC5XX",
    "NextToken":"caeba0bbb2be03f84eb48b699f0a****",
    "TagResources":{
        "TagResource":[
            {
            "ResourceId":"C-3652B95F6596****",
            "TagKey":"DevDept",
            "ResourceType":"cluster",
            "TagValue":"DevNianmin"
            }
            ]
            }
            }