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

Примечание

Этот модуль входит в коллекцию community.dns (версия 3.5.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

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

Краткое описание

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

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

lxml

Параметры

Параметр	Комментарии
hosttech_password string	Пароль пользователя API Hosttech. Если указан, необходимо также указать `hosttech_username`. Несовместим с `hosttech_token`.
hosttech_token псевдонимы: api_token string добавлено в community.dns 0.2.0	Пароль пользователя API Hosttech. Несовместим с `hosttech_username` и `hosttech_password`. Начиная с community.dns 1.2.0, можно использовать псевдоним `api_token`.
hosttech_username string	Имя пользователя API Hosttech. Если указано, необходимо также указать `hosttech_password`. Несовместим с `hosttech_token`.
zone_id integer добавлено в community.dns 0.2.0	Идентификатор запрашиваемой зоны DNS. Необходимо указать ровно один из параметров `zone_name` и `zone_id`.
zone_name псевдонимы: zone string	Запрашиваемая зона 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	Поддержка: не применимо Это действие не изменяет состояние.	В режиме diff будут возвращены сведения об изменениях (или о возможных необходимых изменениях в `check_mode`).
idempotent	Поддержка: полная Это действие не изменяет состояние.	При повторном запуске с теми же аргументами вне режима проверки второй вызов сообщает об отсутствии изменений. Предполагается, что система, которой управляет модуль или к которой он обращается, не изменилась существенным образом.

Примеры

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

Авторы

Felix Fontein (@felixfontein)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/dns/hosttech_dns_zone_info_module.html