ngine_io.cloudstack.cs_pod – Управляет подсетями в облаках на базе Apache CloudStack.
Примечание
Этот плагин входит в коллекцию ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_pod.
Введено в версии 0.1.0: модуля 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 строка / обязательно | Секретный ключ 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. | |
| end_ip строка | Конечный IP-адрес подсети. | |
| gateway строка | Шлюз подсети. Обязательно для state=present
| |
| id строка | uuid существующей подсети. | |
| name строка / обязательно | Имя подсети. | |
| netmask строка | Маска подсети. Обязательно для state=present
| |
| start_ip строка | Начальный IP-адрес подсети. Обязательно для state=present
| |
| state строка |
| Состояние подсети. |
| zone строка / обязательно | Имя зоны, к которой принадлежит подсеть. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Ensure a pod is present
ngine_io.cloudstack.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
- name: Ensure a pod is disabled
ngine_io.cloudstack.cs_pod:
name: pod1
zone: ch-zrh-ix-01
state: disabled
- name: Ensure a pod is enabled
ngine_io.cloudstack.cs_pod:
name: pod1
zone: ch-zrh-ix-01
state: enabled
- name: Ensure a pod is absent
ngine_io.cloudstack.cs_pod:
name: pod1
zone: ch-zrh-ix-01
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, ниже перечислены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| allocation_state строка | success | Состояние подсети. Пример: Enabled |
| end_ip строка | success | Конечный IP-адрес подсети. Пример: 10.100.1.254 |
| gateway строка | success | Шлюз подсети. Пример: 10.100.1.1 |
| id строка | success | UUID подсети. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| name строка | success | Имя подсети. Пример: pod01 |
| netmask строка | success | Маска подсети. Пример: 255.255.255.0 |
| start_ip строка | success | Начальный IP-адрес подсети. Пример: 10.100.1.101 |
| zone строка | success | Имя зоны, в которой находится подсеть. Пример: ch-gva-2 |
Авторы
- 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_pod_module.html