调用ListTagResources查询资源绑定的标签列表。

使用说明

请求中至少指定以下任一参数，以确定查询对象：

  • ResourceId.N
  • Tag.N.Key
  • Tag.N.Key和Tag.N.Value

调试

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

请求参数

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

要执行的操作。取值：ListTagResources。
ResourceType String 是 user

资源类型。取值：

  • user：RAM用户。
ResourceId.N String 否 20732900249392****

资源ID。

N的取值范围为：1~50。 当资源类型为user时，资源ID为RAM用户ID。

说明 必须指定 ResourceId、ResourcePrincipalName两个参数中的一个参数，但不能同时指定。
ResourcePrincipalName.N String 否 test@example.onaliyun.com

资源名称。

N的取值范围为：1~50。 当资源类型为user时，资源名称为RAM用户名。

说明 必须指定 ResourceId、ResourcePrincipalName两个参数中的一个参数，但不能同时指定。
Tag.N.Key String 否 operator

标签键。

N的取值范围：1~20，N必须连续。
Tag.N.Value String 否 alice

标签值。

N的取值范围：1~20，N必须连续。
NextToken String 否 caeba0bbb2be03f84eb48b699f0a4883

当请求的返回结果被截断时，可以使用NextToken获取从当前截断位置之后的内容。
PageSize Integer 否 2

返回结果的条数。当返回结果达到PageSize限制被截断时，返回参数IsTruncated将等于true。

取值范围：1~100。默认值：100。

返回数据

名称 类型 示例值 描述
RequestId String 4BE83135-0B08-467C-B3A2-27B312FD0F57

请求ID。
TagResources Array of TagResource

资源绑定的标签列表。
TagResource
ResourceType String user

资源类型。取值：

  • user：RAM用户。
ResourceId String 20732900249392****

资源ID。
TagKey String operator

标签键。
TagValue String alice

标签值。
NextToken String caeba0bbb2be03f84eb48b699f0a****

当IsTruncated为true时才有此参数，当返回true时，需要继续调用此接口，使用NextToken获取截断后的内容。
IsTruncated Boolean true

请求返回结果是否被截断。取值：

  • true
  • false

示例

请求示例

https://[Endpoint]/?Action=ListTagResources
&ResourceType=user
&ResourceId.1=20732900249392****
&Tag.1.Key=operator
&Tag.1.Value=alice
&Tag.2.Key=owner
&Tag.2.Value=bob
&PageSize=2
&NextToken=caeba0bbb2be03f84eb48b699f0a****
&<公共请求参数>

正常返回示例

XML格式

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

<ListTagResourcesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <RequestId>4BE83135-0B08-467C-B3A2-27B312FD0F57</RequestId>
    <TagResources>
        <ResourceType>user</ResourceType>
        <ResourceId>20732900249392****</ResourceId>
        <TagKey>operator</TagKey>
        <TagValue>alice</TagValue>
    </TagResources>
    <TagResources>
        <ResourceType>user</ResourceType>
        <ResourceId>20732900249392****</ResourceId>
        <TagKey>owner</TagKey>
        <TagValue>bob</TagValue>
    </TagResources>
    <IsTruncated>true</IsTruncated>
</ListTagResourcesResponse>

JSON格式

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

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId" : "4BE83135-0B08-467C-B3A2-27B312FD0F57",
  "TagResources" : [ {
    "ResourceType" : "user",
    "ResourceId" : "20732900249392****",
    "TagKey" : "operator",
    "TagValue" : "alice"
  }, {
    "ResourceType" : "user",
    "ResourceId" : "20732900249392****",
    "TagKey" : "owner",
    "TagValue" : "bob"
  } ],
  "IsTruncated" : true
}

错误码

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