Retrieving one or all instances of the DNSSEC Service 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/DNSSEC/ GET — Retrieves one or all existing DNSSEC services on the zone indicated.
HTTP Action — GET
URIs:
Get one DNSSEC service — https://api.dynect.net/REST/DNSSEC/<zone>/
Get all DNSSEC services — https://api.dynect.net/REST/DNSSEC/
|
Arguments:
Get one DNSSEC Service — No Arguments.
Get all DNSSEC Service — Click for More Info
- string
detail — A boolean indicating whether or not to return the full details or a list of service resources.
Valid values:
Y — Details of each service are specified.
N — A list of service resources is returned. Default.
|
Response:
Get one DNSSEC Service — Click for More Info
- string
active — Identifies the state of the service.
Valid values:
Y = service is active.
N = service is inactive.
- string
zone — Name of the zone where the service exists.
- string
contact_nickname — Name of contact to receive notifications.
- string
notify_events — Comma-separated list of events which trigger notifications.
Valid values: create, expire, warning.
- array
keys
- string
dnssec_key_id — A numeric ID for this key.
- string
type — The type of the key.
Valid values:
KSK
ZSK
- string
algorithm — Algorithm assigned to the key.
Valid values:
RSA/SHA-1
RSA/SHA-256
RSA/SHA-512
DSA
ECDSAP256SHA256
ECDSAP384SHA384
- string
bits — Length of key in bits.
- string
start_ts — An epoch time when key is valid.
- string
expire_ts — An epoch time specifying when this key will expire.
- string
lifetime — Lifetime of the key, expressed in seconds.
- string
overlap — Time before expiration when a replacement key is prepared, specified in seconds.
- hash
dnskey — A DNSKEY record containing this key.
- string
algorithm
- string
flags
- string
protocol
- string
public_key
- hash
ds — A DS record containing the signature of this key.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
- array all_ds — The full list of all DS records created for the KSK. This field will contain an empty list if inspected on a ZSK resource.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
Get all DNSSEC Services — Array of individual DNSSEC service resources.
|
SOAP Syntax
Click to view all SOAP Commands |
GetOneDNSSEC — Retrieves an existing DNSSEC service on the zone indicated.
GetDNSSECs — Retrieves all existing DNSSEC service on the zone indicated.
|
Arguments:
GetOneDNSSEC:
- string
token — Required. The session identifier.
- string
zone — Required. Name of the zone where the service will exist.
GetDNSSECs:
- string
token — Required. The session identifier.
- string
zone — Name of the zone where the service will exist.
|
Response:
GetOneDNSSEC — Click for More Info
- hash
data
- string
active — Identifies the state of the service.
Valid values:
Y = service is active.
N = service is inactive.
- string
zone — Name of the zone where the service exists.
- string
contact_nickname — Name of contact to receive notifications.
- string
notify_events — Comma-separated list of events which trigger notifications.
Valid values: create, expire, warning.
- array
keys
- string
dnssec_key_id — A numeric ID for this key.
- string
type — The type of the key.
Valid values:
KSK
ZSK
- string
algorithm — Algorithm assigned to the key.
Valid values:
RSA/SHA-1
RSA/SHA-256
RSA/SHA-512
DSA
ECDSAP256SHA256
ECDSAP384SHA384
- string
bits — Length of key in bits.
- string
start_ts — An epoch time when key is valid.
- string
expire_ts — An epoch time specifying when this key will expire.
- string
lifetime — Lifetime of the key, expressed in seconds.
- string
overlap — Time before expiration when a replacement key is prepared, specified in seconds.
- hash
dnskey — A DNSKEY record containing this key.
- string
algorithm
- string
flags
- string
protocol
- string
public_key
- hash
ds — A DS record containing the signature of this key.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
- array all_ds — The full list of all DS records created for the KSK. This field will contain an empty list if inspected on a ZSK resource.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
GetDNSSECs — Click for More Info
- array
data
- string
active — Identifies the state of the service.
Valid values:
Y = service is active.
N = service is inactive.
- string
zone — Name of the zone where the service exists.
- string
contact_nickname — Name of contact to receive notifications.
- string
notify_events — Comma-separated list of events which trigger notifications.
Valid values: create, expire, warning.
- array
keys
- string
dnssec_key_id — A numeric ID for this key.
- string
type — The type of the key.
Valid values:
KSK
ZSK
- string
algorithm — Algorithm assigned to the key.
Valid values:
RSA/SHA-1
RSA/SHA-256
RSA/SHA-512
DSA
ECDSAP256SHA256
ECDSAP384SHA384
- string
bits — Length of key in bits.
- string
start_ts — An epoch time when key is valid.
- string
expire_ts — An epoch time specifying when this key will expire.
- string
lifetime — Lifetime of the key, expressed in seconds.
- string
overlap — Time before expiration when a replacement key is prepared, specified in seconds.
- hash
dnskey — A DNSKEY record containing this key.
- string
algorithm
- string
flags
- string
protocol
- string
public_key
- hash
ds — A DS record containing the signature of this key.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
- array all_ds — The full list of all DS records created for the KSK. This field will contain an empty list if inspected on a ZSK resource.
- string
algorithm
- string
digest
- string
digtype
- string
keytag
|
Example Request (GetOneDNSSEC) — Click for More Info
{
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
Example Request (GetDNSSECs) — Click for More Info
{
'token' => 'asdlj34ot879834cdzjklfK',
}
|
DNS API Knowledge Base