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.

Table 1 Parameters in the URI

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.

last updated: 2024-05-07 00:19