Querying Name Servers in a Public Zone
Function
This API is used to query the name servers in a public zone.
Calling Method
For details, see Calling APIs.
URI
GET /v2/zones/{zone_id}/nameservers
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
zone_id |
Yes |
String |
Zone ID. You can obtain the value by querying the public zone list. Minimum: 32 Maximum: 36 |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
nameservers |
Array of nameserver objects |
Response to the request for querying the name servers in a public zone |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
code |
String |
Error code Minimum: 8 Maximum: 36 |
message |
String |
Description Minimum: 2 Maximum: 512 |
Status code: 404
Parameter |
Type |
Description |
---|---|---|
code |
String |
Error code Minimum: 8 Maximum: 36 |
message |
String |
Description Minimum: 2 Maximum: 512 |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
code |
String |
Error code Minimum: 8 Maximum: 36 |
message |
String |
Description Minimum: 2 Maximum: 512 |
Example Requests
None
Example Responses
Status code: 200
Response to the request for querying the name servers in a public zone
{ "nameservers" : [ { "hostname" : "ns1.example.com.", "priority" : 1 }, { "hostname" : "ns2.example.com.", "priority" : 2 } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
Response to the request for querying the name servers in a public zone |
400 |
Error response |
404 |
Error response |
500 |
Error response |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.