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

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

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

Требования

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

python >= 2.6

Параметры

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

Примечания

Примечание

Так как 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

Статус

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