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