调用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"
            }
            ]
            }
            }