cs_pod — Управление подсетями в облаках на базе Apache CloudStack.
Новая версия с 2.1.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Создание, обновление, удаление подсетей.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| 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. |
||
| end_ip |
нет | Конечный IP-адрес для подсети. |
||
| gateway |
нет | Шлюз для подсети.
Требуется в state=present. |
||
| id |
нет | uuid существующей подсети. |
||
| name |
да | Имя подсети. |
||
| netmask |
нет | Маска подсети.
Требуется в state=present. |
||
| start_ip |
нет | Начальный IP-адрес подсети.
Требуется в state=present. |
||
| state |
нет | present |
|
Состояние подсети. |
| zone |
нет | Имя зоны, к которой принадлежит подсеть.
Если не задано, используется зона по умолчанию. |
Примеры
# Ensure a pod is present
- local_action:
module: cs_pod
name: pod1
zone: ch-zrh-ix-01
start_ip: 10.100.10.101
gateway: 10.100.10.1
netmask: 255.255.255.0
# Ensure a pod is disabled
- local_action:
module: cs_pod
name: pod1
zone: ch-zrh-ix-01
state: disabled
# Ensure a pod is enabled
- local_action:
module: cs_pod
name: pod1
zone: ch-zrh-ix-01
state: enabled
# Ensure a pod is absent
- local_action:
module: cs_pod
name: pod1
zone: ch-zrh-ix-01
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| allocation_state | Состояние подсети. |
успех | строка | Enabled |
| end_ip | Конечный IP-адрес подсети. |
успех | строка | 10.100.1.254 |
| gateway | Шлюз подсети. |
успех | строка | 10.100.1.1 |
| id | UUID подсети. |
успех | строка | 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| name | Имя подсети. |
успех | строка | pod01 |
| netmask | Маска подсети. |
успех | строка | 255.255.255.0 |
| start_ip | Начальный IP-адрес подсети. |
успех | строка | 10.100.1.101 |
| zone | Имя зоны, в которой находится подсеть. |
успех | строка | ch-gva-2 |
Примечания
Примечание
- 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_pod_module.html