Spec-Zone.ru › Ansible

Модуль 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

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

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

Варианты:

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

name

list / elements=string / required

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

query_retry

integer

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

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

query_timeout

float

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

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

server

list / elements=string

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

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

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

servfail_retries

integer

Сколько раз повторять попытки при ошибках SERVFAIL.

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

type

string / required

Тип записи для получения.

Варианты:

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

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

diff_mode

Поддержка: N/A

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

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

Примечания

Примечание

  • 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.

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

Пример: [{"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

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

Возвращается: при успехе

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

nameserver

string

Сервер имен.

Возвращается: при успехе

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

values

list / elements=dictionary

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

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

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

Возвращается: при успехе

Пример: [{"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 timestamp.

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

expire

integer

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

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

fingerprint

string

Отпечаток.

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

flags

integer

Флаги.

На самом деле это тип string для type=NAPTR.

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

fp_type

integer

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

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

horizontal_precision

float

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

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

inception

integer

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

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

iterations

integer

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

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

key

string

Ключ.

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

key_tag

integer

Тег ключа.

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

labels

integer

Метки.

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

latitude

list / elements=integer

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

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

longitude

list / elements=integer

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

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

mbox

string

Mbox.

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

minimum

integer

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

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

mname

string

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

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

mtype

integer

Mtype.

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

next

string

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

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

order

integer

Порядок значения.

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

original_ttl

integer

Оригинальный TTL.

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

os

string

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

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

port

integer

Порт.

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

preference

integer

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

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

priority

integer

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

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

protocol

integer

Протокол.

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

refresh

integer

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

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

regexp

string

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

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

replacement

string

Замена.

Возвращено: if type=NAPTR

retry

integer

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

Возвращено: if type=SOA

rname

string

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

Возвращено: if type=SOA

salt

string

Ключ.

Возвращено: if type=NSEC3 or type=NSEC3PARAM

selector

integer

Селектор.

Возвращено: if type=TLSA

serial

integer

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

Возвращено: if type=SOA

service

string

Сервис.

Возвращено: if type=NAPTR

signature

string

Подпись.

Возвращено: if type=RRSIG

signer

string

Подписывающий.

Возвращено: if type=RRSIG

size

float

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

Возвращено: if type=LOC

strings

list / elements=string

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

См. results[].result[].values[].value для объединенного результата.

Возвращено: if type=SPF or type=TXT

tag

string

Тег.

Возвращено: if type=CAA

target

string

Цель.

Возвращено: if type=CNAME or type=DNAME or type=NS or type=PTR or type=SRV

txt

string

Значение TXT.

Возвращено: if type=RP

type_covered

string

Охваченный тип.

Возвращено: if type=RRSIG

usage

integer

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

Возвращено: if type=TLSA

value

string

Значение.

Для type=SPF или type=TXT, это конкатенация results[].result[].values[].strings.

Возвращено: if type=CAA or type=SPF or type=TXT

vertical_precision

float

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

Возвращено: if type=LOC

weight

integer

Вес сервиса.

Возвращено: if type=SRV

windows

string

Окна.

Возвращено: if type=NSEC or type=NSEC3

Авторы

  • Felix Fontein (@felixfontein)

Ссылки на сборку

  • Отслеживание ошибок
  • Репозиторий (источники)
  • Задать вопрос (DNS)
  • Отправить сообщение об ошибке
  • Запросить функцию
  • Общение

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API