Модуль ngine_io.cloudstack.cs_domain – Управление доменами в облаках на основе Apache CloudStack.

Примечание

Этот модуль является частью коллекции ngine_io.cloudstack (версия 2.5.0).

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

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Вам потребуются дополнительные требования для использования этого модуля, см. Требования для получения подробной информации.

Чтобы использовать его в playbook, укажите: ngine_io.cloudstack.cs_domain.

Новое в ngine_io.cloudstack 0.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание, обновление и удаление доменов.

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
api_http_method строка	HTTP-метод, используемый для запроса к конечному API-адресу. Если не указан, учитывается переменная окружения `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (по умолчанию) `"post"`
api_key строка / обязательно	API-ключ API CloudStack. Если не указан, учитывается переменная окружения `CLOUDSTACK_KEY`.
api_secret строка / обязательно	Секретный ключ API CloudStack. Если не задан, учитывается переменная окружения `CLOUDSTACK_SECRET`.
api_timeout целое число	Тайм-аут HTTP в секундах. Если не указан, учитывается переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url строка / обязательно	URL API CloudStack, например https://cloud.example.com/client/api. Если не указан, учитывается переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert строка	Проверить файл сертификата центра сертификации. Если не указан, учитывается переменная окружения `CLOUDSTACK_VERIFY`.
clean_up логическое значение	Очистить все ресурсы домена, такие как дочерние домены и учетные записи. Учитывается при state=absent. Варианты: `false` ← (по умолчанию) `true`
network_domain строка	Домен сети для сетей в домене.
path строка / обязательно	Путь домена. Префикс `ROOT/` или `/ROOT/` в пути является необязательным.
poll_async логическое значение	Опрашивать асинхронные задания, пока задание не будет завершено. Варианты: `false` `true` ← (по умолчанию)
state строка	Состояние домена. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs логическое значение добавлено в ngine_io.cloudstack 2.4.0	Если `false`, SSL-сертификаты проверяться не будут. Если не указано, учитывается переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Это следует использовать только на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Create a domain
  ngine_io.cloudstack.cs_domain:
    path: ROOT/customers
    network_domain: customers.example.com

- name: Create another subdomain
  ngine_io.cloudstack.cs_domain:
    path: ROOT/customers/xy
    network_domain: xy.customers.example.com

- name: Remove a domain
  ngine_io.cloudstack.cs_domain:
    path: ROOT/customers/xy
    state: absent

Значения возврата

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

Ключ	Описание
id строка	UUID домена. Возвращается: успех Пример: `"87b1e0ce-4e01-11e4-bb66-0050569e64b8"`
name строка	Имя домена. Возвращается: успех Пример: `"customers"`
network_domain строка	Домен сети домена. Возвращается: успех Пример: `"example.local"`
parent_domain строка	Родительский домен домена. Возвращается: успех Пример: `"ROOT"`
path строка	Путь домена. Возвращается: успех Пример: `"/ROOT/customers"`

Авторы

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/cloudstack/cs_domain_module.html