ngine_io.cloudstack.cs_region – Управляет регионами на облаках на базе Apache CloudStack.
Примечание
Этот плагин входит в коллекцию ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в книге задач укажите: ngine_io.cloudstack.cs_region.
В версии 0.1.0: of ngine_io.cloudstack
Обзор
- Добавление, обновление и удаление регионов.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке входа. Если не задано, рассматривается переменная среды CLOUDSTACK_METHOD. |
| api_key строка / обязательно | Ключ API CloudStack API. Если не задано, рассматривается переменная среды CLOUDSTACK_KEY. | |
| api_secret строка / обязательно | Секретный ключ API CloudStack API. Если не задано, рассматривается переменная среды CLOUDSTACK_SECRET. | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не задано, рассматривается переменная среды CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательно | URL CloudStack API, например, https://cloud.example.com/client/api. Если не задано, рассматривается переменная среды CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверка сертификата авторитета CA. Если не задано, рассматривается переменная среды CLOUDSTACK_VERIFY. | |
| endpoint строка | URL точки входа региона. Требуется, если state=present
| |
| id целое число / обязательно | ID региона. Должно быть числом (int). | |
| name строка | Имя региона. Требуется, если state=present
| |
| state строка |
| Состояние региона. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: create a region
ngine_io.cloudstack.cs_region:
id: 2
name: geneva
endpoint: https://cloud.gva.example.com
- name: remove a region with ID 2
ngine_io.cloudstack.cs_region:
id: 2
state: absent
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| endpoint строка | success | Точка входа региона. Пример: http://cloud.example.com |
| gslb_service_enabled логическое | success | Включена или нет служба GSLB. Пример: True |
| id целое число | success | ID региона. Пример: 1 |
| name строка | success | Имя региона. Пример: local |
| portable_ip_service_enabled логическое | success | Включена или нет служба портативного IP-адреса. Пример: True |
Авторы
- René Moser (@resmo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_region_module.html
