Модуль community.dns.nameserver_record_info — получить все записи указанного типа со всех серверов имён для DNS-имени

always_ask_default_resolver

логическое значение

Если установлено значение true (по умолчанию), для поиска авторитетных серверов имён подзоны будет использоваться резолвер по умолчанию. Сведения о настройке резолвера по умолчанию см. в server.

Если установлено значение false, для поиска авторитетных серверов имён подзоны будут использоваться авторитетные серверы имён родительской зоны. Это имеет смысл только в том случае, если серверы имён недавно изменились и изменения ещё не распространились.

Варианты:

• false
• true ← (по умолчанию)

name

список / элементы=строка / обязательный

Список DNS-имён, серверы имён которых необходимо получить.

query_retry

целое число

Количество повторных попыток при тайм-ауте DNS-запроса.

По умолчанию: 3

query_timeout

число с плавающей точкой

Тайм-аут каждого DNS-запроса в секундах.

По умолчанию: 10.0

server

список / элементы=строка

добавлено в community.dns 2.7.0

DNS-серверы, используемые для получения результата. Должен быть указан список из одного или нескольких IP-адресов.

По умолчанию используется стандартный системный резолвер.

servfail_retries

целое число

Количество повторных попыток при ошибках SERVFAIL.

По умолчанию: 0

type

строка / обязательный

Тип записи, которую необходимо получить.

Поддержка HTTPS и SVCB добавлена в community.dns 3.4.0.

Варианты:

• "A"
• "AAAA"
• "CAA"
• "CNAME"
• "DNAME"
• "DNSKEY"
• "DS"
• "HINFO"
• "HTTPS"
• "LOC"
• "MX"
• "NAPTR"
• "NS"
• "NSEC"
• "NSEC3"
• "NSEC3PARAM"
• "PTR"
• "RP"
• "RRSIG"
• "SOA"
• "SPF"
• "SRV"
• "SSHFP"
• "SVCB"
• "TLSA"
• "TXT"

check_mode

Поддержка: полная

Это действие не изменяет состояние.

Может выполняться в режиме check_mode и возвращать прогноз статуса изменений, не изменяя целевой объект.

diff_mode

Поддержка: Н/Д

Это действие не изменяет состояние.

В режиме diff будут возвращены сведения об изменениях (или возможных изменениях в check_mode).

idempotent

Поддержка: полная

Это действие не изменяет состояние.

При повторном запуске подряд вне режима проверки с теми же аргументами второй вызов указывает на отсутствие изменений.

Предполагается, что система, контролируемая или запрашиваемая модулем, не изменилась существенным образом.

results

list / elements=dictionary

Сведения о записях для каждого DNS-имени, указанного в name.

Возвращается: всегда

Пример: [{"name": "www.example.com", "result": [{"nameserver": "ns1.example.com", "values": [{"address": "127.0.0.1"}]}, {"nameserver": "ns2.example.com", "values": [{"address": "127.0.0.1"}]}]}, {"name": "example.org", "result": [{"nameserver": "ns1.example.org", "values": [{"address": "127.0.0.1"}, {"address": "127.0.0.2"}]}, {"nameserver": "ns2.example.org", "values": [{"address": "127.0.0.2"}]}, {"nameserver": "ns3.example.org", "values": [{"address": "127.0.0.1"}]}]}]

name

string

DNS-имя, к которому относится эта запись.

Возвращается: всегда

Пример: "www.example.com"

result

list / elements=dictionary

Список значений для каждого сервера имён.

Возвращается: при успешном выполнении

Пример: [{"entries": ["X"], "nameserver": "ns1.example.com"}, {"entries": ["X"], "nameserver": "ns2.example.com"}]

entries

list / elements=dictionary

добавлено в community.dns 3.4.0

Записи типа type.

В зависимости от type возвращаются разные поля.

Для type=TXT и type=SPF также возвращается объединённое значение в виде results[].result[].entries[].value.

Ранее это поле называлось results[].result[].values.

Возвращается: при успешном выполнении

Пример: [{"address": "127.0.0.1"}]

address

string

IPv4- или IPv6-адрес.

Возвращается: если type=A или type=AAAA

algorithm

integer

Идентификатор алгоритма.

Возвращается: если type=DNSKEY или type=DS или type=NSEC3 или type=NSEC3PARAM или type=RRSIG или type=SSHFP

altitude

float

Высота над уровнем моря.

Возвращается: если type=LOC

cert

string

Сертификат.

Возвращается: если type=TLSA

cpu

string

Процессор.

Возвращается: если type=HINFO

digest

string

Дайджест.

Возвращается: если type=DS

digest_type

integer

Тип дайджеста.

Возвращается: если type=DS

exchange

string

Сервер обмена.

Возвращается: если type=MX

expiration

integer

Метка времени истечения срока действия в формате Unix.

Возвращается: если type=RRSIG

expire

integer

Количество секунд, по истечении которых вторичные серверы имён должны прекратить отвечать на запросы для этой зоны, если основной сервер имён не отвечает.

Возвращается: если type=SOA

fingerprint

string

Отпечаток.

Возвращается: если type=SSHFP

flags

integer

Флаги.

Для type=NAPTR это значение фактически имеет тип string.

Возвращается: если type=CAA или type=DNSKEY или type=NAPTR или type=NSEC3 или type=NSEC3PARAM

fp_type

integer

Тип отпечатка.

Возвращается: если type=SSHFP

horizontal_precision

float

Точность определения местоположения по горизонтали.

Возвращается: если type=LOC

inception

integer

Метка времени начала действия в формате Unix.

Возвращается: если type=RRSIG

iterations

integer

Количество итераций.

Возвращается: если type=NSEC3 или type=NSEC3PARAM

key

string

Ключ.

Возвращается: если type=DNSKEY

key_tag

integer

Тег ключа.

Возвращается: если type=DS или type=RRSIG

labels

integer

Метки.

Возвращается: если type=RRSIG

latitude

list / elements=integer

Широта местоположения.

Возвращается: если type=LOC

longitude

list / elements=integer

Долгота местоположения.

Возвращается: если type=LOC

mbox

string

Почтовый ящик (mbox).

Возвращается: если type=RP

minimum

integer

Используется для вычисления TTL при отрицательном кэшировании.

Возвращается: если type=SOA

mname

string

Основной сервер имён для этой зоны.

Возвращается: если type=SOA

mtype

integer

Тип mtype.

Возвращается: если type=TLSA

next

string

Следующее значение.

Возвращается: если type=NSEC или type=NSEC3

order

integer

Значение порядка.

Возвращается: если type=NAPTR

original_ttl

integer

Исходное значение TTL.

Возвращается: если type=RRSIG

os

string

Операционная система.

Возвращается: если type=HINFO

params

dictionary

Параметры. Подробности см. в RFC 9460.

Возвращается: если type=HTTPS или type=SVCB

alpn

list / elements=string

Список идентификаторов ALPN в кодировке Base64.

Возвращается: при успешном выполнении

ech

any

Ключ ECH (Encrypted Client Hello) в кодировке Base64.

Возвращается: при успешном выполнении

ipv4hint

list / elements=string

Список IPv4-адресов.

Возвращается: при успешном выполнении

ipv6hint

list / elements=string

Список IPv6-адресов.

Возвращается: при успешном выполнении

mandatory

list / elements=string

Ключи параметров, которые считаются обязательными.

Возвращается: при успешном выполнении

no-default-alpn

any

Если этот ключ присутствует, значением всегда будет null.

Возвращается: при успешном выполнении

ohttp

any

Если этот ключ присутствует, значением всегда будет null.

Возвращается: при успешном выполнении

port

integer

Порт.

Возвращается: при успешном выполнении

port

integer

Порт.

Возвращается: если type=SRV

preference

integer

Значение приоритета для этой записи.

Возвращается: если type=MX или type=NAPTR

priority

integer

Значение приоритета для этой записи.

Возвращается: если type=HTTPS, type=SRV или type=SVCB

protocol

integer

Протокол.

Возвращается: если type=DNSKEY

refresh

integer

Количество секунд, по истечении которых вторичные серверы имён должны запросить у основного сервера имён запись SOA, чтобы обнаружить изменения зоны.

Возвращается: если type=SOA

regexp

string

Регулярное выражение.

Возвращается: если type=NAPTR

replacement

string

Замена.

Возвращается: если type=NAPTR

retry

integer

Количество секунд, по истечении которых вторичные серверы имён должны повторить запрос серийного номера у основного сервера имён, если тот не отвечает.

Возвращается: если type=SOA

rname

string

Адрес электронной почты администратора, ответственного за эту зону.

Возвращается: если type=SOA

salt

string

Соль.

Возвращается: если type=NSEC3 или type=NSEC3PARAM

selector

integer

Селектор.

Возвращается: если type=TLSA

serial

integer

Серийный номер этой зоны.

Возвращается: если type=SOA

service

string

Служба.

Возвращается: если type=NAPTR

signature

string

Подпись.

Возвращается: если type=RRSIG

signer

string

Подписант.

Возвращается: если type=RRSIG

size

float

Размер местоположения.

Возвращается: если type=LOC

strings

list / elements=string

Список строк для этой записи.

Объединённый результат см. в results[].result[].entries[].value.

Возвращается: если type=SPF или type=TXT

tag

string

Тег.

Возвращается: если type=CAA

target

string

Целевой объект.

Возвращается: если type=CNAME, type=DNAME, type=HTTPS, type=NS, type=PTR, type=SRV или type=SVCB

txt

string

Значение TXT.

Возвращается: если type=RP

type_covered

string

Охватываемый тип.

Возвращается: если type=RRSIG

usage

integer

Флаг использования.

Возвращается: если type=TLSA

value

string

Значение.

Для type=SPF или type=TXT это результат объединения results[].result[].entries[].strings.

Возвращается: если type=CAA или type=SPF или type=TXT

vertical_precision

float

Вертикальная точность местоположения.

Возвращается: если type=LOC

weight

integer

Вес службы.

Возвращается: если type=SRV

windows

string

Окна.

Возвращается: если type=NSEC или type=NSEC3

nameserver

string

Сервер имён.

Возвращается: при успешном выполнении

Пример: "ns1.example.com"

values

list / elements=dictionary

Записи типа type.

В зависимости от type возвращаются разные поля.

Для type=TXT и type=SPF также возвращается объединённое значение в виде results[].result[].entries[].value.

Поле переименовано в results[].result[].entries в community.dns 3.4.0. Старое имя будет поддерживаться ещё некоторое время, но рекомендуется использовать новое.

Возвращается: при успешном выполнении