cs_staticnat — Управление статическими NAT на облаках Apache CloudStack.
Новая версия с 2.0.
- Описание
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Создание, обновление и удаление статических NAT.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| account |
нет | Аккаунт, к которому относится статический NAT. |
||
| 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. |
||
| domain |
нет | Домен, к которому относится статический NAT. |
||
| ip_address |
да | Общедоступный IP-адрес, назначенный статическому NAT. |
||
| network (добавлено в 2.2)
|
нет | Сеть, к которой относится IP-адрес. |
||
| poll_async |
нет | True | Ожидать завершения асинхронных задач. |
|
| project |
нет | Имя проекта, к которому относится статический NAT. |
||
| state |
нет | present |
|
Состояние статического NAT. |
| vm |
нет | Имя виртуальной машины, для которой создаётся статический NAT.
Требуется, если state=present. |
||
| vm_guest_ip |
нет | Вторичный IP-адрес гостевой сетевой карты VM для статического NAT. |
||
| vpc (добавлено в 2.3)
|
нет | VPC, к которому относится сеть. |
||
| zone |
нет | Имя зоны, в которой находится виртуальная машина.
Если не указано, используется зона по умолчанию. |
Примеры
# create a static NAT: 1.2.3.4 -> web01
- local_action:
module: cs_staticnat
ip_address: 1.2.3.4
vm: web01
# remove a static NAT
- local_action:
module: cs_staticnat
ip_address: 1.2.3.4
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| account | Аккаунт, к которому относится статический NAT. |
успех | строка | примерный аккаунт |
| domain | Домен, к которому относится статический NAT. |
успех | строка | примерный домен |
| id | UUID ip_address. |
успех | строка | a6f7a5fc-43f8-11e5-a151-feff819cdc9f |
| ip_address | Общедоступный IP-адрес. |
успех | строка | 1.2.3.4 |
| project | Имя проекта, к которому относится статический NAT. |
успех | строка | Производство |
| vm_display_name | Имя отображения виртуальной машины. |
успех | строка | web-01 |
| vm_guest_ip | IP виртуальной машины. |
успех | строка | 10.101.65.152 |
| vm_name | Имя виртуальной машины. |
успех | строка | web-01 |
| zone | Имя зоны, к которой относится статический NAT. |
успех | строка | 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_staticnat_module.html
