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

Примечание

Этот модуль входит в коллекцию ngine_io.exoscale (версия 1.1.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.exoscale. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: ngine_io.exoscale.exo_dns_domain.

Добавлен в ngine_io.exoscale 0.1.0

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

Обзор

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

Требования

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

python >= 2.6

Параметры

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

Примечания

Примечание

Поскольку 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
  exo_dns_domain:
    name: example.com

- name: Remove a domain
  exo_dns_domain:
    name: example.com
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
exo_dns_domain complex	Результаты домена API Возвращено: success
account_id integer	Ваш ID аккаунта Возвращено: success Пример: `34569`
auto_renew boolean	Включено ли автоматическое продление домена или нет Возвращено: success Пример: `false`
created_at string	Когда был создан домен Возвращено: success Пример: `"2016-08-12T15:24:23.989Z"`
expires_on string	Когда истекает срок действия домена Возвращено: success Пример: `"2016-08-12T15:24:23.989Z"`
id integer	ID домена Возвращено: success Пример: `"2016-08-12T15:24:23.989Z"`
lockable boolean	Можно ли заблокировать домен или нет Возвращено: success Пример: `true`
name string	Имя домена Возвращено: success Пример: `"example.com"`
record_count integer	Количество записей, связанных с этим доменом Возвращено: success Пример: `5`
registrant_id integer	ID регистратора Возвращено: success
service_count integer	Количество сервисов Возвращено: success Пример: `0`
state string	Состояние домена Возвращено: success Пример: `"hosted"`
token string	Токен Возвращено: success Пример: `"r4NzTRp6opIeFKfaFYvOd6MlhGyD07jl"`
unicode_name string	Имя домена в Unicode Возвращено: success Пример: `"example.com"`
updated_at string	Когда домен был последний раз обновлен. Возвращено: success Пример: `"2016-08-12T15:24:23.989Z"`
user_id integer	ID пользователя Возвращено: success
whois_protected boolean	Защищена ли информация WHOIS или нет Возвращено: success Пример: `false`

Авторы

René Moser (@resmo)

Ссылки на коллекцию

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