memset_zone_record – Создание и удаление записей в зонах DNS Memset

Новая в версии 2.6.

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

Описание

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

Параметры

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

Примечания

Примечание

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

Примеры

# Create DNS record for www.domain.com
- name: create DNS record
  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
  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
  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' }

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

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

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

Статус

Этот модуль не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Simon Weald (@glitchcrab)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/memset_zone_record_module.html