Модуль community.hrobot.reverse_dns — установка или удаление записи обратного DNS для IP-адреса

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.hrobot.

Чтобы использовать её в плейбуке, укажите: community.hrobot.reverse_dns.

Добавлено в community.hrobot 1.2.0

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

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

Позволяет установить, обновить или удалить запись обратного DNS для IP-адреса.

Параметры

Параметр	Описание
hetzner_password string / обязательный	Пароль пользователя веб-службы Robot.
hetzner_user string / обязательный	Имя пользователя веб-службы Robot.
ip string / обязательный	IP-адрес, для которого нужно установить или удалить запись обратного DNS.
rate_limit_retry_timeout integer добавлено в community.hrobot 2.1.0	Время ожидания (в секундах) при получении ошибок превышения ограничения частоты запросов. Укажите `0`, чтобы не выполнять повторные попытки. Укажите отрицательное значение, например `-1`, чтобы повторять попытки бесконечно. По умолчанию: `-1`
state string	Указывает, следует ли установить или обновить (`present`) либо удалить (`absent`) запись обратного DNS для `ip`. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
value string	Запись обратного DNS для `ip`. Обязателен, если указано `state=present`.

Атрибуты

Атрибут	Поддержка	Описание
action_group	Группа действий: community.hrobot.robot добавлено в community.hrobot 1.6.0	Используйте `group/community.hrobot.robot` в `module_defaults`, чтобы задать значения по умолчанию для этого модуля.
check_mode	Поддержка: full	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевую систему.
diff_mode	Поддержка: none	В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).
idempotent	Поддержка: full	При повторном запуске с теми же аргументами вне режима проверки второй вызов не сообщает об изменениях. Предполагается, что система, которой управляет модуль или к которой он обращается, не изменилась существенным образом.

Примечания

Примечание

Для основного IPv4-адреса сервера удаление записи фактически заменяет её именем хоста по умолчанию, например static.X.Y.Z.W.clients.your-server.de. Эта подстановка (удаление заменяется изменением на это значение) автоматически выполняется API, поэтому в данном случае модуль не является идемпотентным.

Примеры

---
- name: Set reverse DNS entry for 1.2.3.4
  community.hrobot.reverse_dns:
    hetzner_user: foo
    hetzner_password: bar
    ip: 1.2.3.4
    value: foo.example.com

- name: Remove reverse DNS entry for 2a01:f48:111:4221::1
  community.hrobot.reverse_dns:
    hetzner_user: foo
    hetzner_password: bar
    ip: 2a01:f48:111:4221::1
    state: absent

Авторы

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/hrobot/reverse_dns_module.html