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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address - / обязательно		Адрес для этой записи (может быть IP-адресом или текстовой строкой в зависимости от типа записи). псевдонимы: ip, data
api_key - / обязательно		Ключ API, полученный из панели управления Memset.
priority -		`SRV` и `TXT` приоритет записи, в диапазоне 0 > 999 (включительно).
record -		Поддомен для создания.
relative boolean	Варианты: нет да	Если установлено, то текущий домен добавляется к полю address для записей типа `CNAME`, `MX`, `NS` и `SRV`.
state -	Варианты: absent present ←	Указывает желаемое состояние ресурса.
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 complex		при state == present	Информация о записи из API Memset.
	address string	всегда	Содержание записи (может быть IP-адресом, строкой или пустым в зависимости от типа записи). Пример: 1.1.1.1
	id string	всегда	ID записи. Пример: b0bb1ce851aeea6feeb2dc32fe83bf9c
	priority целое число	всегда	Приоритет для записей `MX` и `SRV`. Пример: 10
	record строка	всегда	Имя записи. Пример: www
	relative boolean	всегда	Добавляет текущий домен к полю address для записей типов `CNAME`, `MX`, `NS` и `SRV`.
	ttl целое число	всегда	TTL записи. Пример: 10
	type строка	всегда	Тип записи. Пример: AAAA
	zone_id строка	всегда	ID зоны. Пример: b0bb1ce851aeea6feeb2dc32fe83bf9c

Статус

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

Авторы

Simon Weald (@analbeard)

Подсказка

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

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