diff --git a/07.5-Resource-функция-decort_pfw:-управление-правилами-трансляции-сетевых-портов..md b/07.5-Resource-функция-decort_pfw:-управление-правилами-трансляции-сетевых-портов..md new file mode 100644 index 0000000..b7a25ba --- /dev/null +++ b/07.5-Resource-функция-decort_pfw:-управление-правилами-трансляции-сетевых-портов..md @@ -0,0 +1,27 @@ +_Resource_ функция **decort_pfw** служит для управления правилами трансляции сетевых портов на виртуальных машинах, подключённых в виртуальный сетевой сегмент (ViNS). + +Можно задавать правила "порт в порт" (напр., порт 10443 на внешнем интерфейсе ViNS транслируется в порт 443 виртуального сервера, подключённого во внутренний сегмент ViNS) или "диапазон в диапазон" (напр., порты с 8080 по 8090 на внешнем интерфейсе ViNS транслируется в порты с 80 по 90 виртуального сервера соответственно). + +## Аргументы +_Resource_ функция **decort_pfw** принимает следующие аргументы: + +| Аргумент | Тип | Описание | +| --- | --- | --- | +| compute_id | int | Уникальный идентификатор виртуального сервера (экземпляра _compute_), к которому относятся данные правила трансляции сетевых портов.
Данный параметр является обязательным и не может быть нулевым. | +| vins_id | int | Уникальный идентификатор виртуального сетевого сегмента (ViNS), в рамках которого настраиваются данные правила трансляции сетевых портов.
Данный параметр является обязательным и не может быть нулевым.
Также обратите внимание, что указанный ViNS должен иметь активное подключение во внешнюю сеть. | +| network | dict | Правило трансляции сетевых портов. Структура словаря:
* (int) `pub_port_start` - .
* (int) `pub_port_end` - .
* (int) `local_port` - .
* (string) `proto` - .
Если требуется сконфигурировать несколько правил, данный блок можно задавать многократно - по одному на каждое правило. | + + +## Возвращаемые значения +В случае успешного выполнения _resource_ функция **decort_pfw** возвращает в указанную при вызове переменную следующие значения: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| compute_id | int | Идентификатор виртуального сервера (экземпляра _compute_), для которого настроены указанные правила. | +| vins_id | int | Идентификатор виртуального сетевого сегмента (ViNS), в рамках которого существуют указанные правила. | +| id | string | Уникальный идентификатор данного набора правил. Формируется как `compute_id`:`vins_id`. | +| rule | list of dicts | Список правил трансляции сетевых портов. Структура словаря:
* (int) `pub_port_start` - .
* (int) `pub_port_end` - .
* (int) `local_port` - .
* (string) `proto` - .
* (int) `rule_id` - внутренний идентификатор правила в данном списке. | + + +## Пример использования +В нижеприведённом примере ... \ No newline at end of file