Модуль community.general.memset_dns_reload — запрос на перезагрузку DNS-инфраструктуры Memset,

Примечание

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

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

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

Чтобы использовать коллекцию в плейбуке, укажите: community.general.memset_dns_reload.

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

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

Запрашивает перезагрузку DNS-инфраструктуры Memset и, при необходимости, ожидает её завершения.

Параметры

Параметр	Комментарии
api_key строка / обязательный	Ключ API, полученный в панели управления Memset.
poll логический	Если `true`, модуль проверяет состояние задания перезагрузки и возвращает управление после его завершения (если только раньше не истекут 30 секунд ожидания). Если время ожидания истечёт, задача не завершится с ошибкой, но в stderr будет указано, что проверка состояния завершилась неудачно. Варианты: `false` ← (по умолчанию) `true`

Параметр

Комментарии

api_key

строка / обязательный

Ключ API, полученный в панели управления Memset.

poll

логический

Если true, модуль проверяет состояние задания перезагрузки и возвращает управление после его завершения (если только раньше не истекут 30 секунд ожидания). Если время ожидания истечёт, задача не завершится с ошибкой, но в stderr будет указано, что проверка состояния завершилась неудачно.

Варианты:

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

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может выполняться в режиме `check_mode` и возвращать прогноз состояния изменения без внесения изменений на целевом узле.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения о внесённых изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

Запросы на перезагрузку DNS предоставляются Memset по принципу «по возможности». Обычно перезагрузка выполняется каждые 15 минут, но можно запросить её немедленно, если последующие задачи зависят от создания записей. Требуется ключ API, созданный в панели управления клиента Memset, со следующей минимальной областью действия: dns.reload. Для проверки состояния задания и ожидания завершения перезагрузки также требуется job.status.

Примеры

- name: Submit DNS reload and poll
  community.general.memset_dns_reload:
    api_key: 5eb86c9196ab03919abcf03857163741
    poll: true
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Описание
memset_api сложный тип	Исходный ответ API Memset. Возвращается: всегда
error логический	Завершилось ли задание с ошибкой. Возвращается: всегда Пример: `true`
finished логический	Завершилось ли задание до возврата результата. Возвращается: всегда Пример: `true`
id строка	Идентификатор задания. Возвращается: всегда Пример: `"c9cc8ad2a3e3fb8c63ed83c424928ef8"`
status строка	Состояние задания. Возвращается: всегда Пример: `"DONE"`
type строка	Тип задания. Возвращается: всегда Пример: `"dns"`

Авторы

Simon Weald (@glitchcrab)

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

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