VPS power islemi (start/stop/restart/poweroff)
POST/services/:id/power/:action
Bayi VPS'inin guc durumunu degistirir. action URL parametresinde
start, stop, restart veya poweroff kabul edilir; baska deger
Slim route regex'inde 404 doner.
Idempotency-Key ZORUNLU. Header eksikse 400 missing_idempotency_key
doner. Power aksiyonlari double-click korumasi icin idempotent
islenmelidir; bayi modulu HER TIKLAMADA YENI bir UUID v4 uretmeli.
Ayni key + ayni body 24 saat boyunca cached response replay eder
(X-Idempotent-Replay: true header'i ile).
Rate limit: services_changes_120rpm bucket (120 req/dk).
vps_id null: Servis henuz Virtualizor'a baglanmamis (tblcustomfieldsvalues
bos veya tanimsiz) ise 422 service_not_provisioned doner ve Virtualizor'a
HIC cagri yapilmaz.
Request
Responses
- 200
- 400
- 401
- 403
- 422
- 429
- 502
Power aksiyonu islendi
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. Yeni isleme header gonderilmez.
Idempotency-Key eksik veya gecersiz power action
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 henuz provisionlanmamis (vps_id custom field bos)
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