community.general.memset_zone_record – Создание и удаление записей в зонах DNS Memset.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.memset_zone_record.
Описание
- Управление записями DNS в аккаунте Memset.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address строка / обязательно | Адрес для этой записи (может быть IP-адресом или текстовой строкой в зависимости от типа записи). псевдонимы: ip, data | |
| api_key строка / обязательно | Ключ API, полученный из панели управления Memset. | |
| priority целое число | SRV и TXT приоритет записи в диапазоне 0 > 999 (включительно). | |
| record строка | Поддомен для создания. | |
| relative логическое значение |
| Если установлено, тогда текущий домен добавляется к полю address для CNAME, MX, NS и SRV типов записей. |
| state строка |
| Указывает желаемое состояние ресурса. |
| ttl целое число |
| Время жизни (TTL) записи в секундах (при отсутствии явного значения используется TTL зоны). Это значение должно быть корректным целым числом, как указано в https://www.memset.com/apidocs/methods_dns.html#dns.zone_record_create. |
| type строка / обязательно |
| Тип записи 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
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' }
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| 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 | |
Авторы
- Simon Weald (@glitchcrab)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/memset_zone_record_module.html
