Updated 07. Модуль decort_pfw (markdown)

07.-Модуль-decort_pfw.md

@@ -25,11 +25,15 @@
 
 
 ## 07.3 Возвращаемые значения модуля _decort_pfw_
-Модуль _decort_pfw_ возвращает информацию о XXX в виде словаря `facts` со следующими ключами:
+Модуль _decort_pfw_ возвращает информацию о правилах трансляции сетевых портов и сопутсвтующую информацию в виде словаря `facts` со следующими ключами:
 
 | Ключ | Тип данных | Описание |
 | --- | --- | --- |
-| | | |
+| compute_id | int | Идентификатор _compute_, для которого настроены перечисленные правила трансляции. |
+| public_ip | string | IP адрес на внешнем сетевом интерфейсе ViNS. Перечисленные ниже правила трансляции настраиваются на этом интерфейсе. |
+| rules | list of dict | Список словарей, описывающих правила трансляции сетевых портов. Структура словаря:<br/> (int) `id` - идентификатор правила.<br/> (int) `publicPortStart` - номер внешнего порта (на публичном интерфейсе ViNS, см. `public_ip`) для начала диапазона.<br/> (int) `publicPortEnd` - номер внешнего порта для конца диапазона. Если требуется правило "один к одному", то `publicPortEnd` можно не указывать или указать равным `publicPortStart`.<br/> (int) `localPort` - номер порта на интерфейсе экземпляра _Compute_, заданного параметром `compute_id`. Если задаётся правило "диапазон в диапазон", то `localPort` указывает начало диапазона для трансляции. В случае правила "один к одному" `publicPortStart` просто транслируется в `localPort`.<br/> (string) `protocol` - протокол, `tcp` или `udp`.|
+| state | string | Статус правил. Для корректно отработавшего модуля это поле должно иметь значение "PRESENT". |
+| vins_id | int | Идентификатор виртуального сетевого сегмента (ViNS), в котором настроены перечисленные выше правила трансляции. |
 
 
 ## 07.4 Пример использования модуля _decort_pfw_
@@ -57,5 +61,12 @@
         local_port: 30080
         proto: tcp
     state: present
+    register: my_pfw
     delegate_to: localhost
 ```
+
+В данном примере результат выполнения модуля _decort_pfw_ записывается в переменную `my_pfw`. Для доступа к списку правил используйте следующую конструкцию:
+
+```
+"{{ my_pfw.facts.rules }}"
+```