Understanding How The API Works »
Creating a Record 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.
NOTE: Total number of records in a single Response Pool may not be more than 255.
WARNING: Dyn recommends setting an explicit fallback record entry in all Traffic Director services to ensure a query is always answered with a record. See TD Best Practices – Fallback Entry for more information on setting up a fall back entry.
REST Syntax
Click to view all REST Resources |
/REST/DSFRecord/ POST — Creates a Record in the Traffic Director service indicated.
HTTP Action — POST
URI — https://api.dynect.net/REST/DSFRecord/<service_id>/<dsf_record_set_id>/ |
Arguments — Click for More Info
- string
label — A label for the Record
- string
weight — Weight for the Record. Defaults to 1.
Valid values for A or AAAA records: 1 – 15.
Valid values for CNAME records: 1 – 255.
- string
publish — Indicates when Record will be created.
Valid values:
Y — The Record will be created on execution.
N — The Record will be created when zone changes are next published.
- string
notes — A custom note field. All content in the string is added to the Zone Notes for the zones attached to this service when the zone is published. Only used when publish = Y
- string
automation — Defines how eligible can be changed in response to monitoring.
Valid values:
auto — Sets the serve_mode field to ‘Monitor & Obey’. Default.
auto_down — Sets the serve_mode field to ‘Monitor & Remove’.
manual — Couples with eligible value to determine other serve_mode field values.
- array
endpoints — The individual address(es) for a record. Multiple addresses are added as an array [ addr, addr ]. Endpoints are monitored if automation is set to auto or auto_down and there is a monitor attached to the service.
- string
endpoint_up_count — Number of endpoints that must be up for the Record status to be ‘up’.
- string
eligible — Indicates whether or not the Record can be served.
Valid values:
false — When automation is set to manual, sets the serve_mode field to ‘Do Not Serve’.
true — Default. When automation is set to manual, sets the serve_mode field to ‘Always Serve’.
- string
master_line — Required. RData to define the record. Use EITHER master_line OR rdata, only one is required.
EXAMPLE: string master_line Example, A Record
{“label”:”generic_a_record”, “master_line”:”1.2.3.4″}
– OR –
- hash
rdata — Required. RData that comprises the Record. Use EITHER master_line OR rdata, only one is required.
EXAMPLE: hash rdata Example, A Record
{
“label”:”generic_a_record”,
“rdata”:{
“a_rdata”: {
“address”: “1.2.3.4”
}
}
}
Click for Individual rdata Records
- hash
a_rdata — A record rdata
- string
address — Required. IPv4 Address
- hash
aaaa_rdata — AAAA record rdata.
- string
address — Required. IPv6 Address
- hash
cert_rdata — CERT record rdata
- string
format — Required. Must use the numeric value for Certificate Type. Example: 3
- string
tag — Required. Identifies which private key was used to sign the public-key certificate. Must use a numeric value for the Key Tag
- string
algorithm — Required. The public-key algorithm number used to generate the certificate. Example: if RSA/SHA 1 was used, its algorithm # is 5, which would be placed in this field
- string
certificate — Required. Enter the actual public-key certificate
- hash
cname_rdata — CNAME record rdata
- string
cname — Required. Hostname
- hash
dhcid_rdata — DHCID record rdata.
- string
digest — Required. Base-64 encoded digest of DHCP data.
- hash
dname_rdata — DNAME record rdata.
- string
dname — Required. Target hostname
- hash
dnskey_rdata — DNSKEY record rdata
- string
algorithm — Required. Which public-key encryption algorithm is to sign this zone. A value of 5 is for the algorithm RSA/SHA-1, which is considered mandatory
- string
flags — Required. Numeric value that states that this DNSKEY is the zone’s key
- string
protocol — Required. Always set to 3 (DNSSEC)
- string
public_key — Required. Enter the DNSSEC public key from your current DNSSEC signed zone
- hash
ds_rdata — DS record rdata
- string
algorithm — Required. The algorithm number used by the DNSKEY resource record.
- string
digest — Required. The digest of the DNSKEY resource record this DS refers to.
- string
digtype — Required. Identifies the algorithm used to construct the digest .
- string
keytag — Required. The key tag of the DNSKEY resource record.
- hash
ipseckey_rdata IPSECKEY record rdata
- string
precedence — Required. Similar to the preference value in MX records. IF multiple IPSECKEYs exist on a node, the lower value (10) takes precedence over the higher value (20)
- string
gatetype — Required. Value that states what type of gateway is used, if any
- string
algorithm — Required. Identifies the public key’s cryptographic algorithm and the format of the public key field
- string
gateway — Required. The gateway used to create the IPsec tunnel. Based on the Gateway type
- string
public_key — Required. Base 64 encoding of the public key
- hash
key_rdata KEY record rdata
- string
algorithm — Required. Numeric value for the algorithm used RSA/MD5, the recommended algorithm, is 1
- string
flags — Required.
- string
protocol — Required.Numeric value for the protocol used 1= TLS, 2=Email, 3=DNSSEC, 4= IPsec
- string
public_key — Required. The public key
- hash
kx_rdata KX record rdata
- string
preference — Required.Similar to the MX record’s preference. Lower value (10) takes precedence over higher value (20) if multiple KX records exist on the same node
- string
exchange — Required.The hostname that will act as the key exchanger. Must have a CNAME record and either an A record or an AAAA record
- hash
loc_rdata LOC record rdata
- string
altitude — Required.Measured in meters above sea level Example: -44m
- string
horiz_pre — Required. Precision in meters Example: 30m
- string
latitude — Required. Measured in degrees, minutes, and seconds Example: 42 21 54 N
- string
longitude — Required. Measured in degrees, minutes, and seconds Example: 71 06 18 W
- string
size — Required. Size in meters Example: 10m
- string
version — Required.
- string
vert_pre — Required. Precision in meters Example 10m
- hash
mx_rdata MX record rdata
- string
exchange — Required. Hostname of the server responsible for accepting mail messages in the zone
- string
preference — Required. The MX record with the lowest preference number is used first, then the record with the next highest number
- hash
naptr_rdata NAPTR record rdata
- string
order — Required. Similar to the MX Record’s preference value or SRV record’s priority value. The lowest value is used first, highest value used last
- string
preference — Required. If one or more NAPTR records have the same value for ORDER, the value of preference is used to decide which record is used first. Lowest number goes first
- string
flags — Required.
- string
services — Required. Always starts with e2u+ then the string that defines the type and optionally the subtype of the URI where this NAPTR points
- string
regexp — Required. Enter regular expression for this NAPTR record
- string
replacement — Required. Specifies the next domain name to look up if this is a non-terminal NAPTR
- hash
ns_rdata NS record rdata
- string
nsdname — Required. Hostname of the authoritative Nameserver for this zone
- hash
nsap_rdata NSAP record rdata
- string
nsap — Required. Hex-encoded NSAP identifier
- hash
ptr_rdata PTR record rdata
- string
ptrdname — Required. Hostname where the IP address should be directed
- hash
px_rdata PX record rdata
- string
preference — Required. numeric preference
- string
map822 — Required. mail hostname
- string
mapx400 — Required. X.400 address mapping
- hash
rp_rdata RP record rdata
- string
mbox — Required. Email address of the Responsible Person with the @ symbol replaced with a dot ‘.’
- string
txtdname — Required. Hostname where there is a TXT record with more information
- hash
spf_rdata SPF record rdata
- string
txtdata — Required. Free text box
- hash
srv_rdata SRV record rdata
-
- string
port — Required. Port number where the service is running.
- string
priority — Required. Numeric value for priority usage. Lower value takes precedence where two records of the same type exist on the zone/node.
- string
target — Required. Domain name of a host where the service is running on the specified port .
- string
weight — Required. Secondary prioritizing of records to serve. Records of equal priority should be served based on their weight.
- hash
sshfp_rdata SSHFP record rdata
- string
algorithm — Required. algorithm for SSH key
- string
fptype — Required. type of fingerprint hash
- string
fingerprint — Required. hex-encoded fingerprint
- hash
txt_rdata TXT record rdata
- string
txtdata — Required. Free text field
|
Response — Click for More Info
- string
dsf_record_id — Identifier for the Record.
- string
service_id — The id of a Traffic Director service.
- string
label — A label for the Record
- string
master_line — Master line for the Record
- string
weight — Weight for the Record. Defaults to 1.
Valid values for A or AAAA records: 1 – 15.
Valid values for CNAME records: 1 – 255.
- string
automation — Defines how eligible can be changed in response to monitoring.
Valid values:
auto — Sets the serve_mode field to ‘Monitor & Obey’. Default.
auto_down — Sets the serve_mode field to ‘Monitor & Remove’.
manual — Couples with eligible value to determine other serve_mode field values.
- array
endpoints — The individual address(es) for a record. Multiple addresses are added as an array [ addr, addr ]. Endpoints are monitored if automation is set to auto or auto_down and there is a monitor attached to the service.
- array
endpoint_up_count — Number of endpoints that must be up for the Record status to be ‘up’.
- string
eligible — Indicates whether or not the Record can be served.
Valid values:
false — When automation is set to manual, sets the serve_mode field to ‘Do Not Serve’.
true — Default. When automation is set to manual, sets the serve_mode field to ‘Always Serve’.
- string
rdata_class — The type of rdata represented by this DSF Record Set.
- string
ttl — Default TTL used for Records within this Record Set.
- hash
rdata — RData that comprises the Record.
- string
type — The type of rdata.
- string
ttl — Default TTL used for Record.
Click for Individual rdata Records
- hash
data
- hash
a_rdata — A record rdata.
- string
address — IPv4 Address.
- hash
aaa_rdata — AAAA record rdata.
-
- string
address — IPv6 Address.
- hash
cert_rdata — CERT record rdata.
-
- string
format — Must use the numeric value for Certificate Type. Example: 3
- string
tag — Identifies which private key was used to sign the public-key certificate. Must use a numeric value for the Key Tag
- string
algorithm — The public-key algorithm number used to generate the certificate. Example: if RSA/SHA 1 was used, its algorithm # is 5, which would be placed in this field
- string
certificate — Enter the actual public-key certificate
- hash
cname_rdata — CNAME record rdata.
-
- hash
dhcid_rdata — DHCID record rdata.
-
- string
digest — Base-64 encoded digest of DHCP data.
- hash
dname_rdata — DNAME record rdata.
-
- string
dname — Target hostname.
- hash
dnskey_rdata — DNSKEY record rdata.
-
- string
algorithm — Which public-key encryption algorithm is to sign this zone. A value of 5 is for the algorithm RSA/SHA-1, which is considered mandatory
- string
flags — Numeric value that states that this DNSKEY is the zone’s key
- string
protocol — Always set to 3 (DNSSEC)
- string
public_key — Enter the DNSSEC public key from your current DNSSEC signed zone
- hash
ds_rdata — DS record rdata.
-
- string
algorithm — The algorithm number used by the DNSKEY resource record.
- string
digest — The digest of the DNSKEY resource record this DS refers to.
- string
digtype — Identifies the algorithm used to construct the digest .
- string
keytag — The key tag of the DNSKEY resource record.
- hash
ipseckey_rdata — IPSECKEY record rdata.
-
- string
precedence — Similar to the preference value in MX records. IF multiple IPSECKEYs exist on a node, the lower value (10) takes precedence over the higher value (20)
- string
gatetype — Value that states what type of gateway is used, if any.
- string
algorithm — Identifies the public key’s cryptographic algorithm and the format of the public key field.
- string
gateway — The gateway used to create the IPsec tunnel. Based on the Gateway type.
- string
public_key — Base 64 encoding of the public key.
- hash
key_rdata — KEY record rdata.
-
- string
algorithm — Numeric value for the algorithm used RSA/MD5, the recommended algorithm, is 1.
- string
flags
- string
protocol — Numeric value for the protocol used 1= TLS, 2=Email, 3=DNSSEC, 4= IPsec.
- string
public_key — The public key.
- hash
kx_rdata — KX record rdata.
-
- string
preference — Similar to the MX record’s preference. Lower value (10) takes precedence over higher value (20) if multiple KX records exist on the same node.
- string
exchange — The hostname that will act as the key exchanger. Must have a CNAME record and either an A record or an AAAA record.
- hash
loc_rdata — LOC record rdata.
-
- string
altitude — Measured in meters above sea level Example: -44m.
- string
horiz_pre — Precision in meters Example: 30m.
- string
latitude — Measured in degrees, minutes, and seconds Example: 42 21 54 N.
- string
longitude — Measured in degrees, minutes, and seconds Example: 71 06 18 W.
- string
size — Size in meters Example: 10m.
- string
version
- string
vert_pre — Precision in meters Example 10m.
- hash
mx_rdata — MX record rdata.
-
- string
exchange — Hostname of the server responsible for accepting mail messages in the zone
- string
preference — The MX record with the lowest preference number is used first, then the record with the next highest number
- hash
naptr_rdata — NAPTR record rdata.
-
- string
order — Similar to the MX Record’s preference value or SRV record’s priority value. The lowest value is used first, highest value used last.
- string
preference — If one or more NAPTR records have the same value for ORDER, the value of preference is used to decide which record is used first. Lowest number goes first.
- string
flags
- string
services — Always starts with e2u+ then the string that defines the type and optionally the subtype of the URI where this NAPTR points.
- string
regexp — Enter regular expression for this NAPTR record.
- string
replacement — Specifies the next domain name to look up if this is a non-terminal NAPTR.
- hash
ns_rdata — NS record rdata.
-
- string
nsdname Hostname of the authoritative Nameserver for this zone.
- hash
nsap_rdata — NSAP record rdata.
-
- string
nsap — Hex-encoded NSAP identifier.
- hash
ptr_rdata — PTR record rdata.
-
- string
ptrdname Hostname where the IP address should be directed.
- hash
px_rdata — PX record rdata.
-
- string
preference — numeric preference.
- string
map822 — mail hostname.
- string
mapx400 — X.400 address mapping.
- hash
rp_rdata — RP record rdata.
- string
mbox — Email address of the Responsible Person with the @ symbol replaced with a dot ‘.’.
- string
txtdname — Hostname where there is a TXT record with more information.
- hash
soa_rdata — SOA record rdata (automatically created when zone is created).
-
- integer
expire — Set to 1 week by default. The time, in seconds, that a secondary server will keep trying to complete a zone transfer.
- integer
minimum — Set to 1 minute by default.
- string
mname
- integer
refresh — Set to 1 hour by default. The time, in seconds, a secondary DNS server waits before querying the primary DNS Server’s SOA record to check for changes.
- integer
retry — Set to 10 minutes by default. The time, in seconds, a secondary DNS Server waits before retrying a failed zone transfer.
- string
rname
- integer
serial — Value increments when any resource record in the zone file is updated.
- hash
spf_rdata — SPF record rdata.
-
- string
txtdata — Free text box
- hash
srv_rdata — SRV record rdata.
-
- string
port — Port number where the service is running.
- string
priority — Numeric value for priority usage. Lower value takes precedence where two records of the same type exist on the zone/node.
- string
target — Domain name of a host where the service is running on the specified port .
- string
weight — Secondary prioritizing of records to serve. Records of equal priority should be served based on their weight.
- hash
sshfp_rdata — SSHFP record rdata.
-
- string
algorithm — algorithm for SSH key.
- string
fptype — type of fingerprint hash.
- string
fingerprint — hex-encoded fingerprint.
- hash
txt_rdata — TXT record rdata.
-
- string
txtdata Free text field
- string
status — The status of the pool indicated by any attached monitors
- Valid values:
ok — The object is available (up).
unknown — The object has not provided a status to the monitor.
down — ‘x’ records are ineligible or Unable to satisfy minimum eligible records.
- string
response_time — Time it took to receive a response from the endpoints
- string
torpidity — Performance indicator for the Record. Lower is better.
- string
last_monitored — Epoch timestamp of the last time the Record Set was monitored.
- string
pending_change — Indicates whether or not the object will be added, updated, or deleted.
|
SOAP Syntax
Click to view all SOAP Commands |
CreateDSFRecord — Creates a Record in the Traffic Director service indicated. |
Arguments — Click for More Info
- string
service_id — Required. Identifier for the DSF service.
- string
dsf_record_set_id — Identifier for the Record Set this Record will join.
- string
label — A label for the Record
- string
weight — Weight for the Record. Defaults to 1.
Valid values for A or AAAA records: 1 – 15.
Valid values for CNAME records: 1 – 255.
- string
publish — Indicates whether or not the changes will be published immediately.
Valid values:
Y — Service will be published on creation
N — Service will be published when zone changes are published.
- string
notes — A custom note field. All content in the string is added to the Zone Notes for the zones attached to this service when the zone is published. Only used when publish = Y
- string
automation — Defines how eligible can be changed in response to monitoring.
Valid values:
auto — Sets the serve_mode field to ‘Monitor & Obey’. Default.
auto_down — Sets the serve_mode field to ‘Monitor & Remove’.
manual — Couples with eligible value to determine other serve_mode field values.
- array
endpoints — The individual address(es) for a record. Multiple addresses are added as an array [ addr, addr ]. Endpoints are monitored if automation is set to auto or auto_down and there is a monitor attached to the service.
- string
endpoint_up_count — Number of endpoints that must be up for the Record status to be ‘up’.
- string
eligible — Indicates whether or not the Record can be served.
Valid values:
false — When automation is set to manual, sets the serve_mode field to ‘Do Not Serve’.
true — Default. When automation is set to manual, sets the serve_mode field to ‘Always Serve’.
- string
master_line — Required. RData to define the record. Use EITHER master_line OR rdata, only one is required.
EXAMPLE: string master_line Example, A Record
{“label”:”generic_a_record”, “master_line”:”1.2.3.4″}
– OR –
- hash
rdata — Required. RData that comprises the Record. Use EITHER master_line OR rdata, only one is required.
EXAMPLE: hash rdata Example, A Record
{
“label”:”generic_a_record”,
“rdata”:{
“a_rdata”: {
“address”: “1.2.3.4”
}
}
}
Click for Individual rdata Records
- hash
a_rdata — A record rdata
- string
address — Required. IPv4 Address
- hash
aaaa_rdata — AAAA record rdata.
- string
address — Required. IPv6 Address
- hash
cert_rdata — CERT record rdata
- string
format — Required. Must use the numeric value for Certificate Type. Example: 3
- string
tag — Required. Identifies which private key was used to sign the public-key certificate. Must use a numeric value for the Key Tag
- string
algorithm — Required. The public-key algorithm number used to generate the certificate. Example: if RSA/SHA 1 was used, its algorithm # is 5, which would be placed in this field
- string
certificate — Required. Enter the actual public-key certificate
- hash
cname_rdata — CNAME record rdata
- string
cname — Required. Hostname
- hash
dhcid_rdata — DHCID record rdata.
- string
digest — Required. Base-64 encoded digest of DHCP data.
- hash
dname_rdata — DNAME record rdata.
- string
dname — Required. Target hostname
- hash
dnskey_rdata — DNSKEY record rdata
- string
algorithm — Required. Which public-key encryption algorithm is to sign this zone. A value of 5 is for the algorithm RSA/SHA-1, which is considered mandatory
- string
flags — Required. Numeric value that states that this DNSKEY is the zone’s key
- string
protocol — Required. Always set to 3 (DNSSEC)
- string
public_key — Required. Enter the DNSSEC public key from your current DNSSEC signed zone
- hash
ds_rdata — DS record rdata
- string
algorithm — Required. The algorithm number used by the DNSKEY resource record.
- string
digest — Required. The digest of the DNSKEY resource record this DS refers to.
- string
digtype — Required. Identifies the algorithm used to construct the digest .
- string
keytag — Required. The key tag of the DNSKEY resource record.
- hash
ipseckey_rdata IPSECKEY record rdata
- string
precedence — Required. Similar to the preference value in MX records. IF multiple IPSECKEYs exist on a node, the lower value (10) takes precedence over the higher value (20)
- string
gatetype — Required. Value that states what type of gateway is used, if any
- string
algorithm — Required. Identifies the public key’s cryptographic algorithm and the format of the public key field
- string
gateway — Required. The gateway used to create the IPsec tunnel. Based on the Gateway type
- string
public_key — Required. Base 64 encoding of the public key
- hash
key_rdata KEY record rdata
- string
algorithm — Required. Numeric value for the algorithm used RSA/MD5, the recommended algorithm, is 1
- string
flags — Required.
- string
protocol — Required.Numeric value for the protocol used 1= TLS, 2=Email, 3=DNSSEC, 4= IPsec
- string
public_key — Required. The public key
- hash
kx_rdata KX record rdata
- string
preference — Required.Similar to the MX record’s preference. Lower value (10) takes precedence over higher value (20) if multiple KX records exist on the same node
- string
exchange — Required.The hostname that will act as the key exchanger. Must have a CNAME record and either an A record or an AAAA record
- hash
loc_rdata LOC record rdata
- string
altitude — Required.Measured in meters above sea level Example: -44m
- string
horiz_pre — Required. Precision in meters Example: 30m
- string
latitude — Required. Measured in degrees, minutes, and seconds Example: 42 21 54 N
- string
longitude — Required. Measured in degrees, minutes, and seconds Example: 71 06 18 W
- string
size — Required. Size in meters Example: 10m
- string
version — Required.
- string
vert_pre — Required. Precision in meters Example 10m
- hash
mx_rdata MX record rdata
- string
exchange — Required. Hostname of the server responsible for accepting mail messages in the zone
- string
preference — Required. The MX record with the lowest preference number is used first, then the record with the next highest number
- hash
naptr_rdata NAPTR record rdata
- string
order — Required. Similar to the MX Record’s preference value or SRV record’s priority value. The lowest value is used first, highest value used last
- string
preference — Required. If one or more NAPTR records have the same value for ORDER, the value of preference is used to decide which record is used first. Lowest number goes first
- string
flags — Required.
- string
services — Required. Always starts with e2u+ then the string that defines the type and optionally the subtype of the URI where this NAPTR points
- string
regexp — Required. Enter regular expression for this NAPTR record
- string
replacement — Required. Specifies the next domain name to look up if this is a non-terminal NAPTR
- hash
ns_rdata NS record rdata
- string
nsdname — Required. Hostname of the authoritative Nameserver for this zone
- hash
nsap_rdata NSAP record rdata
- string
nsap — Required. Hex-encoded NSAP identifier
- hash
ptr_rdata PTR record rdata
- string
ptrdname — Required. Hostname where the IP address should be directed
- hash
px_rdata PX record rdata
- string
preference — Required. numeric preference
- string
map822 — Required. mail hostname
- string
mapx400 — Required. X.400 address mapping
- hash
rp_rdata RP record rdata
- string
mbox — Required. Email address of the Responsible Person with the @ symbol replaced with a dot ‘.’
- string
txtdname — Required. Hostname where there is a TXT record with more information
- hash
spf_rdata SPF record rdata
- string
txtdata — Required. Free text box
- hash
srv_rdata SRV record rdata
- string
port — Required. Port number where the service is running.
- string
priority — Required. Numeric value for priority usage. Lower value takes precedence where two records of the same type exist on the zone/node.
- string
target — Required. Domain name of a host where the service is running on the specified port .
- string
weight — Required. Secondary prioritizing of records to serve. Records of equal priority should be served based on their weight.
- hash
sshfp_rdata SSHFP record rdata
- string
algorithm — Required. algorithm for SSH key
- string
fptype — Required. type of fingerprint hash
- string
fingerprint — Required. hex-encoded fingerprint
- hash
txt_rdata TXT record rdata
- string
txtdata — Required. Free text field
- string
token — Required The session identifier.
|
Response — Click for More Info
- hash
data
- string
dsf_record_id — Identifier for the Record.
- string
service_id — The id of a Traffic Director service.
- string
label — A label for the Record
- string
master_line — Master line for the Record
- string
weight — Weight for the Record. Defaults to 1.
Valid values for A or AAAA records: 1 – 15.
Valid values for CNAME records: 1 – 255.
- string
automation — Defines how eligible can be changed in response to monitoring.
Valid values:
auto — Sets the serve_mode field to ‘Monitor & Obey’. Default.
auto_down — Sets the serve_mode field to ‘Monitor & Remove’.
manual — Couples with eligible value to determine other serve_mode field values.
- array
endpoints — The individual address(es) for a record. Multiple addresses are added as an array [ addr, addr ]. Endpoints are monitored if automation is set to auto or auto_down and there is a monitor attached to the service.
- array
endpoint_up_count — Number of endpoints that must be up for the Record status to be ‘up’.
- string
eligible — Indicates whether or not the Response Pool can be served.
Valid values:
false — When automation is set to manual, sets the serve_mode field to ‘Do Not Serve’.
true — Default. When automation is set to manual, sets the serve_mode field to ‘Always Serve’.
- string
rdata_class — The type of rdata represented by this Record Set.
- string
ttl — Default TTL used for Records within this Record Set.
- hash
rdata — RData that comprises the Record.
- string
type — The type of rdata.
- string
ttl — Default TTL used for Record.
Click for Individual rdata Records
- string
status — The status of the pool indicated by any attached monitors
- Valid values:
ok — The object is available (up).
unknown — The object has not provided a status to the monitor.
down — ‘x’ records are ineligible or Unable to satisfy minimum eligible records.
- string
response_time — Time it took to receive a response from the endpoints
- string
torpidity — Performance indicator for the Record. Lower is better.
- string
last_monitored — Epoch timestamp of the last time the Record Set was monitored
- string
pending_change — Indicates whether or not the object will be added, updated, or deleted.
|
Example Request — Click for More Info
{
'service_id' => '0bi5k...', # ID shortened...
'dsf_record_set_id' => 'ab32f...', # ID shortened...
'label' => 'Example Record',
'weight' => '1',
'automation' => 'auto',
'endpoints' => ['192.168.1.1','192.168.2.1'],
'endpoint_up_count' => '1',
'master_line' => '127.0.0.1',
// or
'rdata' => {
'a_rdata' => {
'address' => '127.0.0.1'
}
}
'token' => 'asdlj34ot879834cdzjklfK',
}
|
<< DNS API Knowledge Base