Understanding How The API Works »
Retrieves one or all external nameservers using the API requires specific syntax depending on whether you are using REST or SOAP. Use this table to find the syntax for your command.
REST Syntax
| Click to view all REST Resources |
/REST/ExtNameserver/ GET — Retrieves all existing external nameservers on the zone indicated.
/REST/ExtNameserver/<zone> GET — Retrieves one existing external nameservers on the zone indicated.HTTP Action — GET
URIs:
GET all: https://api.dynect.net/REST/ExtNameserver/
GET One: https://api.dynect.net/REST/ExtNameserver/<zone>/ |
| Arguments:
GET one External Nameserver — Click for More Info
GET all External Nameservers — Click for More Info
|
Responses for both GET one and GET all External Name Servers — Click for More Info
- string
zone — Name of the zone where the service exists.
- string
deny — Sets request as blocked or added.
Valid values:
Y – Block the request.
N – Add the request.
- string
active — Sets request to use listed hosts or account defaults.
Valid values:
Y – Use this set of hosts.
N – Use account defaults.
- array
hosts — A list of external nameservers.
- string
address — Address or CIDR of the external nameserver.
- string
notifies — Whether or not the host receives notifications.
Valid values:
Y – Yes.
N – No.
- string
transfer — Enable the host (or block) to perform XFR transfers from Dyn’s server.
Valid values:
Y – Yes.
N – No.
- string
tsig_key_name — The TSIG key name for the TSIG key you want to use. See https://help.dyn.com/get-tsigkey-info-api/ for the available names of TSIG keys on your account.
|
SOAP Syntax
| Click to view all SOAP Commands |
GetExtNameservers — Retrieves all external nameserver services.
GetOneExtNameserver — Retrieves one external nameserver services on the zone indicated. |
Arguments — Click for More Info
- string
token — Required. The session identifier.
- string
zone — Required. Name of the zone where the service exists.
|
Response — Click for More Info
- hash
data
- string
zone — Name of the zone where the service exists.
- string
deny — Sets request as blocked or added.
Valid values:
Y – Block the request.
N – Add the request.
- string
active — Sets request to use listed hosts or account defaults.
Valid values:
Y – Use this set of hosts.
N – Use account defaults.
- array
hosts — A list of external nameservers.
- string
address — Address or CIDR of the external nameserver.
- string
notifies — Whether or not the host receives notifications.
Valid values:
Y – Yes.
N – No.
- string
transfer — Enable the host (or block) to perform XFR transfers from Dyn’s server.
Valid values:
Y – Yes.
N – No.
- string
tsig_key_name — The TSIG key name for the TSIG key you want to use. See https://help.dyn.com/get-tsigkey-info-api/ for the available names of TSIG keys on your account.
|
Example Request — Click for More Info
{
'deny' => 'N',
'active' => 'Y',
'hosts' => [{
'address' => '142.35.78.17',
'notifies' => 'Y',
}, {
'address' => '142.35.78.18',
'notifies' => 'Y',
}],
'tsig_key_name' => 'key4some',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
<< DNS API Knowledge Base
