Domain name for API request: tag.tencentcloudapi.com.
This API is used to get resource tags based on tag keys.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: DescribeResourceTagsByTagKeys. |
Version | Yes | String | Common Params. The value used for this API: 2018-08-13. |
Region | No | String | Common Params. This parameter is not required for this API. |
ServiceType | Yes | String | Service type |
ResourcePrefix | Yes | String | Resource prefix |
ResourceRegion | Yes | String | Resource region |
ResourceIds.N | Yes | Array of String | List of unique resource IDs, which can contain no more than 20 IDs. |
TagKeys.N | Yes | Array of String | List of resource tag keys, which can contain no more than 20 keys. |
Limit | No | Integer | Number of entries per page. Default value: 400 |
Offset | No | Integer | Data offset. Default value: 0. It must be an integer multiple of the Limit parameter |
Parameter Name | Type | Description |
---|---|---|
TotalCount | Integer | Total number of results |
Offset | Integer | Data offset |
Limit | Integer | Number of entries per page |
Rows | Array of ResourceIdTag | Resource tag |
RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
Obtaining resource tags by tag keys
https://tag.tencentcloudapi.com/?Action=DescribeResourceTagsByTagKeys
&ServiceType=cvm
&ResourcePrefix=instance
&ResourceRegion=ap-beijing
&ResourceIds.0=ins-1234
&TagKeys.0=abc
&TagKeys.1=edf
&<Common request parameters>
{
"Response": {
"TotalCount": 1,
"Offset": 0,
"Limit": 15,
"Rows": [
{
"ResourceId": "ins-asdfsadf",
"TagKeyValues": [
{
"TagKey": "abc",
"TagValue": "edf"
}
]
}
],
"RequestId": "5024400f-ae5c-4080-b3ca-f45bf9dae21a"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
FailedOperation | The operation failed. |
InvalidParameter.Tag | Tag parameter error. |
InvalidParameterValue.RegionInvalid | Region error. |
InvalidParameterValue.ResourceIdInvalid | Resource ID error. |
InvalidParameterValue.ResourcePrefixInvalid | Resource prefix error. |
InvalidParameterValue.TagKeyCharacterIllegal | Tag key contains illegal characters. |
InvalidParameterValue.TagKeyEmpty | Tag key cannot be empty. |
InvalidParameterValue.TagKeyLengthExceeded | Tag key length exceeds limit. |
Was this page helpful?