Модуль community.general.memset_zone — создание и удаление DNS-зон Memset

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

Зоны можно рассматривать как логическую группу доменов, которые используют одни и те же записи 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/memset_zone_module.html