调用ListTagResources查询资源组或资源目录成员绑定的标签列表。

使用说明

本文将提供一个示例，查询资源组rg-aekz6bre2uq****绑定的标签列表。返回结果显示，该资源组只绑定了k1:v1一个标签。

调试

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

请求参数

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

要执行的操作。取值：ListTagResources。

NextToken String 否 caeba0bbb2be03f84eb48b699f0a****

下一个查询开始的Token。
MaxResults Integer 否 10

分页时每页显示的数据行数。

取值范围：1~100。默认值：10。
Tag.N.Key String 否 k1

标签键。
Tag.N.Value String 否 v1

标签值。
ResourceId.N String 否 rg-aekz6bre2uq****

资源组ID或资源目录成员ID。查询的过滤条件。

说明 查询资源目录成员绑定的标签列表时，必须同时指定ResourceId和ResourceType，且ResourceType取值为Account。
ResourceType String 否 ResourceGroup

资源类型。查询的过滤条件。取值：

  • ResourceGroup（默认值）：查询资源组的标签。
  • Account：查询资源目录成员的标签。

关于公共请求参数的详情，请参见公共参数。

返回数据

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

根据NextToken判断是否具备下一个查询开始的Token。取值：

  • 如果NextToken为空，即"NextToken": ""，表示没有下一个。
  • 如果NextToken有值，则该值就是下一个查询开始的Token。
RequestId String 8054B059-6B36-53BF-AA45-B8C9A0ED05AB

请求ID。
TagResources Array of TagResource

标签列表。
TagValue String k1

标签值。
ResourceId String rg-aekz6bre2uq****

资源组ID或资源目录成员ID。
TagKey String k1

标签键。
ResourceType String resourcegroup

资源类型。取值：

  • resourcegroup：资源组。
  • Account：资源目录成员。

示例

请求示例

https://resourcemanager.aliyuncs.com/?Action=ListTagResources
&ResourceId.1=rg-aekz6bre2uq****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <RequestId>8054B059-6B36-53BF-AA45-B8C9A0ED05AB</RequestId>
    <TagResources>
        <ResourceId>rg-aekz6bre2uq****</ResourceId>
        <TagKey>k1</TagKey>
        <ResourceType>resourcegroup</ResourceType>
        <TagValue>v1</TagValue>
    </TagResources>
</ListTagResourcesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "8054B059-6B36-53BF-AA45-B8C9A0ED05AB",
  "TagResources" : [ {
    "ResourceId" : "rg-aekz6bre2uq****",
    "TagKey" : "k1",
    "ResourceType" : "resourcegroup",
    "TagValue" : "v1"
  } ]
}

错误码

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