Qin Ying, Fan a79d5bdbdb DNS API 1017 version

Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>

2022-10-20 13:26:00 +00:00

9.5 KiB

Raw Blame History

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.

Parent topic: Tag Management

9.5 KiB Raw Blame History