Модуль community.dns.nameserver_record_info – Поиск всех записей определенного типа от всех серверов имен для DNS-имени
Примечание
Этот модуль является частью коллекции community.dns (версия 3.0.5).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.dns. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.
Для использования в playbook, укажите: community.dns.nameserver_record_info.
Новое в community.dns 2.6.0
Краткое описание
- Учитывая DNS-имя и тип записи, будут получены все серверы имен, отвечающие за это DNS-имя, и из них все записи для этого имени данного типа.
Требования
Ниже указаны требования, необходимые на хосте, который выполняет этот модуль.
- dnspython >= 1.15.0 (возможно, более старые версии тоже работают)
Параметры
Параметр | Комментарии |
|---|---|
always_ask_default_resolver boolean | При значении При значении Варианты:
|
name list / elements=string / required | Список DNS-имен, серверы имен которых необходимо получить. |
query_retry integer | Количество попыток повтора при истечении времени ожидания запроса DNS. По умолчанию: |
query_timeout float | Время ожидания одного запроса DNS в секундах. По умолчанию: |
server list / elements=string добавлено в community.dns 2.7.0 | DNS-сервер(ы), которые будут использоваться для поиска результата. Должен быть списком одного или нескольких IP-адресов. По умолчанию используется стандартный решатель системы. |
servfail_retries integer | Сколько раз повторять попытки при ошибках SERVFAIL. По умолчанию: |
type string / required | Тип записи для получения. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная Это действие не изменяет состояние. | Может работать в режиме |
diff_mode | Поддержка: N/A Это действие не изменяет состояние. | В режиме diff будет возвращать подробную информацию о том, что изменилось (или что может потребовать изменения в |
Примечания
Примечание
- dnspython версии до 2.0.0 некорректно поддерживает (раз-) экранирование UTF-8 в записях типа TXT. Это может привести к неправильно декодированным записям TXT. Пожалуйста, используйте dnspython 2.0.0 или более позднюю версию, чтобы исправить эту проблему; см. также https://github.com/rthalley/dnspython/issues/321. К сожалению, dnspython 2.0.0 требует Python 3.6 или новее.
Примеры
- name: Retrieve TXT values from all nameservers for two DNS names
community.dns.nameserver_record_info:
name:
- www.example.com
- example.org
type: TXT
register: result
- name: Show TXT values for www.example.com for all nameservers
ansible.builtin.debug:
msg: '{{ result.results[0].result }}'
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
results list / elements=dictionary | Информация о записях для каждого DNS-имени, указанного в Возвращается: всегда Пример: |
|
name string |
DNS-имя, для которого предназначена эта запись. Возвращается: всегда Пример: |
|
result list / elements=dictionary |
Список значений для каждого сервера имен. Возвращается: при успехе Пример: |
|
nameserver string |
Сервер имен. Возвращается: при успехе Пример: |
|
values list / elements=dictionary |
Записи типа В зависимости от Для Возвращается: при успехе Пример: |
|
address string | |
|
algorithm integer |
Идентификатор алгоритма. Возвращается: если |
|
altitude float |
Высота. Возвращается: если |
|
cert string |
Сертификат. Возвращается: если |
|
cpu string |
Процессор. Возвращается: если |
|
digest string |
Хеш. Возвращается: если |
|
digest_type integer |
Тип хеша. Возвращается: если |
|
exchange string |
Сервер обмена. Возвращается: если |
|
expiration integer |
Время истечения срока действия в формате Unix timestamp. Возвращается: если |
|
expire integer |
Количество секунд, после которого вторичные серверы имен должны прекратить отвечать на запросы для этой зоны, если основной сервер имен не отвечает. Возвращается: если |
|
fingerprint string |
Отпечаток. Возвращается: если |
|
flags integer |
Флаги. На самом деле это тип Возвращается: если |
|
fp_type integer |
Тип отпечатка. Возвращается: если |
|
horizontal_precision float |
Горизонтальная точность местоположения. Возвращается: если |
|
inception integer |
Метка времени Unix для начала. Возвращается: if |
|
iterations integer |
Количество итераций. Возвращается: if |
|
key string |
Ключ. Возвращается: if |
|
key_tag integer |
Тег ключа. Возвращается: if |
|
labels integer |
Метки. Возвращается: if |
|
latitude list / elements=integer |
Широта местоположения. Возвращается: if |
|
longitude list / elements=integer |
Долгота местоположения. Возвращается: if |
|
mbox string |
Mbox. Возвращается: if |
|
minimum integer |
Используется для вычисления TTL для целей отрицательного кэширования. Возвращается: if |
|
mname string |
Основной первичный сервер имен для этой зоны. Возвращается: if |
|
mtype integer |
Mtype. Возвращается: if |
|
next string |
Следующее значение. Возвращается: if |
|
order integer |
Порядок значения. Возвращается: if |
|
original_ttl integer |
Оригинальный TTL. Возвращается: if |
|
os string |
Операционная система. Возвращается: if |
|
port integer |
Порт. Возвращается: if |
|
preference integer |
Значение предпочтения для этой записи. Возвращается: if |
|
priority integer |
Приоритет значения для этой записи. Возвращается: if |
|
protocol integer |
Протокол. Возвращается: if |
|
refresh integer |
Количество секунд, после которых вторичные серверы имен должны запрашивать основной сервер имен для записи SOA, чтобы обнаружить изменения в зоне. Возвращается: if |
|
regexp string |
Регулярное выражение. Возвращается: if |
|
replacement string |
Замена. Возвращено: if |
|
retry integer |
Количество секунд, после которых вторичные серверы имен должны повторить попытку запроса серийного номера у основного сервера имен, если основной сервер имен не отвечает. Возвращено: if |
|
rname string |
Электронный адрес администратора, ответственного за эту зону. Возвращено: if |
|
salt string |
Ключ. Возвращено: if |
|
selector integer |
Селектор. Возвращено: if |
|
serial integer |
Серийный номер для этой зоны. Возвращено: if |
|
service string |
Сервис. Возвращено: if |
|
signature string |
Подпись. Возвращено: if |
|
signer string |
Подписывающий. Возвращено: if |
|
size float |
Размер местоположения. Возвращено: if |
|
strings list / elements=string |
Список строк для этой записи. См. |
|
tag string |
Тег. Возвращено: if |
|
target string |
Цель. Возвращено: if |
|
txt string |
Значение TXT. Возвращено: if |
|
type_covered string |
Охваченный тип. Возвращено: if |
|
usage integer |
Флаг использования. Возвращено: if |
|
value string | |
|
vertical_precision float |
Вертикальная точность местоположения. Возвращено: if |
|
weight integer |
Вес сервиса. Возвращено: if |
|
windows string |
Окна. Возвращено: if |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/dns/nameserver_record_info_module.html