Модуль community.general.memset_zone — Создаёт и удаляет зоны DNS Memset

Примечание

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

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

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

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

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

Описание

Управление зонами DNS в аккаунте Memset.

Параметры

Параметр	Комментарии
api_key строка / обязательно	Ключ API, полученный из панели управления Memset.
force логическое	Принудительно удаляет зону и все домены/записи зоны, которые она содержит. Варианты: `false` ← (по умолчанию) `true`
name алиасы: nickname строка / обязательно	Псевдоним зоны; обычно совпадает с основным доменом. Убедитесь, что это значение имеет не более 250 символов.
state строка / обязательно	Указывает желаемое состояние ресурса. Варианты: `"absent"` `"present"`
ttl целое число	Значение TTL по умолчанию для всех записей, созданных в зоне. Оно должно быть допустимым целым числом из https://www.memset.com/apidocs/methods_dns.html#dns.zone_create. Варианты: `0` ← (по умолчанию) `300` `600` `900` `1800` `3600` `7200` `10800` `21600` `43200` `86400`

Атрибуты

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

Примечания

Примечание

Зоны можно рассматривать как логическую группу доменов, все из которых используют одни и те же записи DNS (т. е. они указывают на один и тот же IP). Ключ API, сгенерированный через панель управления клиентом Memset, необходим с минимальными правами доступа — dns.zone_create, dns.zone_delete, dns.zone_list.

Примеры

# Create the zone 'test'
- name: Create zone
  community.general.memset_zone:
    name: test
    state: present
    api_key: 5eb86c9196ab03919abcf03857163741
    ttl: 300
  delegate_to: localhost

# Force zone deletion
- name: Force delete zone
  community.general.memset_zone:
    name: test
    state: absent
    api_key: 5eb86c9196ab03919abcf03857163741
    force: true
  delegate_to: localhost

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

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

Ключ	Описание
memset_api сложный	Информация о зоне из API Memset Возвращается: при state == present
domains список / элементы=строка	Список доменов в этой зоне Возвращается: всегда Пример: `[]`
id строка	Идентификатор зоны Возвращается: всегда Пример: `"b0bb1ce851aeea6feeb2dc32fe83bf9c"`
nickname строка	Имя зоны Возвращается: всегда Пример: `"example.com"`
records список / элементы=строка	Список записей DNS для доменов в этой зоне Возвращается: всегда Пример: `[]`
ttl целое число	Значение по умолчанию TTL для доменов в этой зоне Возвращается: всегда Пример: `300`

Авторы

Simon Weald (@glitchcrab)

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

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