ListTagResources
Queries the tags attached to cloud resources (RAM roles and access policies).
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ram:ListTagResources |
list |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ResourceType |
string |
Yes |
The resource type. Valid values:
|
role |
| ResourceNames |
array |
No |
The list of resource names. You can specify up to 50 resource names at a time. |
|
|
string |
No |
The resource name. |
role1 |
|
| Tag |
array<object> |
No |
The list of tags. You can specify up to 20 tags at a time. |
|
|
object |
No |
The tag. |
||
| Key |
string |
No |
The tag key. The key can be up to 128 characters in length. |
t1 |
| Value |
string |
No |
The tag value. The value can be up to 256 characters in length. |
v1 |
| PageSize |
integer |
No |
The number of entries to return on each page. Valid values: 1 to 100. |
100 |
| NextToken |
string |
No |
The pagination token used to retrieve the next page. |
GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response. |
||
| RequestId |
string |
The request ID. |
5CCE804C-6450-49A7-B1DB-2460F7A97416 |
| TagResources |
array<object> |
The list of tags bound to the cloud resources. |
|
|
object |
The tag bound to the cloud resource. |
||
| ResourceName |
string |
The resource name. |
role1 |
| ResourceType |
string |
The resource type. Valid values:
|
role |
| TagKey |
string |
The tag key. |
t1 |
| TagValue |
string |
The tag value. |
v1 |
| NextToken |
string |
The pagination token used to retrieve the next page. |
GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K |
Examples
Success response
JSON format
{
"RequestId": "5CCE804C-6450-49A7-B1DB-2460F7A97416",
"TagResources": [
{
"ResourceName": "role1",
"ResourceType": "role",
"TagKey": "t1",
"TagValue": "v1"
}
],
"NextToken": "GY/oWREsOP1bPHGcHGrXfYX7UG1k9KqWFYThNDPx1UX26PbWOIu2CMqqiMr68H/K"
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.