Created 07.5 Resource функция decort_pfw: управление правилами трансляции сетевых портов. (markdown)

svs1370
2021-10-07 23:35:46 +03:00
parent 6ac18609a2
commit 3979202ec7

@@ -0,0 +1,27 @@
_Resource_ функция **decort_pfw** служит для управления правилами трансляции сетевых портов на виртуальных машинах, подключённых в виртуальный сетевой сегмент (ViNS).
Можно задавать правила "порт в порт" (напр., порт 10443 на внешнем интерфейсе ViNS транслируется в порт 443 виртуального сервера, подключённого во внутренний сегмент ViNS) или "диапазон в диапазон" (напр., порты с 8080 по 8090 на внешнем интерфейсе ViNS транслируется в порты с 80 по 90 виртуального сервера соответственно).
## Аргументы
_Resource_ функция **decort_pfw** принимает следующие аргументы:
| Аргумент | Тип | Описание |
| --- | --- | --- |
| compute_id | int | Уникальный идентификатор виртуального сервера (экземпляра _compute_), к которому относятся данные правила трансляции сетевых портов.<br/>Данный параметр является обязательным и не может быть нулевым. |
| vins_id | int | Уникальный идентификатор виртуального сетевого сегмента (ViNS), в рамках которого настраиваются данные правила трансляции сетевых портов.<br/>Данный параметр является обязательным и не может быть нулевым.<br/>Также обратите внимание, что указанный ViNS должен иметь активное подключение во внешнюю сеть. |
| network | dict | Правило трансляции сетевых портов. Структура словаря:<br/> * (int) `pub_port_start` - .<br/>* (int) `pub_port_end` - .<br/>* (int) `local_port` - .<br/>* (string) `proto` - .<br/>Если требуется сконфигурировать несколько правил, данный блок можно задавать многократно - по одному на каждое правило. |
## Возвращаемые значения
В случае успешного выполнения _resource_ функция **decort_pfw** возвращает в указанную при вызове переменную следующие значения:
| Параметр | Тип | Описание |
| --- | --- | --- |
| compute_id | int | Идентификатор виртуального сервера (экземпляра _compute_), для которого настроены указанные правила. |
| vins_id | int | Идентификатор виртуального сетевого сегмента (ViNS), в рамках которого существуют указанные правила. |
| id | string | Уникальный идентификатор данного набора правил. Формируется как `compute_id`:`vins_id`. |
| rule | list of dicts | Список правил трансляции сетевых портов. Структура словаря:<br/> * (int) `pub_port_start` - .<br/>* (int) `pub_port_end` - .<br/>* (int) `local_port` - .<br/>* (string) `proto` - .<br/>* (int) `rule_id` - внутренний идентификатор правила в данном списке. |
## Пример использования
В нижеприведённом примере ... <TO BE ADDED>