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

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

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

Обзор

Создаёт и удаляет записи домена.

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Exoscale DNS. Начиная с версии 2.4, переменная среды `CLOUDSTACK_KEY` используется в качестве значения по умолчанию, если она определена.
api_region	Значение по умолчанию: "cloudstack"	Имя раздела в файле `cloustack.ini`. Начиная с версии 2.4, переменная среды `CLOUDSTACK_REGION` используется в качестве значения по умолчанию, если она определена.
api_secret		Секретный ключ API Exoscale DNS. Начиная с версии 2.4, переменная среды `CLOUDSTACK_SECRET` используется в качестве значения по умолчанию, если она определена.
api_timeout	Значение по умолчанию: 10	Таймаут HTTP-запросов к API Exoscale DNS. Начиная с версии 2.4, переменная среды `CLOUDSTACK_TIMEOUT` используется в качестве значения по умолчанию, если она определена.
name обязательно		Имя записи.
state	Варианты: present ← absent	Состояние ресурса.
validate_certs bool	Варианты: no yes ←	Проверка SSL-сертификатов API Exoscale DNS.

Примечания

Примечание

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

Примеры

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

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание модулей и поддержка.

Список других модулей, поддерживаемых сообществом Ansible, см. в этом месте.

Автор

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