- APIs
- Tag Management
- Querying Tags of a Specified Resource Type
Querying Tags of a Specified Resource Type¶
Function¶
Query all tags of a resource type.
URI¶
GET /v2/{project_id}/{resource_type}/tags
For details, see Table 1.
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. You can obtain it in Obtaining a Project ID. |
resource_type | Yes | String | Resource type, which can be DNS-public_zone, DNS-private_zone, DNS-public_recordset, DNS-private_recordset, or DNS-ptr_record |
Request¶
None
Parameter description
None
Example request
Query tags of all private zones in a project:
GET https://{DNS_Endpoint}/v2/{project_id}/DNS-private_zone/tags
Response¶
Parameter description
Table 2 Parameters in the response¶ Parameter
Type
Description
tags
Array of object
Tag list. For details, see Table 3.
Table 3 Description of the tag field¶ Parameter
Type
Description
key
String
Tag key. The key contains 36 Unicode characters at most and cannot be blank. It can contain only digits, letters, hyphens (-), and underscores (_).
values
Array of strings
Tag value, which contains 43 Unicode characters at most and can be an empty string. It can contain only digits, letters, hyphens (-), and underscores (_).
Example response
{ "tags": [ { "key": "key1", "values": [ "value1", "value2" ] }, { "key": "key2", "values": [ "value1", "value2" ] } ] }
Returned Value¶
If the API call returns a code of 2xx, for example, 200, 202, or 204, the request is successful.
For details, see Status Code.