Retrieving the existing CERT 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.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/CERTRecord/ GET — Retrieve all existing CERT records or one specific CERT Record from the specified zone/node.
HTTP Action — GET
URIs:
Get One CERT Record — https://api.dynect.net/REST/CERTRecord/<zone>/<fqdn>/<record_id>/
Get All CERT Records — https://api.dynect.net/REST/CERTRecord/<zone>/<fqdn>/
|
Arguments:
No Arguments.
|
Response:
Get One CERT Record — Click for More Info
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record.
- string
format — Numeric value for the certificate type.
- string
tag — Numeric value for the public key certificate.
- string
algorithm — Public key algorithm number used to generate the certificate.
- string
certificate — The public key certificate.
- string
record_type — The RRType of the record.
- string
ttl — TTL for the record.
- string
zone — Name of the zone.
Get CERT Records — array — Individual records.
|
SOAP Syntax
Click to view all SOAP Commands |
GetOneCERTRecord — Retrieve the indicated CERT record from the specified zone/node.
GetCERTRecords — Retrieve all CERT records from the specified zone/node.
|
Arguments:
GetOneCERTRecord — Click for More Info
- string
fqdn — Required. Name of node where the update record is located.
- string
record_id — Identifier for the CERT record to retrieve.
- hash
rdata — RData defining the new record data.
- string
format — Required. Numeric value for the certificate type.
- string
tag — Required. Numeric value for the public key certificate.
- string
algorithm — Required. Public key algorithm number used to generate the certificate.
- string
certificate — Required. The public key certificate.
- string
token — Required. The session identifier.
- string
zone — Required. Name of zone where the update record is located.
GetCERTRecords — Click for More Info
string fqdn — Required. Name of node where the update record is located.
string token — Required. The session identifier.
string zone — Required. Name of zone where the update record is located.
|
Response:
GetOneCERTRecord — 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
format — Numeric value for the certificate type.
- string
tag — Numeric value for the public key certificate.
- string
algorithm — Public key algorithm number used to generate the certificate.
- string
certificate — The public key certificate.
- 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.
GetCERTRecords: array — Individual CERT Records.
|
Example Request (GetOneCERTRecord) — Click for More Info
{
'fqdn' => 'www.example.com',
'rdata' => {
'format' => 1,
'tag' => 44121,
'algorithm' => 3,
'certificate' => 'AQPWA4BRyjB3eqYNy/oykeGcSXjl+HQK9CciAxJfMcS1vEuwz9c+QG7sEJnQuH5B9i5o/ja+DVitY3jpXNa12mEn',
},
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
or
{
'fqdn' => 'www.example.com',
'record_id' => '32',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
Example Request (GetCERTRecords) — Click for More Info
{
'fqdn' => 'www.example.com',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
DNS API Knowledge Base