exo_dns_record — Управляет записями DNS в Exoscale DNS.

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

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

Обзор

Создание, обновление и удаление записей.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API для Exoscale DNS API. Начиная с версии 2.4, переменная окружения `CLOUDSTACK_KEY` используется в качестве значения по умолчанию, если она определена.
api_region	По умолчанию: cloudstack	Имя раздела ini в файле `cloustack.ini`. Начиная с версии 2.4, переменная окружения `CLOUDSTACK_REGION` используется в качестве значения по умолчанию, если она определена.
api_secret		Секретный ключ Exoscale DNS API. Начиная с версии 2.4, переменная окружения `CLOUDSTACK_SECRET` используется в качестве значения по умолчанию, если она определена.
api_timeout	По умолчанию: 10	Таймаут HTTP-запросов к Exoscale DNS API. Начиная с версии 2.4, переменная окружения `CLOUDSTACK_TIMEOUT` используется в качестве значения по умолчанию, если она определена.
content		Содержание записи. Требуется, если `state=present` или `multiple=yes`. псевдонимы: значение, адрес
domain обязательно		Домен, к которому относится запись.
multiple	Варианты: нет ← да	Применяется ли для нескольких записей с аналогичными `name` и `record_type`. Допускается только для некоторых типов записей, например, `record_type=A`, `record_type=NS` или `record_type=MX`. `content` не будет обновлён, вместо этого он используется в качестве ключа для поиска существующих записей.
name	По умолчанию:	Имя записи.
prio		Приоритет записи. псевдонимы: приоритет
record_type	Варианты: A ← ALIAS CNAME MX SPF URL TXT NS SRV NAPTR PTR AAAA SSHFP HINFO POOL	Тип записи. псевдонимы: rtype, type
state	Варианты: present ← absent	Состояние записи.
ttl	По умолчанию: 3600	TTL записи в секундах.
validate_certs	Варианты: нет да ←	Проверка SSL-сертификатов API Exoscale DNS.

Примечания

Примечание

Так как Exoscale DNS использует один и тот же ключ API и секрет для всех служб, мы повторно используем конфигурацию, используемую для Exoscale Compute на основе CloudStack. Конфигурация считывается из нескольких мест в указанном порядке. Переменные окружения CLOUDSTACK_KEY, CLOUDSTACK_SECRET. Переменная окружения CLOUDSTACK_CONFIG , указывающая на файл .ini. Файл cloudstack.ini в текущей рабочей директории. Файл .cloudstack.ini в домашней директории пользователя. Дополнительно можно указать несколько учетных данных и конечных точек с использованием разделов ini в cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию это cloudstack.
Этот модуль не поддерживает несколько записей A и выдаст соответствующее сообщение об ошибке, если вы попытаетесь это сделать.
Дополнительную информацию о Exoscale DNS можно найти на https://community.exoscale.ch/documentation/dns/.
Этот модуль поддерживает режим проверки и сравнение.

Примеры

- name: Create or update an A record
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.4

- name: Update an existing A record with a new IP
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.5

- name: Create another A record with same name
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.6
    multiple: yes

- name: Create or update a CNAME record
  local_action:
    module: exo_dns_record
    name: www
    domain: example.com
    record_type: CNAME
    content: web-vm-1

- name: Create another MX record
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    prio: 10
    multiple: yes

- name: Delete one MX record out of multiple
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    multiple: yes
    state: absent

- name: Remove a single A record
  local_action:
    module: exo_dns_record
    name: www
    domain: example.com
    state: absent

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

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

Ключ		Возвращаемое значение	Описание
exo_dns_record сложное		успех	Результаты API-запроса
	domain строка	успех	Имя домена Пример: example.com
	name строка	успех	Имя записи Пример: www
	prio целое число	успех	Приоритет записи Пример: 10
	parent_id целое число	успех	ID родителя
	system_record булево	успех	Является ли запись системной
	created_at строка	успех	Дата создания записи Пример: 2016-08-12T15:24:23.989Z
	updated_at строка	успех	Дата обновления записи Пример: 2016-08-12T15:24:23.989Z
	id целое число	успех	ID записи Пример: 254324
	content строка	успех	Значение записи Пример: 1.2.3.4
	record_type строка	успех	Тип записи Пример: A
	ttl целое число	успех	Время жизни записи Пример: 3600
	domain_id целое число	успех	ID домена Пример: 254324

Статус

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

Автор

René Moser (@resmo)

Подсказка

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

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