Updated on 2022-01-25 GMT+08:00

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 cannot contain the following characters: =*<>\,|/ nor start or end with a space.

    values

    Array of strings

    Tag value, which contains 43 Unicode characters at most and can be an empty string. It cannot contain the following characters: =*<>\,|/ nor start or end with a space.

  • Example response
    {
        "tags": [
            {
                "key": "key1", 
                "values": [
                            "value1", 
                            "value2"
                          ]
            }, 
            {
                "key": "key2", 
                "values": [
                            "value1", 
                            "value2"
                          ]
            }
        ]
    }

Returned Value

If a 2xx status code is returned, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.