Queries the list of tags that are added to cloud computers.
Operation description
You must specify at least one of the following parameters in the request to specify the query object: ResourceId.N, Tag.N.Key, or Tag.N.Value.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID. You can call the DescribeRegions operation to query the most recent region list supported by WUYING Workspace. |
cn-hangzhou |
| ResourceType |
string |
Yes |
The resource type. Valid values:
|
ALIYUN::GWS::INSTANCE |
| MaxResults |
integer |
No |
The number of entries per page. |
10 |
| NextToken |
string |
No |
The token that determines the start point of the next query. |
caeba0bbb2be03f84eb48b699f0a4883 |
| ResourceId |
array |
No |
The IDs of the resources, that is, the IDs of the cloud computers. Valid values of N: 1 to 50. |
ecd-ia2zw38bi6cm7**** |
|
string |
No |
The ID of the resource, that is, the ID of the cloud computer. |
ecd-ia2zw38bi6cm7**** |
|
| Tag |
array<object> |
No |
The tags. |
|
|
object |
No |
The tag. |
||
| Key |
string |
No |
The tag key. Valid values of N: 1 to 20. |
department |
| Value |
string |
No |
The tag value. Valid values of N: 1 to 20. |
design |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The returned information. |
||
| NextToken |
string |
The token that determines the start point of the next query. If this parameter is empty, no next query is to be sent. |
caeba0bbb2be03f84eb48b699f0a4883 |
| RequestId |
string |
The request ID. |
484256DA-D816-44D2-9D86-B6EE4D5BA78C |
| TagResources |
array<object> |
The resources and their tags. |
|
|
object |
The information about a resource and its tag. |
||
| TagValue |
string |
The tag value. |
design |
| ResourceType |
string |
The resource type. Valid values:
|
ALIYUN::GWS::INSTANCE |
| ResourceId |
string |
The ID of the resource, that is, the ID of the cloud computer. |
ecd-ia2zw38bi6cm7**** |
| TagKey |
string |
The tag key. |
department |
Examples
Success response
JSON format
{
"NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
"RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
"TagResources": [
{
"TagValue": "design",
"ResourceType": "ALIYUN::GWS::INSTANCE",
"ResourceId": "ecd-ia2zw38bi6cm7****",
"TagKey": "department"
}
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.