Updating an existing PX Records 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 2163 for more information about PX records.
See RFC 822 for more information about the domain name part of MCGAM.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/PXRecord/ PUT — Replace all existing PX Records on the zone/node indicated.
HTTP Action — PUT
URI — https://api.dynect.net/REST/PXRecord/<zone>/<fqdn>/ |
Arguments — Click for More Info
- array
PXRecords — Required. Individual records.
- hash
rdata — Required. RData defining the record.
- string
preference — Required. Sets priority for processing records of the same type. Lowest value is processed first.
- string
map822 — Required. mail hostname
- string
mapx400 — Required. Enter the domain name derived from the X.400 part of MCGAM.
- string
ttl — TTL for the record in seconds. Set to “0” to use zone default.
|
Response — Click for More Info
- array — Individual records.
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record.
- string
preference — Sets priority for processing records of the same type. Lowest value is processed first.
- string
map822 — mail hostname
- string
mapx400 — The domain name derived from the X.400 part of MCGAM.
- 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 |
ReplacePXRecord — Replace all existing PX Record on the zone/node indicated. |
Arguments — Click for More Info
- array
PXRecords — Requested.
- string
fqdn — Required. Name of node where the record will be updated.
- hash
rdata — Required. RData defining the record to update.
- string
preference — Required. Sets priority for processing records of the same type. Lowest value is processed first.
- string
map822 — Required. mail hostname
- string
mapx400 — Required. Enter the domain name derived from the X.400 part of MCGAM.
- string
ttl — TTL for the record in seconds. Set to “0” to use zone default.
- string
zone — Required. Name of zone where the record will be updated.
- string
token — Required. The session identifier.
|
Response — 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
preference — Sets priority for processing records of the same type. Lowest value is processed first.
- string
map822 — mail hostname
- string
mapx400 — The domain name derived from the X.400 part of MCGAM.
- 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 — Click for More Info
{
'PXRecords' => [
{
'fqdn' => 'somehost.example.com',
'rdata' => {
'preference' => '10',
'map822' => 'gateway.example.com',
'mapx400' => 'PRMD-ab.ADMD-ac.C-us.',
},
'ttl' => '3600',
'zone' => 'example.com',
},
{
'fqdn' => 'somehost.example.com',
'rdata' => {
'preference' => '20',
'map822' => 'backup.example.com',
'mapx400' => 'PRMD-ab.ADMD-ac.C-us.',
},
'ttl' => '3600',
'zone' => 'example.com',
}
],
'token' => 'asdlkfjasl23j4879afa',
}
|
DNS API Knowledge Base