Specsheet

dns — make DNS requests

This makes a DNS request and checks the result.

Examples

Testing for an A record value:

[[dns]]
domain = 'millimeter.io'
class = 'A'
value = '159.65.215.200'

Testing for the lack of a value:

[[dns]]
domain = 'secret.millimeter.io'
class = 'SRV'
state = 'missing'

Using a specific DNS nameserver:

[[dns]]
domain = 'secret.millimeter.io'
class = 'SRV'
value = '192.168.34.43:8125'
nameserver = '127.0.0.53'

List of parameters

parameterstructuredescription
domainstringThe domain to send a query about.
nameserverstringAddress of the DNS server to send requests to.
statestringThe state of the record. This can be 'present' or 'missing'.
typestringThe DNS record type to query for.
valuestringThe response IP address or value.