cs_affinitygroup - Управляет группами родства в облаках на основе Apache CloudStack.
Новая версия с 2.0.
- Обзор
- Требования (на хосте, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Создание и удаление групп родства.
Требования (на хосте, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| account | нет | Аккаунт, к которому относится группа родства. | ||
| affinty_type | нет | Тип группы родства. Если не указан, используется первый найденный тип группы родства. | ||
| api_http_method | нет | get |
| Используемый HTTP-метод. |
| api_key | нет | API-ключ CloudStack API. | ||
| api_region | нет | cloudstack | Имя раздела ini в файле cloustack.ini. | |
| api_secret | нет | Секретный ключ CloudStack API. | ||
| api_timeout | нет | 10 | Таймаут HTTP. | |
| api_url | нет | URL CloudStack API, например, https://cloud.example.com/client/api. | ||
| description | нет | Описание группы родства. | ||
| domain | нет | Домен, к которому относится группа родства. | ||
| name | да | Имя группы родства. | ||
| poll_async | нет | True | Опрашивать асинхронные задачи до завершения. | |
| project | нет | Имя проекта, к которому относится группа родства. | ||
| state | нет | present |
| Состояние группы родства. |
Примеры
# Create a affinity group
- local_action:
module: cs_affinitygroup
name: haproxy
affinty_type: host anti-affinity
# Remove a affinity group
- local_action:
module: cs_affinitygroup
name: haproxy
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| account | Аккаунт, к которому относится группа родства. | успех | строка | примерный аккаунт |
| affinity_type | Тип группы родства. | успех | строка | антиродство хостов |
| description | Описание группы родства. | успех | строка | группа родства приложений |
| domain | Домен, к которому относится группа родства. | успех | строка | примерный домен |
| id | UUID группы родства. | успех | строка | 87b1e0ce-4e01-11e4-bb66-0050569e64b8 |
| name | Имя группы родства. | успех | строка | app |
| project | Имя проекта, к которому относится группа родства. | успех | строка | Производство |
Примечания
Примечание
- 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 можно найти на http://docs.ansible.com/ansible/guide_cloudstack.html
- Этот модуль поддерживает режим проверки.
Статус
Этот модуль отмечен как stableinterface, что означает, что разработчики этого модуля гарантируют отсутствие несовместимых изменений интерфейса.
Для помощи в разработке модулей, если вам это интересно, пожалуйста, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/cs_affinitygroup_module.html
