Querying Name Servers in a Public Zone¶

Function¶

Query name servers in a public zone.

URI¶

GET /v2/zones/{zone_id}/nameservers

For details, see Table 1.

**Table 1** Parameter in the URI¶
Parameter	Mandatory	Type	Description
zone_id	Yes	String	Zone ID You can obtain the value by calling the API in Querying Public Zones.

Request¶

Request parameters
None
Example request
Query name servers of the zone whose ID is 2c9eb155587194ec01587224c9f90149:
```
GET https://{DNS_Endpoint}/v2/zones/2c9eb155587194ec01587224c9f90149/nameservers
```

Response¶

Parameter description

**Table 2** Parameter in the response¶
Parameter	Type	Description
nameservers	Array of object	Name server list. For details, see Table 3.

**Table 3** Description of the **nameservers** field¶
Parameter	Type	Description
hostname	String	Host name of a name server
priority	Integer	Priority of a name server For example, if the priority of a name server is 1, it is used to resolve domain names in first priority.

Example response

{
    "nameservers": [
        {
            "hostname": "ns1.example.com.",
            "priority": 1
        },
        {
            "hostname": "ns2.example.com.",
            "priority": 2
        }
    ]
}

Returned Value¶

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

For details, see Status Code.

last updated: 2024-11-13 14:36 UTC - commit: b8cab29d9ca6c01fbd8afd58484a8bb7548a6a51