Модуль community.dns.hetzner_dns_zone_info – получение сведений о зоне в службе Hetzner DNS
Примечание
Этот модуль входит в коллекцию community.dns (версия 3.5.5).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.dns.
Чтобы использовать коллекцию в плейбуке, укажите: community.dns.hetzner_dns_zone_info.
Новое в community.dns 2.0.0
Краткое описание
- Получает сведения о зоне в службе Hetzner DNS.
Параметры
Параметр | Комментарии |
|---|---|
hetzner_api_token string | Токен для нового API Hetzner DNS. Если не указан, будет получен из переменной окружения Необходимо указать ровно один из параметров |
hetzner_token псевдонимы: api_token string | Токен для классического API Hetzner DNS. Если не указан, будет получен из переменной окружения Необходимо указать ровно один из параметров |
zone_id string добавлено в community.dns 0.2.0 | |
zone_name псевдонимы: zone string |
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
action_group | Группа действий: community.dns.hetzner добавлено в community.dns 2.4.0 | Используйте |
check_mode | Поддержка: полная Это действие не изменяет состояние. | Может выполняться в режиме |
diff_mode | Поддержка: Н/Д Это действие не изменяет состояние. | В режиме diff будут возвращены сведения об изменениях (или о возможных изменениях в |
idempotent | Поддержка: полная Это действие не изменяет состояние. | При повторном запуске с теми же аргументами вне режима проверки второй вызов сообщает об отсутствии изменений. Предполагается, что система, которой управляет модуль или сведения о которой он получает, не изменилась существенным образом. |
Примечания
Примечание
- Обратите внимание: оба API поддерживают не все типы записей. Старый API (
hetzner_token) не поддерживает записиHTTPS,PTRиSVCB. Новый API (hetzner_api_token) не поддерживает записиDANE.
Примеры
- name: Retrieve details for foo.com zone
community.dns.hetzner_dns_zone_info:
zone: foo.com
hetzner_token: access_token
register: rec
- name: Retrieve details for zone 23
community.dns.hetzner_dns_zone_info:
zone_id: 23
hetzner_token: access_token
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
zone_id string | Идентификатор зоны. Возвращается: при успешном выполнении Пример: |
zone_info dictionary | Дополнительные сведения, возвращаемые API. Возвращается: при успешном выполнении |
|
created string |
Время создания зоны. Возвращается: при успешном выполнении Пример: |
|
is_secondary_dns boolean |
Указывает, является ли зона вторичной DNS-зоной. Возвращается: при успешном выполнении Пример: |
|
legacy_dns_host string |
Неизвестно. Возвращается: если зона была импортирована |
|
legacy_ns list / элементы=string |
Список серверов имён на момент импорта. Возвращается: если зона была импортирована |
|
modified string |
Время последнего изменения зоны. Возвращается: при успешном выполнении Пример: |
|
ns list / элементы=string |
Список серверов имён, которые должны быть назначены зоне для использования DNS Hetzner. Возвращается: при успешном выполнении |
|
owner string |
Владелец зоны. Возвращается: при успешном выполнении |
|
paused boolean |
Неизвестно. Возвращается: при успешном выполнении Пример: |
|
permission string |
Разрешения для зоны. Возвращается: при успешном выполнении |
|
project string |
Неизвестно. Возвращается: при успешном выполнении |
|
records_count integer |
Количество записей, связанных с этой зоной. Возвращается: при успешном выполнении Пример: |
|
registrar string |
Неизвестно. Возвращается: при успешном выполнении |
|
status string |
Статус зоны. Возможные значения: Возвращается: при успешном выполнении Пример: |
|
ttl integer |
TTL зоны. Возвращается: при успешном выполнении Пример: |
|
txt_verification dictionary |
Формат TXT-записи, которую необходимо добавить для проверки зоны. Если имя и токен пусты, добавлять TXT-запись не требуется. Возвращается: при успешном выполнении Пример: |
|
name string |
Имя TXT-записи. Возвращается: при успешном выполнении |
|
token string |
Содержимое TXT-записи. Возвращается: при успешном выполнении |
|
verified string |
Время проверки зоны. Возвращается: при успешном выполнении Пример: |
zone_name integer | Имя зоны. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 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/hetzner_dns_zone_info_module.html