Updating an existing SOA Record 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.
See RFC 1035 for more information about SOA records.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/SOARecord/ PUT — Update an existing SOA Record on the zone/node indicated.
HTTP Action — PUT
URI — https://api.dynect.net/REST/SOARecord/<zone>/<fqdn>/<record_id>/ |
Arguments — Click for More Info
- hash
rdata — Required. RData defining the record to update.
- string
rname — Required. Domain name which specifies the mailbox of the person responsible for this zone.
- string
serial_style — The style in which serial numbers will be generated for this zone.
Valid values:
increment – Serials are incremented by 1 on every change.
epoch – Serials will be the UNIX timestamp at the time of the publish.
day – Serials will be in the form of YYYYMMDDxx where xx is incremented by one for each change during that particular day.
minute – Serials will be in the form of YYMMDDHHMM.
- string
ttl — TTL for the record in seconds. Standard TTL is 1 hour or 3600 seconds.
|
Response — Click for More Info
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record to update.
- string
rname — Domain name which specifies the mailbox of the person responsible for this zone.
- string
record_type — The RRType of the record.
- string
serial_style — The style in which serial numbers will be generated for this zone. One of the following styles: increment, epoch, day, or minute.
- string
ttl — TTL for the record in seconds.
- string
zone — Name of the zone.
|
SOAP Syntax
Click to view all SOAP Commands |
UpdateSOARecord — Update an existing SOA Record on the zone/node indicated. |
Arguments — Click for More Info
- string
fqdn — Required. Name of node where the record will be updated.
- string
record_id — Required only if there is more than 1 SOA record in the zone/node.
- hash
rdata — Required. RData defining the record to update.
- string
rname — Required. Domain name which specifies the mailbox of the person responsible for this zone.
- string
serial_style — The style in which serial numbers will be generated for this zone.
Valid values:
increment – Serials are incremented by 1 on every change.
epoch – Serials will be the UNIX timestamp at the time of the publish.
day – Serials will be in the form of YYYYMMDDxx where xx is incremented by one for each change during that particular day.
minute – Serials will be in the form of YYMMDDHHMM.
- string
token — Required. The session identifier.
- string
ttl — TTL for the record in seconds. Standard TTL is 1 hour or 3600 seconds.
- string
zone — Required. Name of zone where the record will be updated.
|
Response — 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
expire — The maximum amount of time before the zone is no longer authoritative.
- string
minimum — The minimum TTL (time to live) value that should be sent with any record in this zone.
- string
mname — Domain name of the name server that was the primary source of data for this zone.
- string
refresh — Time intervals between refreshing the zone.
- string
retry — Time intervals between retries of a failed refresh of the zone.
- string
rname — Domain name specifying the mailbox of the person responsible for this zone.
- string
serial — Unsigned 32-bit version number of the original copy of the zone. Zone transfers preserve this value.
- string
record_id — A numeric identifier for the record.
- string
record_type — The RRType of the record.
- string
serial_style — The style in which serial numbers will be generated for this zone. One of the following styles: increment, epoch, day, or minute.
- string
ttl — TTL for the record in seconds.
- string
zone — Name of the zone.
|
Example Request — Click for More Info
{
'fqdn' => 'www.example.com',
'record_id' => '32',
'rdata' => {
'rname' => 'admin.example.com',
}
'token' => 'asdlkfjasl23j4879afa',
'ttl' => '3600',
'zone' => 'example.com',
}
|
DNS API Knowledge Base