Bu VPS icin rebuild'e izinli OS sablonlari (servis-spesifik filtre)
GET/services/:id/os-templates
VPS rebuild islemi icin secim listesi. ENH-001 (live test 2026-05-19):
liste artik servis-spesifik — Virtualizor act=rebuild&vpsid=X form-load
cagrisi ile gelen ostemplates field'i parse edilir. Bu, Virtualizor'da
VPS'e atanmis medya group'una gore filtrelenmis listedir. Onceden global
liste (act=ostemplates, 255+ OS) doniyordu ve bayi yanlis OS secip
rebuild yapinca Virtualizor "The OS you submitted is invalid" hatasi
veriyordu. Artik sadece izinli OS'lar gosterilir.
NOT: Ilk siparis (POST /orders) bu endpoint'i KULLANMAZ. Provisioning
sirasinda WHMCS Virtualizor modulu kendi config options'tan OS atar. Bu
endpoint sadece rebuild flow'u icindir.
Cache: APCu, key os_templates:v2:vps:{vpsId} (per-VPS), TTL 300 saniye.
Farkli VPS'ler farkli medya grupta olabildigi icin global key COZUM DEGIL.
Ayni medya gruptaki 2 VPS bu cache'ten faydalanmaz — pratik etki sifir
(OS listesi ayda bir guncellenir).
Cache invalidation: Operator yeni OS image ekledikten sonra max 5dk icinde gorunur. Acil invalidate icin admin CLI hook (Faz 4) gelecek.
Rate limit: Default bucket (60 req/dk).
vps_id null durumu: 422 service_not_provisioned doner — provisioning
bekleyen servis icin rebuild zaten yapilamaz.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OS sablon listesi
Response Headers
Bu key icin tanimli dakika basi limit
Mevcut window'da kalan istek sayisi
Sonraki window basinin Unix epoch'u (UTC saniye)
Kimlik dogrulama basarisiz — eksik header, hatali credential, IP whitelist disi veya revoke edilmis key. Detay sizdirilmaz; tum durumlar tek mesaj.
Response Headers
RFC 7617 Basic Auth challenge
Yetki yetersiz — bayi baska bir bayinin service_id'sine erismeye calisti veya admin scope gerektiren endpoint icin yetersiz scope. Mesaj generic tutulur (ServiceOwnershipMiddleware sizinti onler).
Kaynak bulunamadi (veya bayiye gizli). Bayiler arasi envanter/kaynak sizintisini onlemek icin "yok" ve "erisilemez" tek yanitla doner.
VPS henuz provisioning bekleniyor (vps_id null). Rebuild yapilamayacagi icin OS listesi de cekilemez. Bayi modulu provisioning tamamlanana kadar "OS listesi bekleniyor" mesaji gostermeli.
Dakika basina limit asildi
Response Headers
429 sonrasi tekrar denemeden once beklenmesi gereken saniye (RFC 7231 §7.1.3)
Bu key icin tanimli dakika basi limit
Sonraki window basinin Unix epoch'u (UTC saniye)