All Products
Search
Document Center

WUYING Workspace:ListTagResources

Last Updated:Apr 08, 2024

Queries the tags of cloud computers.

Operation description

You must use at least one of the following parameters in the request to determine the object that you want to query: ResourceId.N, 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
ResourceTypestringYes

The type of the resource.

Valid values:

  • ALIYUN::GWS::INSTANCE: cloud computer.
ALIYUN::GWS::INSTANCE
MaxResultsintegerNo

The number of entries per page.

10
NextTokenstringNo

The pagination token that is used in the next request to retrieve a new page of results.

caeba0bbb2be03f84eb48b699f0a4883
ResourceIdarrayNo

The resource IDs, which are cloud computer IDs. You can specify 1 to 50 IDs.

stringNo

The resource ID, which is the cloud computer ID.

ecd-ia2zw38bi6cm7****
Tagobject []No

The tags that you want to query.

KeystringNo

The tag keys. You can specify 1 to 20 tag keys.

TestKey
ValuestringNo

The tag values. You can specify 1 to 20 tag values.

TestValue

Response parameters

ParameterTypeDescriptionExample
object

Schema of response.

NextTokenstring

A pagination token. If NextToken is empty, no next page exists.

caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

The request ID.

484256DA-D816-44D2-9D86-B6EE4D5BA78C
TagResourcesobject []

The resources and their tags.

TagValuestring

The tag values.

TestValue
ResourceTypestring

The type of the resource.

Valid values:

  • ALIYUN::GWS::INSTANCE: cloud computer.
ALIYUN::GWS::INSTANCE
ResourceIdstring

The resource ID, which is the cloud computer ID.

ecd-ia2zw38bi6cm7****
TagKeystring

The tag keys.

TestKey

Examples

Sample success responses

JSONformat

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
  "TagResources": [
    {
      "TagValue": "TestValue",
      "ResourceType": "ALIYUN::GWS::INSTANCE",
      "ResourceId": "ecd-ia2zw38bi6cm7****",
      "TagKey": "TestKey"
    }
  ]
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history