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 -		Секретный ключ API для 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 boolean	Варианты: нет ← да	Указывает, существует ли более одной записи с подобными `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 boolean	Варианты: нет да ←	Проверять SSL-сертификаты Exoscale DNS API.

Примечания

Примечание

Так как Exoscale DNS использует один и тот же ключ API и секрет для всех служб, мы используем конфигурацию, используемую для Exscale 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 complex		успех	Результаты записи API
	content строка	успех	значение записи Пример: 1.2.3.4
	created_at строка	успех	Дата создания записи Пример: 2016-08-12T15:24:23.989Z
	domain строка	успех	Имя домена Пример: example.com
	domain_id целое число	успех	ID домена Пример: 254324
	id целое число	успех	ID записи Пример: 254324
	name строка	успех	Имя записи Пример: www
	parent_id целое число	успех	ID родителя
	prio целое число	успех	Приоритет записи Пример: 10
	record_type строка	успех	Тип записи Пример: A
	system_record boolean	успех	Является ли запись системной
	ttl целое число	успех	Время жизни записи Пример: 3600
	updated_at строка	успех	Дата обновления записи Пример: 2016-08-12T15:24:23.989Z

Статус

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

Авторы

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