Files

T

inecs f8d3cbdd59 Initial commit: VMware vSphere API simulator scaffold.

Add the FastAPI app, PostgreSQL migrations, Docker/Helm packaging, API
contracts, docs, client examples, and the unit/integration/compatibility
test suite for local client and tooling labs without a real vCenter.

2026-07-18 04:42:11 +03:00

3.5 KiB

Raw Permalink Blame History

Language / Язык: English | Русский

Виртуальные машины

Полный REST lifecycle для объектов VirtualMachine: app/vsphere/rest/router.py, vm_ext.py, app/vsphere/domain/vm_ops.py.

Эндпоинты

Метод	Путь	Заметки
GET	`/api/vcenter/vm`	Список с фильтрами `names`/`power_states`/`hosts`/`folders`/`datacenters`/`clusters`/`resource_pools`/`limit`/`cursor`
GET/DELETE	`/api/vcenter/vm/{vm}`	Get / delete (должна быть powered off)
POST	`/api/vcenter/vm`	Create — `placement.{folder,host,datastore,resource_pool}`, `cpu.count`, `memory.size_MiB`, `disks`, `nics`
GET/POST	`/api/vcenter/vm/{vm}/power`	Get power state / `?action=start\|stop\|suspend\|reset` — возвращает `{ "task": "task-…" }`
GET	`/api/vcenter/vm/{vm}/hardware`	Сводка
GET/PATCH	`/api/vcenter/vm/{vm}/hardware/cpu` \| `/memory`	Смена CPU count / memory (privilege-gated)
GET/POST	`/api/vcenter/vm/{vm}/hardware/disk` \| `/ethernet`	Добавить disk / NIC
GET	`/api/vcenter/vm/{vm}/hardware/boot`	Boot type/order
GET/POST/DELETE	`/api/vcenter/vm/{vm}/snapshots[/{snapshot}]`	Create, revert (`?action=revert`), delete
POST	`/api/vcenter/vm/{vm}/clone` \| `/relocate`	Возвращают задачу
GET/POST	`/api/vcenter/vm/{vm}/tools`	Статус guest tools / upgrade
GET	`/api/vcenter/vm/{vm}/guest/identity` \| `/networking`	Имя guest OS, синтетический IP
GET/POST	`/api/vcenter/vm/{vm}/guest/power`	Guest-level power ops
POST	`/api/vcenter/vm/{vm}/guest/customization`	Спека customization в стиле sysprep/cloud-init
POST	`/api/vcenter/vm/{vm}/console/tickets`	Console-тикет (стиль VNC/WebMKS)
GET/PUT/DELETE	`/api/vcenter/vm/{vm}/guest/filesystem`	Lab virtual guest filesystem (потоки write-a-file Ansible/Terraform)
GET	`/api/vcenter/vm/{vm}/guest/filesystem/files` \| `/guest/local-filesystem`	Listing

Основные моменты

У каждой строки VM реалистичная форма устройств: nics, disks, cdroms, floppies, serials, scsi_adapters, boot/boot_devices, identity (instance_uuid, bios_uuid) и синтетическая карта guest_ip / guest_filesystems — те же поля питают и REST hardware-эндпоинты, и SOAP VirtualMachineConfigInfo.
Create требует VirtualMachine.Inventory.Create; delete требует VirtualMachine.Inventory.Delete и VM должна быть POWERED_OFF.
Power/clone/snapshot/relocate/customize создают устойчивую CIS-задачу (см. Tasks), а не мутируют синхронно в теле ответа.
Console tickets из /api/vcenter/vm/{vm}/console/tickets живут в vsphere_console_tickets (миграция 013).
MOID следуют конвенции vm-{100+n}, засеваемой app/vsphere/profiles.py.

Семантика datastore/disk-file — Storage; эквивалентные операции CreateVM_Task/PowerOnVM_Task/… для pyvmomi, govmomi, Terraform и Pulumi — SOAP / VIM.

3.5 KiB Raw Permalink Blame History Unescape Escape

Виртуальные машины

Эндпоинты

Основные моменты

3.5 KiB

Raw Permalink Blame History