Модуль community.general.memset_zone_record – Создание и удаление записей в зонах DNS Memset

Примечание

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

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

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

Чтобы использовать её в книге задач, укажите: community.general.memset_zone_record.

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

Описание

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

Параметры

Параметр	Комментарии
address псевдонимы: ip, данные строка / обязательно	Адрес этой записи (может быть IP-адресом или текстовой строкой в зависимости от типа записи).
api_key строка / обязательно	Ключ API, полученный из панели управления Memset.
priority целое число	Приоритет записи в диапазоне 0 > 999 (включительно). По умолчанию: `0`
record строка	Поддомен для создания. По умолчанию: `""`
relative логическое значение	Если установлено, текущий домен добавляется в поле адреса для типов записей `CNAME`, `MX`, `NS` и `SRV`. Варианты: `false` ← (по умолчанию) `true`
state строка	Указывает желаемое состояние ресурса. Варианты: `"absent"` `"present"` ← (по умолчанию)
ttl целое число	TTL записи в секундах (будет наследоваться из TTL зоны, если не установлено явно). Это должно быть допустимое целое число из https://www.memset.com/apidocs/methods_dns.html#dns.zone_record_create. Варианты: `0` ← (по умолчанию) `300` `600` `900` `1800` `3600` `7200` `10800` `21600` `43200` `86400`
type строка / обязательно	Тип записи DNS для создания. Варианты: `"A"` `"AAAA"` `"CNAME"` `"MX"` `"NS"` `"SRV"` `"TXT"`
zone строка / обязательно	Имя зоны, в которую нужно добавить запись.

Атрибуты

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

Примечания

Примечание

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

Примеры

# Create DNS record for www.domain.com
- name: Create DNS record
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    state: present
    zone: domain.com
    type: A
    record: www
    address: 1.2.3.4
    ttl: 300
    relative: false
  delegate_to: localhost

# create an SPF record for domain.com
- name: Create SPF record for domain.com
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    state: present
    zone: domain.com
    type: TXT
    address: "v=spf1 +a +mx +ip4:a1.2.3.4 ?all"
  delegate_to: localhost

# create multiple DNS records
- name: Create multiple DNS records
  community.general.memset_zone_record:
    api_key: dcf089a2896940da9ffefb307ef49ccd
    zone: "{{ item.zone }}"
    type: "{{ item.type }}"
    record: "{{ item.record }}"
    address: "{{ item.address }}"
  delegate_to: localhost
  with_items:
    - { 'zone': 'domain1.com', 'type': 'A', 'record': 'www', 'address': '1.2.3.4' }
    - { 'zone': 'domain2.com', 'type': 'A', 'record': 'mail', 'address': '4.3.2.1' }

END_OF_DOCUMENT_MARKER

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

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

Ключ	Описание
memset_api сложное	Информация о записи из API Memset. Возвращается: при state == present
address строка	Содержание записи (может быть IP-адресом, строкой или пустым в зависимости от типа записи). Возвращается: всегда Пример: `"1.1.1.1"`
id строка	ID записи. Возвращается: всегда Пример: `"b0bb1ce851aeea6feeb2dc32fe83bf9c"`
priority целое число	Приоритет для записей `MX` и `SRV`. Возвращается: всегда Пример: `10`
record строка	Имя записи. Возвращается: всегда Пример: `"www"`
relative логическое	Добавляет текущий домен к полю address для типов `CNAME`, `MX`, `NS` и `SRV`. Возвращается: всегда Пример: `false`
ttl целое число	TTL записи. Возвращается: всегда Пример: `10`
type строка	Тип записи. Возвращается: всегда Пример: `"AAAA"`
zone_id строка	ID зоны. Возвращается: всегда Пример: `"b0bb1ce851aeea6feeb2dc32fe83bf9c"`

Авторы

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_record_module.html