Replacing existing CDNSKEY 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 7344 for more information about the CDNSKEY record.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/CDNSKEYRecord/ PUT — Replace all existing child DNSKEY Record on the zone/node indicated. NOTE: Child DNSKEY records MUST be at the child zone apex.
HTTP Action — PUT
URI — https://api.dynect.net/REST/CDNSKEYRecord/<zone>/<fqdn>/ |
Arguments — Click for More Info
- array
DNSKEYRecords — Required. Individual CDNSKEY Records.
- hash
rdata — Required. RData defining the record(s).
- string
algorithm — Required. Public key encryption algorithm will sign the zone. Default value = RSA/SHA-1.
- string
flags — Required. Numeric value confirming this is the zone’s DNSKEY. Default value = 256.
- string
protocol — Required. Numeric value for protocol. Set to 3 for DNSSEC.
- string
public_key — Required. The public key for the DNSSEC signed zone.
- 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 — Name of node where the record are replaced.
- hash
rdata — RData defining the record.
- string
algorithm — Public key encryption algorithm will sign the zone. Default value = RSA/SHA-1 .
- string
flags — Numeric value confirming this is the zone’s DNSKEY. Default value = 256.
- string
protocol — Numeric value for protocol. Set to 3 for DNSSEC.
- string
public_key — The public key for the DNSSEC signed zone.
- string
record_type — The RRType of the record.
- string
ttl — TTL for the record.
- string
zone — Name of zone where the record will be added.
|
SOAP Syntax
Click to view all SOAP Commands |
ReplaceCDNSKEYRecord — Replace all existing CDNSKEY Record on the zone/node indicated. NOTE: Child DNSKEY records MUST be at the child zone apex. |
Arguments — Click for More Info
- string
CDNSKEYRecords — Required.
- string
fqdn — Required. Name of node where the record will be replaced.
- hash
rdata — Required. RData defining the record to update.
- string
algorithm — Required. Public key encryption algorithm will sign the zone. Default value = RSA/SHA-1 .
- string
flags — Required. Numeric value confirming this is the zone’s DNSKEY. Default value = 256.
- string
protocol — Required. Numeric value for protocol. Set to 3 for DNSSEC.
- string
public_key — Required. The public key for the DNSSEC signed zone.
- 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 added.
- 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
algorithm — Public key encryption algorithm will sign the zone. Default value = RSA/SHA-1.
- string
flags — Numeric value confirming this is the zone’s DNSKEY. Default value = 256.
- string
protocol — Numeric value for protocol. Set to 3 for DNSSEC.
- string
public_key — The public key for the DNSSEC signed zone.
- 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
{
'CDNSKEYRecords' => [
{
'fqdn' => 'www.example.com',
'rdata' => {
'flags' => '257',
'algorithm' => '5',
'protocol' => '3',
'public_key' => 'AQPWA4BRyjB3eqYNy/oykeGcSXjl+HQK9CciAxJfMcS1vEuwz9c+QG7sEJnQuH5B9i5o/ja+DVitY3jpXNa12mEn',
},
'ttl' => '3600',
'zone' => 'example.com',
},
{
'fqdn' => 'www.example.com',
'rdata' => {
'flags' => '257',
'algorithm' => '5',
'protocol' => '3',
'public_key' => 'AQPWA4BRyjB3eqYNy/oykeGcSXjl+HQK9CciAxJfMcS1vEuwz9c+QG7sEJnQuH5B9i5o/ja+DVitY3jpXNa12mEn',
},
'ttl' => '3600',
'zone' => 'example.com',
}
],
'token' => 'asdlkfjasl23j4879afa',
}
|
<< DNS API Knowledge Base