exo_dns_domain — Управляет записями домена в API 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`, если она определена.
name обязательно		Имя записи.
state	Варианты: present ← absent	Состояние ресурса.
validate_certs	Варианты: no yes ←	Проверять SSL-сертификаты Exoscale DNS API.

Примечания

Примечание

Так как 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/.
Этот модуль поддерживает режим проверки и diff.

Примеры

- name: Create a domain
  local_action:
    module: exo_dns_domain
    name: example.com

- name: Remove a domain
  local_action:
    module: exo_dns_domain
    name: example.com
    state: absent

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

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

Ключ		Возвращаемое значение	Описание
exo_dns_domain сложный		success	Результаты API домена
	record_count int	success	Количество записей, связанных с данным доменом Пример: 5
	account_id int	success	Ваш идентификатор учетной записи Пример: 34569
	updated_at строка	success	Дата последнего обновления домена. Пример: 2016-08-12T15:24:23.989Z
	service_count int	success	Количество сервисов
	whois_protected bool	success	Защищен ли whois
	lockable bool	success	Можно ли заблокировать домен Пример: True
	registrant_id int	success	Идентификатор регистратора
	id int	success	Идентификатор домена Пример: 2016-08-12T15:24:23.989Z

Статус

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

Автор

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_domain_module.html