cs_affinitygroup - Управляет группами родства на облаках Apache CloudStack.
Новое в версии 2.0.
Обзор
- Создание и удаление групп родства.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.6.10
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account | Значение по умолчанию: None | Аккаунт, к которому относится группа родства. |
| affinity_type | Значение по умолчанию: None | Тип группы родства. Если не указано, используется первый найденный тип группы родства. псевдонимы: affinty_type |
| api_http_method |
| HTTP-метод, используемый для запроса к API-точке входа. Если не указано, рассматривается переменная среды CLOUDSTACK_METHOD. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию get, если не указано. |
| api_key | API-ключ API CloudStack. Если не указано, рассматривается переменная среды CLOUDSTACK_KEY. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. | |
| api_region | Значение по умолчанию: cloudstack | Имя раздела ini в файле cloustack.ini.Если не указано, рассматривается переменная среды CLOUDSTACK_REGION. |
| api_secret | Секретный ключ API CloudStack. Если не задано, рассматривается переменная среды CLOUDSTACK_SECRET. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. | |
| api_timeout | Таймаут HTTP в секундах. Если не указано, рассматривается переменная среды CLOUDSTACK_TIMEOUT. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию 10 секунд, если не указано. | |
| api_url | URL API CloudStack, например https://cloud.example.com/client/api. Если не указано, рассматривается переменная среды CLOUDSTACK_ENDPOINT. В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания. | |
| description | Значение по умолчанию: None | Описание группы родства. |
| domain | Значение по умолчанию: None | Домен, к которому относится группа родства. |
| name обязательно | Имя группы родства. | |
| poll_async | Значение по умолчанию: yes | Проверять асинхронные задачи, пока задача не будет завершена. |
| project | Значение по умолчанию: None | Имя проекта, к которому относится группа родства. |
| state |
| Состояние группы родства. |
Примечания
Примечание
- Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены параметрамиapi_url,api_key,api_secret. Конфигурация читается из нескольких источников в следующем порядке.CLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменные средыCLOUDSTACK_TIMEOUT. Переменная средыCLOUDSTACK_CONFIG, указывающая на файл.ini. Файлcloudstack.iniв текущей рабочей директории. Файл.cloudstack.iniв домашней директории пользователя. Допускается указание нескольких учетных данных и точек входа с использованием разделов ini в файлеcloudstack.ini. Используйте параметрapi_regionдля выбора имени раздела, по умолчанию используется разделcloudstack. Дополнительная информация доступна по адресу https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
# Create a affinity group
- local_action:
module: cs_affinitygroup
name: haproxy
affinity_type: host anti-affinity
# Remove a affinity group
- local_action:
module: cs_affinitygroup
name: haproxy
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| account строка | успешно | Аккаунт, к которому относится группа родства. Пример: example account |
| affinity_type строка | успешно | Тип группы родства. Пример: host anti-affinity |
| description строка | успешно | Описание группы родства. Пример: application affinity group |
| domain строка | успешно | Домен, к которому относится группа родства. Пример: example domain |
| id строка | успешно | UUID группы родства. Пример: 87b1e0ce-4e01-11e4-bb66-0050569e64b8 |
| name строка | успешно | Имя группы родства. Пример: app |
| project строка | успешно | Имя проекта, к которому относится группа родства. Пример: Production |
Статус
Этот модуль помечен как stableinterface, что означает, что поддерживающие этот модуль гарантируют, что не будут вноситься несовместимые изменения интерфейса.
Автор
- 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.5/modules/cs_affinitygroup_module.html