Queries the information about the tag that is added to an Anti-DDoS Pro instance.

Usage notes

You can call the DescribeTagResources operation to query the information about the tag that is added to an Anti-DDoS Pro instance.

Note Anti-DDoS Premium does not support the tag feature.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

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 parameters

Parameter Type Required Example Description
Action String Yes DescribeTagResources

The operation that you want to perform. Set the value to DescribeTagResources.

RegionId String Yes cn-hangzhou

The region ID of the instance. Set the value to cn-hangzhou, which indicates an Anti-DDoS Pro instance in the Chinese mainland.

ResourceGroupId String No rg-acfm2pz25js****

The ID of the resource group to which the Anti-DDoS Pro instance belongs in Resource Management.

If you do not configure this parameter, the Anti-DDoS Pro instance belongs to the default resource group.

ResourceType String Yes INSTANCE

The type of the resource. Set the value to INSTANCE, which indicates an Anti-DDoS Pro instance.

NextToken String No RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****

The query token. Set the value to the value of NextToken that is returned in the last call.

Note You do not need to configure this parameter if you call this operation for the first time.
ResourceIds.N String No ddoscoo-cn-zz121ogz****

The ID of the Anti-DDoS Pro instance to query.

Note
  • The ResourceIds.N parameter and the Tags.N.Key parameter cannot be left empty at the same time.
  • You can call the DescribeInstanceIds operation to query the IDs of all instances.
Tags.N.Key String No testkey

The key of the tag to query.

Note
  • The ResourceIds.N parameter and the Tags.N.Key parameter cannot be left empty at the same time.
  • You can call the DescribeTagKeys operation to query all tag keys.
Tags.N.Value String No testvalue

The value of the tag to query.

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
NextToken String RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****

The query token that is returned in this call.

RequestId String 36E698F7-48A4-48D0-9554-0BB4BAAB99B3

The ID of the request.

TagResources Array of TagResource

The details about the tags that are added to the Anti-DDoS Pro instance.

TagResource
TagValue String testkey

The value of the tag that is added to the Anti-DDoS Pro instance.

ResourceType String INSTANCE

The type of the resource. The value is fixed as INSTANCE, which indicates an Anti-DDoS Pro instance.

ResourceId String ddoscoo-cn-zz121ogz****

The ID of the Anti-DDoS Pro instance.

TagKey String testvalue

The key of the tag that is added to the Anti-DDoS Pro instance.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceIds.1=ddoscoo-cn-mp91mf6x****
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTagResourcesResponse>
    <NextToken>RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****</NextToken>
    <RequestId>36E698F7-48A4-48D0-9554-0BB4BAAB99B3</RequestId>
    <TagResources>
        <TagValue>testkey</TagValue>
        <ResourceType>INSTANCE</ResourceType>
        <ResourceId>ddoscoo-cn-zz121ogz****</ResourceId>
        <TagKey>testvalue</TagKey>
    </TagResources>
</DescribeTagResourcesResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****",
  "RequestId" : "36E698F7-48A4-48D0-9554-0BB4BAAB99B3",
  "TagResources" : [ {
    "TagValue" : "testkey",
    "ResourceType" : "INSTANCE",
    "ResourceId" : "ddoscoo-cn-zz121ogz****",
    "TagKey" : "testvalue"
  } ]
}

Error codes

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