community.dns.wait_for_txt модуль – Ожидание доступности записей TXT на всех авторитетных серверах имен

always_ask_default_resolver

boolean

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

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

Варианты:

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

max_sleep

float

Максимальное количество секунд ожидания между двумя циклами проверки записей TXT.

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

query_retry

integer

Количество попыток повторного запроса при истечении времени ожидания DNS-запроса.

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

query_timeout

float

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

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

records

list / elements=dictionary / required

Список DNS-имен с записями TXT, которые необходимо проверить.

mode

string

Режимы сравнения значений в records[].values.

Если subset, records[].values должно быть (не обязательно собственным) подмножеством значений TXT, установленных для DNS-имени.

Если superset, records[].values должно быть (не обязательно собственным) надмножеством значений TXT, установленных для DNS-имени. Это включает случай, когда записи TXT не установлены.

Если superset_not_empty, records[].values должно быть (не обязательно собственным) надмножеством значений TXT, установленных для DNS-имени, при условии наличия хотя бы одной записи TXT.

Если equals, records[].values должен быть тем же набором строк, что и значения TXT для DNS-имени (с точностью до порядка).

Если equals_ordered, records[].values должен быть тем же упорядоченным списком строк, что и значения TXT для DNS-имени.

Варианты:

• "subset" ← (по умолчанию)
• "superset"
• "superset_not_empty"
• "equals"
• "equals_ordered"

name

string / required

DNS-имя, например www.example.com.

values

list / elements=string / required

Значения TXT, которые необходимо найти.

server

list / elements=string

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

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

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

servfail_retries

integer

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

Как часто повторять попытки при ошибках SERVFAIL.

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

timeout

float

Глобальное время ожидания для ожидания всех записей в секундах.

Если не установлено, будет ждать бесконечно.

check_mode

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

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

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

Может работать в режиме check_mode и возвращать прогноз измененного состояния без изменения цели.

diff_mode

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

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

В режиме diff вернет подробную информацию о том, что изменилось (или, возможно, должно измениться в check_mode).

completed

целое число

Сколько проверок было завершено.

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

Пример: 3

records

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

Результаты запрошенных записей TXT.

Элементы соответствуют элементам параметра records, в том же порядке.

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

Пример: [{"check_count": 1, "done": true, "name": "example.com", "values": ["a", "b", "c"]}, {"check_count": 0, "done": false, "name": "foo.example.org"}]

check_count

целое число

Как часто проверялись записи TXT для данного имени DNS.

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

Пример: 3

done

булево

Завершена ли проверка.

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

Пример: false

name

строка

Имя DNS, для которого выполняется проверка.

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

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

values

словарь

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

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

Если для сервера имен есть несколько записей TXT, порядок их расположения соответствует порядку их получения с этого сервера. Этот порядок может отличаться от порядка в параметре проверки.

Возвращается: поиск был выполнен хотя бы один раз

Пример: {"ns1.example.com": ["TXT value 1", "TXT value 2"], "ns2.example.com": ["TXT value 2"]}