ListTagResources-阿里云帮助中心

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

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

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 : Cloud computer	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 : Cloud computer	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.