Retrieving one or more A records from a zone/node 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.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/ARecord/ GET — Retrieves one or all A Records from a specified zone/node.
HTTP Action — GET
URIs:
Retrieve a single record — https://api.dynect.net/REST/ARecord/<zone>/<fqdn>/<record_id>/
Retrieve all A records — https://api.dynect.net/REST/ARecord/<zone>/<fqdn>/
|
Arguments:
No Arguments.
|
Response:
No Record_ID Specified:
- array — Individual A record resources.
Record_ID Specified — Click for More Info
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record.
- string
address — IPv4 Address.
- string
record_type — The RRType of the record.
- string
ttl — TTL for the record.
- string
zone — Name of the zone.
|
SOAP Syntax
Click to view all SOAP Commands |
GetOneARecord — Retrieves the specific existing A Record at the zone/node.
GetARecords — Retrieves all existing A Records at the zone/node.
|
Arguments:
GetOneARecord — Click for More Info
- string
fqdn — Required. Name of node where the record exists.
- string
record_id — If specified, the ID of the record to find.
- hash
rdata — If specified, the RData defining the record data to match against.
- string
address — Required. IPv4 Address.
- string
token — Required. The session identifier.
- string
zone — Required. Name of zone where the record exists.
GetARecords — Click for More Info
string fqdn — Required. Name of node where the records exist.
string token — Required. The session identifier.
string zone — Required. Name of zone where the records exist.
|
Response:
GetOneARecord — Click for More Info
- hash
data
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record.
- string
address — IPv4 Address.
- string
record_id — A numeric identifier for the record.
- string
record_type — The RRType of the record.
- string
ttl — TTL for the record.
- string
zone — Name of the zone.
GetARecords — Click for More Info
- array data
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record.
- string
address — IPv4 Address.
- string
record_id — A numeric identifier for the record.
- string
record_type — The RRType of the record.
- string
ttl — TTL for the record.
- string
zone — Name of the zone.
|
Example Request (GetOneARecord) — Click for More Info
{
'fqdn' => 'www.example.com',
'rdata' => {
'address' => '1.2.3.4',
},
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
or
{
'fqdn' => 'www.example.com',
'record_id' => '32',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
Example Request (GetOneARecord) — Click for More Info
{
'fqdn' => 'www.example.com',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
DNS API Knowledge Base