inecs
cbd0adca91
Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
**Language / Язык:** [English](../api-surface.md) | [Русский](api-surface.md)
|
|
|
|
# Поверхность API
|
|
|
|
Точки входа:
|
|
|
|
| Путь | Роль |
|
|
|---|---|
|
|
| `/ovirt-engine/api` | Корень Engine REST (v4 по умолчанию на series 4.x) |
|
|
| `/ovirt-engine/api/v3` … `/v4` | Явный major API |
|
|
| `/ovirt-engine/sso/oauth/*` | SSO OAuth2 |
|
|
| `/health/live`, `/health/ready` | Liveness / readiness |
|
|
| `/` (порт UI) | Web-консоль |
|
|
|
|
## Модель маршрутизации
|
|
|
|
1. Контрактные маршруты активного pack `contracts/ovirt/<series>` регистрируются
|
|
как отдельные OpenAPI-операции.
|
|
2. Специализированные semantic handlers сохраняют мутации инвентаря (ВМ, диски,
|
|
хосты, сети, storage domains, jobs, …).
|
|
3. Catch-all роутер Engine остаётся скрытым fallback для остальных коллекций
|
|
через schema engine.
|
|
|
|
Packs: [`contracts/ovirt/`](../../contracts/README.ru.md). Таблица покрытия:
|
|
[api_coverage.md](api_coverage.md). Домены: [domains/](domains/README.md).
|
|
|
|
## Представления
|
|
|
|
Тела запросов/ответов — JSON или XML в зависимости от `Accept` /
|
|
`Content-Type`. Для современных клиентов предпочитайте
|
|
`Accept: application/json`.
|