API-Dokumentation

VPS-Traffic

Gibt die Bandbreitennutzung des aktuellen Monats und ein tägliches Traffic-Protokoll eines VPS zurück.

Anfrage

GET /api/v1/vps/{id}/traffic

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "usage": {
      "month": "2026-03",
      "usage": {
        "total": 52428800,
        "in": 31457280,
        "out": 20971520
      },
      "limit": {
        "monthly": 10737418240,
        "additional": null,
        "remaining": 10684989440,
        "vmStatus": "normal"
      }
    },
    "log": {
      "month": "2026-03",
      "log": [
        {
          "date": "2026-03-25",
          "in": 10485760,
          "out": 7340032
        },
        {
          "date": "2026-03-26",
          "in": 12582912,
          "out": 8388608
        },
        {
          "date": "2026-03-27",
          "in": 8388608,
          "out": 5242880
        }
      ]
    }
  }
}

Nutzungsfelder

Feld Typ Beschreibung
month string Monat im Format YYYY-MM
usage.total number Gesamte übertragene Bytes in diesem Monat
usage.in number Eingehende Bytes
usage.out number Ausgehende Bytes

Limitfelder

Feld Typ Beschreibung
monthly number Monatliches Bandbreitenlimit in Bytes
additional number | null Zusätzlich erworbene Bandbreite in Bytes
remaining number Verbleibende Bandbreite in Bytes
vmStatus string normal oder throttled

Traffic-Protokolleintrag

Feld Typ Beschreibung
date string Datum im Format YYYY-MM-DD
in number Eingehende Bytes pro Tag
out number Ausgehende Bytes pro Tag

Beispiel

curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/traffic" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Daten sind auch über das MCP-Tool get_vm_traffic verfügbar.