Retrieving one or all existing SSHFP 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 4255 for more information about SSHFP Records.
Understanding How The API Works »
REST Syntax
| Click to view all REST Resources |
| /REST/SSHFPRecord/ GET — Retrieve one or all existing SSHFP Records on the zone/node indicated.
HTTP Action — GET
URIs:
Get one SSHFP record — https://api.dynect.net/REST/SSHFPRecord/<zone>/<fqdn>/<record_id>/
Get all SSHFP records — https://api.dynect.net/REST/SSHFPRecord/<zone>/<fqdn>/ |
| Arguments:
No Arguments. |
| Response:
Get one SSHFP record — Click for More Info
- string
fqdn — Fully qualified domain name of a node in the zone.
- hash
rdata — RData defining the record(s) to replace.
- string
algorithm — Algorithm for SSH Key.
- string
fptype — Type of fingerprint hash.
- string
fingerprint — Hex-encoded fingerprint.
- string
record_type — The RR Type of the record.
- string
ttl — TTL for the record.
- string
zone — Name of the zone.
Get all SSHFP records: array — Individual SSHFP Record resources. |
SOAP Syntax
| Click to view all SOAP Commands |
| GETOneSSHFPRecord — Retrieve one existing SSHFP Record on the zone/node indicated.
GETSSHFPRecords — Retrieve all existing SSHFP Records on the zone/node indicated. |
| Arguments:
GetOneSSHFPRecord — Click for More Info
- string
fqdn — Required. Fully qualified domain name of a node in the zone.
- string
record_id — A numeric identifier for the record.
- hash
rdata — RData defining the record.
- string
algorithm — Required. Enter the number associated with the algorithm you are using.
Valid values:
1=RSA
2=DSS
- string
fptype — Required. Enter the number associated with the fingerprint type you are using.
Valid values:
1=SHA-1
- string
fingerprint — Required Enter the SSH Key fingerprint.
- string
token — Required. The session identifier.
- string
zone — Required. Name of the zone.
GetSSHFPRecords — Click for More Info
string fqdn — Required. Name of node where the record exists.
string token — Required. The session identifier.
string zone — Required. Name of zone where the record exists.
|
| Response:
GetOneSSHFPRecord — 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
algorithm — Algorithm for SSH Key.
- string
fptype — Type of fingerprint hash.
- string
fingerprint — Hex-encoded fingerprint.
- 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.
GetSSHFPRecords — 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 — Algorithm for SSH Key.
- string
fptype — Type of fingerprint hash.
- string
fingerprint — Hex-encoded fingerprint.
- 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 (GetOneSSHFPRecord) — Click for More Info
{
'fqdn' => 'www.example.com',
'rdata' => {
'algorithm' => '2',
'fptype' => '1',
'fingerprint' => '54b32dc4ec41862c2dc0afb71c8137cd7b72cfd5',
},
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
or
{
'fqdn' => 'www.example.com',
'record_id' => '32',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
Example Request (GetSSHFPRecords) — Click for More Info
{
'fqdn' => 'www.example.com',
'token' => 'asdlkfjasl23j4879afa',
'zone' => 'example.com',
}
|
DNS API Knowledge Base
