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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом 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_domain_module.html