ngine_io.cloudstack.cs_staticnat – Управляет статическими NAT на облаках, основанных на Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в книге задач укажите: ngine_io.cloudstack.cs_staticnat.
Новое в версии 0.1.0: из ngine_io.cloudstack
Обзор
- Создание, обновление и удаление статических NAT.
Требования
Ниже приведены требования, которые необходимы на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Аккаунт, к которому относится статический NAT. | |
| 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. | |
| domain строка | Домен, к которому относится статический NAT. | |
| ip_address строка / обязательно | Общедоступный IP-адрес, которому назначен статический NAT. | |
| network строка | Сеть, к которой относится IP-адрес. | |
| poll_async булево |
| Ожидать завершения асинхронных задач. |
| project строка | Имя проекта, к которому относится статический NAT. | |
| state строка |
| Состояние статического NAT. |
| vm строка | Имя виртуальной машины, для которой создается статический NAT. Обязательно, если state=present. | |
| vm_guest_ip строка | Вторичный IP-адрес гостевой сети виртуальной машины для статического NAT. | |
| vpc строка | VPC, к которой относится сеть. | |
| zone строка / обязательно | Имя зоны, в которой находится виртуальная машина. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в руководстве по CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create a static NAT for IP 1.2.3.4 to web01
ngine_io.cloudstack.cs_staticnat:
ip_address: 1.2.3.4
zone: zone01
vm: web01
- name: Remove a static NAT
ngine_io.cloudstack.cs_staticnat:
ip_address: 1.2.3.4
zone: zone01
state: absent
Возвращаемые значения
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| account строка | success | Аккаунт, к которому относится статический NAT. Пример: пример аккаунта |
| domain строка | success | Домен, к которому относится статический NAT. Пример: пример домена |
| id строка | success | UUID ip_address. Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| ip_address строка | success | Общедоступный IP-адрес. Пример: 1.2.3.4 |
| project строка | success | Имя проекта, к которому относится статический NAT. Пример: Производство |
| vm_display_name строка | success | Имя отображения виртуальной машины. Пример: web-01 |
| vm_guest_ip строка | success | IP виртуальной машины. Пример: 10.101.65.152 |
| vm_name строка | success | Имя виртуальной машины. Пример: web-01 |
| zone строка | success | Имя зоны, к которой относится статический NAT. Пример: 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_staticnat_module.html
