community.general.memset_zone – Создаёт и удаляет зоны DNS Memset.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.memset_zone.
Описание
- Управление зонами DNS в учётной записи Memset.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key строка / обязательно | Ключ API, полученный из панели управления Memset. | |
| force булево |
| Вынуждает удаление зоны и всех доменов/записей зоны, которые она содержит. |
| name строка / обязательно | Псевдоним зоны; обычно совпадает с основным доменом. Убедитесь, что это значение не превышает 250 символов. псевдонимы: псевдоним | |
| state строка / обязательно |
| Указывает желаемое состояние ресурса. |
| ttl целое число |
| Значение по умолчанию TTL для всех записей, созданных в зоне. Это должно быть действительное целое число из https://www.memset.com/apidocs/methods_dns.html#dns.zone_create. |
Примечания
Примечание
- Зоны можно рассматривать как логическую группу доменов, которые все используют одни и те же записи 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 сложный | при state == присутствует | Информация о зоне из API Memset | |
| domains список / элементы=строка | всегда | Список доменов в этой зоне | |
| id строка | всегда | Идентификатор зоны Пример: b0bb1ce851aeea6feeb2dc32fe83bf9c | |
| nickname строка | всегда | Имя зоны Пример: example.com | |
| records список / элементы=строка | всегда | Список записей DNS для доменов в этой зоне | |
| ttl целое число | всегда | Значение по умолчанию TTL для доменов в этой зоне Пример: 300 | |
Авторы
- Simon Weald (@glitchcrab)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/memset_zone_module.html
