Understanding How The API Works »
Creating an IPTrack service in 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/IPTrack/ POST — Creates a new instance of the IPTrack service on the zone/node indicated.
HTTP Action — POST
URIs — https://api.dynect.net/REST/IPTrack/<zone>/<fqdn>/
|
Arguments — Click for More Info
- array
record_types — Required. Type of records to track.
NOTE: A and AAAA sub types are not mixable, you must create two services if you want to track both A and AAAA type records.
Valid values:
A – A Records
DynA – Dynamic DNS A Records
AAAA – AAAA Records
DynAAAA – Dynamic DNS AAAA Records
- array
hosts — Required. Hostnames of the zones where you want to track records.
- string
ttl — TTL for the created PTR records. Omit to use zone default.
Additional valid values:
match – Set the TTL of the PTR to the TTL of the target record.
default – Use the default TTL of the zone for the PTR records. (Same as leaving it empty or omitting it)
- string
netmask — A netmask to match A/AAAA rdata against. Matched records will get PTR records, any others won’t.
|
Response — Click for More Info
- string
active — Indicates whether or not the service is active.
Y — The service is active.
N — The service is inactive
- string
iptrack_id — The ID of this iptrack service.
- array
record_types — Types of records to track.
NOTE: A and AAAA sub types are not mixable, you must create two services if you want to track both A and AAAA type records.
Valid values:
A – A Records
DynA – Dynamic DNS A Records
AAAA – AAAA Records
DynAAAA – Dynamic DNS AAAA Records
- array
hosts — Hostnames of zones in your account where you want to track records.
- string
ttl — TTL for the created PTR records. Omit to use zone default.
Two special values are also supported:
match – Set the TTL of the PTR to the TTL of the record being pointed to
default – Use the default TTL of the zone for the PTR records. (Same as leaving it empty or omitting it)
- string
netmask — A netmask to match A/AAAA rdata against. Matched records will get PTR records, any others won’t.
- string
fqdn — Fully qualified domain name of a node in the zone.
- string
zone — Name of the zone.
|
SOAP Syntax
Click to view all SOAP Commands |
CreateIPTrack — Creates a new instance of the IPTrack service on the zone/node indicated.
|
Arguments — Click for More Info
- array
record_types — Required. Type of records to track.
NOTE: A and AAAA sub types are not mixable, you must create two services if you want to track both A and AAAA type records.
Valid values:
A – A Records
DynA – Dynamic DNS A Records
AAAA – AAAA Records
DynAAAA – Dynamic DNS AAAA Records
- array
hosts — Required. Hostnames of the zones where you want to track records.
- string
ttl — TTL for the created PTR records. Omit to use zone default.
Additional valid values:
match – Set the TTL of the PTR to the TTL of the target record.
default – Use the default TTL of the zone for the PTR records. (Same as leaving it empty or omitting it)
- string
netmask — A netmask to match A/AAAA rdata against. Matched records will get PTR records, any others won’t.
- string
fqdn — Required.Fully qualified domain name of a node in the zone.
- string
token — Required. The session identifier.
- string
zone — Required. Name of the zone where the service will be added.
|
Response — Click for More Info
- hash
data
- string
active — Indicates whether or not the service is active.
Y — The service is active.
N — The service is inactive
- string
iptrack_id — The ID of this iptrack service.
- array
record_types — Types of records to track.
NOTE: A and AAAA sub types are not mixable, you must create two services if you want to track both A and AAAA type records.
Valid values:
A – A Records
DynA – Dynamic DNS A Records
AAAA – AAAA Records
DynAAAA – Dynamic DNS AAAA Records
- array
hosts — Hostnames of zones in your account where you want to track records.
- string
ttl — TTL for the created PTR records. Omit to use zone default.
Two special values are also supported:
match – Set the TTL of the PTR to the TTL of the record being pointed to
default – Use the default TTL of the zone for the PTR records. (Same as leaving it empty or omitting it)
- string
netmask — A netmask to match A/AAAA rdata against. Matched records will get PTR records, any others won’t.
- string
fqdn — Fully qualified domain name of a node in the zone.
- string
zone — Name of the zone.
|
Example Request — Click for More Info
{
'record_types' => [
'A',
'DynA',
],
'hosts' => [
'example.com',
],
'ttl' => '60',
'netmask' => '127.0.0.0/8',
'fqdn' => 'reverse.example.com',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
<< DNS API Knowledge Base