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

Статус

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