diff --git a/07.2-Resource-функция-decort_kvmvm:-управление-виртуальными-машинами-на-базе-KVM..md b/07.2-Resource-функция-decort_kvmvm:-управление-виртуальными-машинами-на-базе-KVM..md index dbe50fa..2e6fd7a 100644 --- a/07.2-Resource-функция-decort_kvmvm:-управление-виртуальными-машинами-на-базе-KVM..md +++ b/07.2-Resource-функция-decort_kvmvm:-управление-виртуальными-машинами-на-базе-KVM..md @@ -15,4 +15,31 @@ _Resource_ функция **decort_kvmvm** принимает следующие | name | int | Имя виртуальной машины. Обратите внимание, что имя должно быть уникальным в рамках ресурсной группы.
Этот параметр является обязательным и не может быть пустой строкой. | | network | dict | Параметры сетевого подключения. Структура словаря:
* (string) `net_type` - тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.
* (int) `net_id` - идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"` и ViNS в случае `net_type = "VINS"`
* (string) `ip_address` - IP адрес, выделенный данному подключению.
* (string) `mac` - MAC адрес, назначенный соответствующему сетевому интерфейсу виртуальной машины.
Если нужно сконфигурировать несколько сетевых подключений, данный блок можно задавать многократно - по одному на каждое подключение. | | ram | int | Объём оперативной памяти в МБ.
Данный параметр является обязательным и не может быть нулевым. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина.
Этот параметр является обязательным и не может быть нулевым. | \ No newline at end of file +| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина.
Этот параметр является обязательным и не может быть нулевым. | + +## Возвращаемые значения +В случае успешного выполнения _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 | Имя виртуального сервера.
Возвращаемое значение `name` совпадает со значением соответствующего аргумента, переданного при вызове функции. | +| network | list of dicts | Характеристики сетевых сегментов, к которым подключен данный сервер. Формат структуры:
* (string) `net_type` - тип сети, соответствующей данному подключению. "EXTNET" в случае прямого подключения во внешнюю сеть, "VINS" в случае подключения к Virtual Network Segment.
* (int) `net_id` - идентификатор соответствующего сетевого сегмента: внешней сети в случае `net_type = "EXTNET"` и ViNS в случае `net_type = "VINS"`
* (string) `ip_address` - IP адрес, выделенный данному подключению.
* (string) `mac` - MAC адрес, назначенный соответствующему сетевому интерфейсу виртуальной машины. | +| os_users | list of dicts | Имена и пароли пользователей гостевой ОС, установленные платформой при создании виртуального сервера. Формат структуры:
* (string) `login` - учётная запись в гостевой ОС.
* (string) `password` - пароль к этой учётной записи. | +| ram | int | Объём оперативной памяти в МБ, выделенной этой виртуальной машине. | +| rg_id | int| Идентификатор ресурсной группы, к которой принадлежит виртуальная машина. | +| rg_name | string | Имя ресурсной группы, к которой принадлежит виртуальная машина. | + +## Пример использования +В нижеприведённом примере ... \ No newline at end of file