Query tags of specified resources by using DescribeTagResources - CDN - Alibaba Cloud - CDN

Queries the tags attached to specified CDN domain resources.

Operation description

The maximum call rate for this operation is 10 times per second per user.

Debugging

Run this operation directly in OpenAPI Explorer to skip manual signature calculation. After a successful run, OpenAPI Explorer generates SDK code samples automatically.

Authorization information

Operation	Access level	Resource type	Condition key	Associated operation
cdn:DescribeTagResources	get	*All Resources	none	none

The following describes the columns in the table above:

Operation: The value to use in the Action element of a RAM policy to grant a RAM user or RAM role permission to call this API operation.
Access level: The access level of the operation. Levels are read, write, and list.
Resource type: The type of resource on which the RAM user or RAM role can be authorized. Bold entries are required resource types. If permissions cannot be granted at the resource level, All Resources is used.
Condition key: Condition keys defined by the cloud service.
Associated operation: Other operations that the RAM user or RAM role must have permission to perform in order to complete this operation.

Request parameters

Parameter	Type	Required	Description	Example
ResourceType	string	Yes	The resource type. Set the value to DOMAIN.	DOMAIN
ResourceId	array	Yes	The IDs of the resources to query. Each ID is an accelerated domain name. You can specify up to 50 IDs per request.
ResourceId.N	string	Yes	An accelerated domain name.	example.com
Tag	array\<object\>	No	The tags to filter by. You can specify up to 20 tags per request.
Tag.N.Key	string	No	The key of tag N. Valid values of N: 1 to 20.	key
Tag.N.Value	string	No	The value of tag N. Valid values of N: 1 to 20.	value

Response parameters

Parameter	Type	Description	Example
RequestId	string	The request ID.	34AB41F1-04A5-496F-8C8D-634BDBE6A9FB
TagResources	array\<object\>	The tags attached to the specified resources.
TagResources.TagResource	object	The tag information for a resource.
TagResources.TagResource.ResourceId	string	The ID of the resource.	example.com
TagResources.TagResource.Tag	array\<object\>	The key-value pairs of the tags attached to the resource.
TagResources.TagResource.Tag.Key	string	The tag key.	env
TagResources.TagResource.Tag.Value	string	The tag value.	product

Examples

Sample success responses

JSON format

{
  "RequestId": "34AB41F1-04A5-496F-8C8D-634BDBE6A9FB",
  "TagResources": [
    {
      "ResourceId": "example.com",
      "Tag": [
        {
          "Key": "env",
          "Value": "product"
        }
      ]
    }
  ]
}

Error codes

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

Change history

Change time	Summary of changes	Operation
2024-12-18	API description update	View change details