ngine_io.exoscale.exo_dns_domain – Управляет записями домена в API Exoscale DNS.

Примечание

Этот плагин входит в коллекцию ngine_io.exoscale (версия 1.0.0).

Для установки используйте: ansible-galaxy collection install ngine_io.exoscale.

Для использования в книге задач укажите: ngine_io.exoscale.exo_dns_domain.

Новое в версии 0.1.0: of ngine_io.exoscale

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

Создание и удаление записей домена.

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Exoscale DNS API. Переменная среды `CLOUDSTACK_KEY` используется в качестве значения по умолчанию, если определена.
api_region строка	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. Переменная среды `CLOUDSTACK_REGION` используется в качестве значения по умолчанию, если определена.
api_secret строка		Секретный ключ API Exoscale DNS API. Переменная среды `CLOUDSTACK_SECRET` используется в качестве значения по умолчанию, если определена.
api_timeout целое число	Значение по умолчанию: 10	Таймаут HTTP-соединения с Exoscale DNS API. Переменная среды `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/.
Этот модуль поддерживает режим проверки и сравнения.

Примеры

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

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

Значения возврата

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

Ключ		Возвращаемое значение	Описание
exo_dns_domain сложный		успех	Результаты API домена
	account_id целое число	успех	Ваш ID учетной записи Пример: 34569
	auto_renew булево	успех	Автообновление домена
	created_at строка	успех	Дата создания домена Пример: 2016-08-12T15:24:23.989Z
	expires_on строка	успех	Дата истечения срока действия домена Пример: 2016-08-12T15:24:23.989Z
	id целое число	успех	ID домена Пример: 2016-08-12T15:24:23.989Z
	lockable булево	успех	Допускается ли блокировка домена Пример: True
	name строка	успех	Имя домена Пример: example.com
	record_count целое число	успех	Количество записей, связанных с этим доменом Пример: 5
	registrant_id целое число	успех	ID регистратора
	service_count целое число	успех	Количество служб
	state строка	успех	Состояние домена Пример: hosted
	token строка	успех	Токен Пример: r4NzTRp6opIeFKfaFYvOd6MlhGyD07jl
	unicode_name строка	успех	Имя домена в Unicode Пример: example.com
	updated_at строка	успех	Дата последнего обновления домена Пример: 2016-08-12T15:24:23.989Z
	user_id целое число	успех	ID пользователя
	whois_protected булево	успех	Защищен ли whois

Авторы

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.10/collections/ngine_io/exoscale/exo_dns_domain_module.html