ListTagResources - Resource Access Management - Alibaba Cloud Documentation Center

Queries the tags that are added resources.

Operation description

You must specify at least one of the following parameters or parameter pairs in a request to determine a query object:

ResourceId.N
Tag.N.Key
Tag.N.Key and Tag.N.Value

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
ResourcePrincipalName	array	No	The name of resource N. Valid values of N: 1 to 50. If ResourceType is set to user, the resource name is the name of the RAM user. Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
	string	No	The name of resource N. Valid values of N: 1 to 50. If ResourceType is set to user, the resource name is the name of the RAM user. Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.	test@example.onaliyun.com
NextToken	string	No	The token that is used to initiate the next request if the response of the current request is truncated. You can use the token to initiate another request and obtain the remaining records.	caeba0bbb2be03f84eb48b699f0a4883
PageSize	integer	No	The number of entries per page. If a response is truncated because it reaches the value of PageSize, the value of IsTruncated will be true. Valid values: 1 to 100. Default value: 100.	2
ResourceType	string	Yes	The type of the resource. Valid value: user: a RAM user	user
ResourceId	array	No	The ID of resource N. Valid values of N: 1 to 50. If ResourceType is set to user, the resource ID is the ID of the RAM user. Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.
	string	No	The ID of resource N. Valid values of N: 1 to 50. If ResourceType is set to user, the resource ID is the ID of the RAM user. Note You must specify only one of the following parameters: ResourceId and ResourcePrincipalName.	20732900249392****
Tag	object []	No	The tag value. Valid values of N: 1 to 20. N must be consecutive.
Key	string	No	The key of tag N. Valid values of N: 1 to 20. N must be consecutive.	operator
Value	string	No	The value of tag N. Valid values of N: 1 to 20. N must be consecutive.	alice

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
NextToken	string	The marker. This parameter is returned only if the value of IsTruncated is true. If the parameter is returned, you can call this operation again and set this parameter to obtain the truncated part.	caeba0bbb2be03f84eb48b699f0a****
RequestId	string	The request ID.	4BE83135-0B08-467C-B3A2-27B312FD0F57
TagResources	object []	The tag key.
ResourceType	string	The type of the resource. Valid values: user: a RAM user	user
TagValue	string	The tag value.	alice
ResourceId	string	The ID of the resource.	20732900249392****
TagKey	string	The tag key.	operator
IsTruncated	boolean	Indicates whether the response is truncated. Valid values: true false	true

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time

Summary of changes

Operation

2023-09-19

The internal configuration of the API is changed, but the call is not affected

see changesets

Change item	Change content
	The internal configuration of the API is changed, but the call is not affected.