VPS OS reinstall (asenkron, 202 Accepted)
POST/services/:id/rebuild
VPS'i secilen OS template'i ile yeniden kurar. Disk uzerindeki TUM veri
silinir. Asenkron job — Virtualizor rebuildvps islemi 5-30 dakika
surer; API hemen 202 Accepted doner ve bayi modulu sonra
GET /services/{id}/status ile takip eder.
GUVENLIK: Body'de confirm: true (strict bool) ZORUNLU. false
veya eksikse 400 confirmation_required doner ve Virtualizor'a HIC
cagri yapilmaz (client-side guard).
Idempotency-Key ZORUNLU.
Rate limit: services_changes_120rpm bucket.
vps_id null: 422 service_not_provisioned.
Request
Responses
- 202
- 400
- 401
- 403
- 422
- 429
- 502
Rebuild scheduled (asenkron job baslatildi)
Response Headers
Bu key icin tanimli dakika basi limit
Mevcut window'da kalan istek sayisi
Sonraki window basinin Unix epoch'u (UTC saniye)
Cache hit replay ise true.
Idempotency-Key eksik / confirm=false / body validasyon hatasi
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).
VPS provisionlanmamis VEYA secilen os_id bu VPS'in media grubunda izinli degil.
os_not_allowed (guvenlik): GET /os-templates listesi media-grup-filtreli olsa da rebuild action'i server-side dogrulanir — listede olmayan bir os_id (forge) gonderilirse Virtualizor'a HIC gidilmez, 422 doner.
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)
Virtualizor upstream hatasi