doc-exports/docs/dns/api-ref/dns_api_67004.html
Qin Ying, Fan cf1007c84e DNS API 20240223 version
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2024-05-16 13:48:49 +00:00

8.0 KiB

Querying Tags of a Resource

Function

Query tags of a specified resource.

URI

GET /v2/{project_id}/{resource_type}/{resource_id}/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.

  • DNS-public_zone
  • DNS-private_zone
  • DNS-public_recordset
  • DNS-private_recordset
  • DNS-ptr_record

resource_id

Yes

String

Resource ID

Request

  • Parameter description

    None

  • Example request
    Query tags of the private zone whose ID is ff8080825b8fc86c015b94bc6f8712c3:
    GET https://{DNS_Endpoint}/v2/{project_id}/DNS-private_zone/ff8080825b8fc86c015b94bc6f8712c3/tags

Response

  • Parameter description
    Table 2 Parameter in the response

    Parameter

    Type

    Description

    tags

    Array of object

    Tag list. For details, see Table 2.

  • Example response
    {
        "tags": [
            {
                "key": "key1", 
                "value": "value1"
            }, 
            {
                "key": "key2", 
                "value": "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.