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	нет			Секретный ключ Exoscale DNS API. С версии 2.4, переменная среды `CLOUDSTACK_SECRET` используется по умолчанию, если она определена.
api_timeout	нет	10		Таймаут HTTP для Exoscale DNS API. С версии 2.4, переменная среды `CLOUDSTACK_TIMEOUT` используется по умолчанию, если она определена.
name	да			Имя записи.
state	нет	present	present absent	Состояние ресурса.
validate_certs	нет	True	yes no	Проверять SSL-сертификаты Exoscale DNS API.

Примеры

- 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

Результаты API домена

успех

сложный

содержит:

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

Примечания

Примечание

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

Статус

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

Для получения помощи в разработке модулей, если вы захотите, пожалуйста, ознакомьтесь с Справочной информацией сообщества и участием, Тестирование Ansible и Разработка модулей.

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