Updated 07.2 Resource функция decort_kvmvm: управление виртуальными машинами на базе KVM. (markdown)

07.2-Resource-функция-decort_kvmvm:-управление-виртуальными-машинами-на-базе-KVM..md

@@ -16,3 +16,30 @@ _Resource_ функция **decort_kvmvm** принимает следующие
 | network | dict | Параметры сетевого подключения. Структура словаря:<br/> * (string) `net_type` - тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.<br/>* (int) `net_id` - идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"` и ViNS в случае `net_type = "VINS"`<br/>* (string) `ip_address` - IP адрес, выделенный данному подключению.<br/>* (string) `mac` - MAC адрес, назначенный соответствующему сетевому интерфейсу виртуальной машины.<br/>Если нужно сконфигурировать несколько сетевых подключений, данный блок можно задавать многократно - по одному на каждое подключение. |
 | ram | int | Объём оперативной памяти в МБ.<br/>Данный параметр является обязательным и не может быть нулевым. |
 | rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина.<br/>Этот параметр является обязательным и не может быть нулевым. |
+
+## Возвращаемые значения
+В случае успешного выполнения _resource_ функция **decort_kvmvm** возвращает в указанную при вызове переменную следующие значения:
+
+| Параметр | Тип | Описание |
+| --- | --- | --- |
+| account_id | int | Уникальный идентификатор подписчика-владельца ("account") данной виртуальной машины. |
+| account_name | string | Имя подписчика, которому принадлежит данная виртуальная машина. |
+| arch | string | Аппаратная архитектура данной виртуальной машины. |
+| boot_disk_id | int | Идентификатор загрузочного диска виртуальной машины. |
+| boot_disk_size | int | Размер загрузочного диска в ГБ. |
+| compute_id | int | Идентификатор экземпляра _compute_, соответствующего данной виртуальной машине. |
+| cpu | int | Количество виртуальных CPU, выделенных данному серверу. |
+| description | string | Текстовое описание виртуальной машины. |
+| extra_disks | list of ints | Список идентификаторов дополнительных дисков, которые подключены к данной виртуальной машине помимо загрузочного диска. Если такие диски отсутствуют, то список будет пустым. |
+| id | int | Уникальный идентификатор этой виртуальной машины в облачной платформе. Всегда совпадает с `compute_id`. |
+| image_id | int | Идентификатор образа ОС, на базе которого создан загрузочный диск этой виртуальной машины. |
+| image_name | string | Имя образа ОС, на базе которого создан загрузочный диск этой виртуальной машины. |
+| name | string | Имя виртуального сервера.<br>Возвращаемое значение `name` совпадает со значением соответствующего аргумента, переданного при вызове функции.  |
+| network | list of dicts | Характеристики сетевых сегментов, к которым подключен данный сервер. Формат структуры:<br/>* (string) `net_type` - тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.<br/>* (int) `net_id` - идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"` и ViNS в случае `net_type = "VINS"`<br/>* (string) `ip_address` - IP адрес, выделенный данному подключению.<br/>* (string) `mac` - MAC адрес, назначенный соответствующему сетевому интерфейсу виртуальной машины. |
+| os_users | list of dicts | Имена и пароли пользователей гостевой ОС, установленные платформой при создании виртуального сервера. Формат структуры:<br/>* (string) `login` - учётная запись в гостевой ОС.<br/>* (string) `password` - пароль к этой учётной записи. |
+| ram | int | Объём оперативной памяти в МБ, выделенной этой виртуальной машине. |
+| rg_id | int| Идентификатор ресурсной группы, к которой принадлежит виртуальная машина. |
+| rg_name | string | Имя ресурсной группы, к которой принадлежит виртуальная машина. |
+
+## Пример использования
+В нижеприведённом примере ... <TO BE ADDED>