ListTagResources - API Reference| Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only common request headers. For more information, see the Common request parameters topic.

Request syntax

GET /tags

Request parameters


Parameter	Type	Position	Required	Example	Description
resource_ids	Array of String	Query	Yes	c71cf3d796c374bf48644482cb0c3****	The ID of the cluster.
tags	Array	Query	No	[{\"key\":\"env\",\"value\",\"dev\"},{\"key\":\"dev\", \"value\":\"IT\"}]	The list of tags to be queried. You can specify up to 20 subitems.
key	String	Query	No	ack.aliyun.com	The key of the tag to be queried.
value	String	Query	No	c71cf3d796c374bf48644482cb0c3****	The value of the tag to be queried.
next_token	String	Query	No	***	The token that is used to start the next query.

Response parameters


Parameter	Type	Example	Description
next_token	String	*****	The token that is used to start the next query.
request_id	String	E368C761-F8F6-4A36-9B58-BD53D5CD0CEB	The ID of the request.
tag_resources	object		The tags of the queried resources.
tag_resource	Array of tag_resource		The tags of the queried resource.
tag_key	String	ack.aliyun.com	The key of the returned tag.
tag_value	String	c71cf3d796c374bf48644482cb0c3****	The value of the returned tag.
resource_id	String	i-xxx	The ID of the resource.
resource_type	String	CLUSTER	The type of the resource.

Examples

Sample requests

GET /tags HTTP/1.1 
Common request header
{
    "resource_ids":[
        "c71cf3d796c374bf48644482cb0c3****"
    ],
    "next_token":"***",
    "tags":[
        {
            "value":"c71cf3d796c374bf48644482cb0c3****",
            "key":"ack.aliyun.com"
        }
    ]
}

Sample success responses

XML format

<tag_resources>
    <tag_resource>
        <tag_value>c71cf3d796c374bf48644482cb0c3****</tag_value>
        <resource_type>CLUSTER</resource_type>
        <resource_id>i-xxx</resource_id>
        <tag_key>ack.aliyun.com</tag_key>
    </tag_resource>
</tag_resources>
<next_token>*****</next_token>
<request_id>E368C761-F8F6-4A36-9B58-BD53D5CD0CEB</request_id>

JSON format

{
  "tag_resources": {
    "tag_resource": [
      {
        "tag_value": "c71cf3d796c374bf48644482cb0c3****",
        "resource_type": "CLUSTER",
        "resource_id": "i-xxx",
        "tag_key": "ack.aliyun.com"
      }
    ]
  },
  "next_token": "*****",
  "request_id": "E368C761-F8F6-4A36-9B58-BD53D5CD0CEB"
}

Error codes

For a list of error codes, visit the API Error Center.