community.dns.hosttech_dns_zone_info модуль – Получение информации о зоне в службе DNS Hosttech

Примечание

Этот модуль входит в коллекцию community.dns (версия 3.0.5).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.dns. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.

Чтобы использовать его в плейбуке, укажите: community.dns.hosttech_dns_zone_info.

Новинка в community.dns 0.2.0

Описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Описание

Получает информацию о зоне в службе DNS Hosttech.

Требования

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

lxml

Параметры

Параметр	Комментарии
hosttech_password строка	Пароль пользователя API Hosttech. Если указан, `hosttech_username` также должен быть указан. Взаимоисключающий с `hosttech_token`.
hosttech_token псевдонимы: api_token строка добавлен в community.dns 0.2.0	Пароль пользователя API Hosttech. Взаимоисключающий с `hosttech_username` и `hosttech_password`. Начиная с community.dns 1.2.0, можно использовать псевдоним `api_token`.
hosttech_username строка	Имя пользователя пользователя API Hosttech. Если указан, `hosttech_password` также должен быть указан. Взаимоисключающий с `hosttech_token`.
zone_id целое число добавлен в community.dns 0.2.0	Идентификатор зоны DNS для запроса. Должен быть указан ровно один из `zone_name` и `zone_id`.
zone_name псевдонимы: zone строка	Запрашиваемая зона DNS. Должен быть указан ровно один из `zone_name` и `zone_id`.

Атрибуты

Атрибут	Поддержка	Описание
action_group	Группа действий: community.dns.hosttech добавлен в community.dns 2.4.0	Используйте `group/community.dns.hosttech` в `module_defaults` для установки значений по умолчанию для этого модуля.
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может работать в `check_mode` и возвращать прогноз статуса изменения без изменения целевого объекта.
diff_mode	Поддержка: нет Это действие не изменяет состояние.	Вернет детали изменений (или, возможно, изменений, которые нужно внести в `check_mode`), когда используется режим diff.

Примеры

- name: Retrieve details for foo.com zone
  community.dns.hosttech_dns_zone_info:
    zone_name: foo.com
    hosttech_username: foo
    hosttech_password: bar
  register: rec

- name: Retrieve details for zone 23
  community.dns.hosttech_dns_zone_info:
    zone_id: 23
    hosttech_token: access_token

Значения возврата

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

Ключ	Описание
zone_id целое число	Идентификатор зоны. Возвращается: успех Пример: `23`
zone_info словарь добавлено в community.dns 2.0.0	Дополнительная информация, возвращаемая API. Возвращается: успех Пример: `{"dnssec": true, "dnssec_email": "test@example.com", "ds_records": [], "email": "test@example.com", "ttl": 3600}`
dnssec логическое значение	Включен ли DNSSEC для зоны. Возвращается: При указании `hosttech_token`
dnssec_email строка	Адрес электронной почты, на который отправляются уведомления при изменении ключа DNSSEC. Значение `none`, если DNSSEC не включен. Возвращается: При указании `hosttech_token`
ds_records список / элементы=словарь	Записи DS. Подробности см. в разделе 5 RFC 4034 и разделе 2.1 RFC 4034. Значение `none`, если DNSSEC не включен. Возвращается: При указании `hosttech_token`
algorithm целое число	Это значение — номер алгоритма DNSKEY RR, на который ссылается запись DS. Список значений можно найти в приложении A.1 RFC 4034. Возвращается: успех Пример: `8`
digest строка	Хеш-значение записи DNSKEY RR, на которую ссылается эта запись DS. Возвращается: успех Пример: `"012356789ABCDEF0123456789ABCDEF012345678"`
digest_type целое число	Это значение идентифицирует алгоритм, используемый для вычисления хеша. Список значений можно найти в приложении A.2 RFC 4034. Возвращается: успех Пример: `1`
flags целое число	Флаг ключа зоны. Подробности см. в разделе 2.1.1 RFC 4034. Возвращается: успех Пример: `257`
key_tag целое число	Поле Key Tag содержит тег ключа DNSKEY RR, на который ссылается запись DS. Возвращается: успех Пример: `12345`
protocol целое число	Должно быть равно 3, согласно RFC 4034. Возвращается: успех Пример: `3`
public_key строка	Материал открытого ключа. Возвращается: успех Пример: `"MuhdzsQdqEGShwjtJDKZZjdKqUSGluFzTTinpuEeIRzLLcgkwgAPKWFa eQntNlmcNDeCziGwpdvhJnvKXEMbFcZwsaDIJuWqERxAQNGABWfPlCLh HQPnbpRPNKipSdBaUhuOubvFvjBpFAwiwSAapRDVsAgKvjXucfXpFfYb pCundbAXBWhbpHVbqgmGoixXzFSwUsGVYLPpBCiDlLJwzjRKYYaoVYge kMtKFYUVnWIKbectWkDFdVqXwkKigCUDiuTTJxOBRJRNzGiDNMWBjYSm bBCAHMaMYaghLbYTwyKXltdHTHwBwtswGNfpnEdSpKFzZJonBZArQfHD lfceKgmKwEF="`
email строка	Адрес электронной почты зоны из записи SOA. Возвращается: успех
ttl целое число	TTL зоны. Возвращается: успех
zone_name целое число	Имя зоны. Возвращается: успех Пример: `"example.com"`

Авторы

Felix Fontein (@felixfontein)

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

© 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/hosttech_dns_zone_info_module.html