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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Параметры

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

Статус

Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратная совместимость.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Более подробная информация представлена в поддержке и обслуживании модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/memset_zone_record_module.html