VPS anlik metrikleri (CPU/RAM/disk/net)

GET 
/services/:id/status

Virtualizor admin act=vs&vs_status=<id> ile CANLI durum ve metrik (dugume o an sorar). Bu cagri hata verir ya da beklenen yapida donmezse periyodik act=vps_stats kullanilir. CPU yuzdesi enduser act=cpu ile gelir.

Rate limit: services_status kovasi — 300 req/dk, bayi basina ayri. Diger kovalardan IZOLE.

management=basic: 409 management_unavailable (panel API'de yok).

Hata davranisi: Virtualizor down ise 502 doner (graceful degradation YOK — real-time metric icin partial yanit anlamsiz).

Cache: VPS basina 15 sn (sunucuda STATUS_CACHE_TTL_SECONDS). Ayni VPS'e bu surede gelen ikinci istek Virtualizor'a gitmez. Power, rebuild, suspend, unsuspend ve terminate islemleri onbellegi siler ve sonraki 180 sn onbellegi tamamen kapatir; gecis sirasindaki ara durum (or. stop sonrasi hala calisiyor) onbellekte kalip paneli geciktirmez.

Request

Responses

200

Anlik metrikler

Response Headers

X-RateLimit-Limit

services_status kovasi icin anahtarin etkin limiti

X-RateLimit-Remaining

Mevcut window'da kalan istek sayisi

X-RateLimit-Reset

Sonraki window basinin Unix epoch'u (UTC saniye)

401

Kimlik dogrulama basarisiz — eksik header, hatali credential, IP whitelist disi veya revoke edilmis key. Detay sizdirilmaz; tum durumlar tek mesaj.

Response Headers

WWW-Authenticate

RFC 7617 Basic Auth challenge

403

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).

404

Hizmet bulunamadi VEYA Virtualizor mapping'i yok

429

Dakika basina limit asildi

Response Headers

Retry-After

429 sonrasi tekrar denemeden once beklenmesi gereken saniye (RFC 7231 §7.1.3)

X-RateLimit-Limit

Bu key icin tanimli dakika basi limit

X-RateLimit-Remaining
X-RateLimit-Reset

Sonraki window basinin Unix epoch'u (UTC saniye)

502

Virtualizor master upstream hatasi (timeout / 5xx)