Metrikverlauf lesen
GET
/api/v1/
operationIdgetServerMetricsHistory
- Erforderliche Stufe
- Nur Lesen
- Kontingent
- Lesen, 3.600 Aufrufe pro Stunde
Vom Hypervisor aggregierte Zeitreihen. Die Auflösung ergibt sich aus dem Zeitraum und ist nicht einstellbar: hour liefert 60 Punkte zu je einer Minute.
Messlücken werden beibehalten (Zeitstempel vorhanden, Felder auf null): Sie zu verbergen würde eine Kontinuität vortäuschen, die die Reihe nicht hat.
Die Reihe wird je nach Zeitraum zwischengespeichert: 1 Minute für hour, 5 Minuten für day, 30 Minuten für week, 1 Stunde für month und year.
Pfadparameter
-
vmidstring erforderlich -
Bezeichner des VPS. Er muss zum Konto und zum Umfang des Schlüssels gehören.
Query-Parameter
-
periodstring optional -
Abgedeckter Zeitraum.
Antworten
200
Zeitreihe
{
"data": {
"period": "hour",
"points": [
{
"at": "2026-08-07T14:40:00+02:00",
"cpu": 0.6778,
"memory_used": 7971806788,
"memory_total": 12884901888,
"disk_read": 0,
"disk_write": 11643,
"net_in": 279,
"net_out": 5054
},
{
"at": "2026-08-07T14:41:00+02:00",
"cpu": null,
"memory_used": null,
"memory_total": null,
"disk_read": null,
"disk_write": null,
"net_in": null,
"net_out": null
}
]
}
}
Felder der Antwort 11
-
dataobjecterforderlich -
periodstring -
pointsobject[] -
atstring (date-time) -
cpunumber (double) -
memory_usedinteger (int64) -
memory_totalinteger (int64) -
disk_readinteger (int64) -
disk_writeinteger (int64) -
net_ininteger (int64) -
net_outinteger (int64)
400
Ungültige Parameter: validation_failed — period nicht in der Liste.
validation_failed — period nicht in der Liste.{
"type": "https://docs.lws.fr/kvm/errors/validation-failed",
"title": "Paramètres invalides",
"status": 400,
"code": "validation_failed",
"detail": "Paramètre « period » invalide.",
"request_id": "3f9a1c07b2e45d18",
"errors": {
"period": "Valeurs acceptées : hour, day, week, month, year."
}
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
401
Authentifizierung abgelehnt: invalid_token — Header Authorization fehlt oder ist fehlerhaft, oder Schlüssel unbekannt; access_disabled — API-Zugang für dieses Konto gesperrt, oder API-Dienst vorübergehend von LWS abgeschaltet.
invalid_token — Header Authorization fehlt oder ist fehlerhaft, oder Schlüssel unbekannt; access_disabled — API-Zugang für dieses Konto gesperrt, oder API-Dienst vorübergehend von LWS abgeschaltet.Header Authorization fehlt oder ist fehlerhaft, oder Schlüssel unbekannt
{
"type": "https://docs.lws.fr/kvm/errors/invalid-token",
"title": "Authentification invalide",
"status": 401,
"code": "invalid_token",
"detail": "Clé inconnue ou révoquée.",
"request_id": "3f9a1c07b2e45d18"
}
API-Zugang für dieses Konto gesperrt, oder API-Dienst vorübergehend von LWS abgeschaltet
{
"type": "https://docs.lws.fr/kvm/errors/access-disabled",
"title": "Accès API désactivé",
"status": 401,
"code": "access_disabled",
"detail": "L'accès API est désactivé pour ce compte. Réactivez-le depuis la page « API / MCP » du panel.",
"request_id": "3f9a1c07b2e45d18"
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
403
Zugriff verweigert: ip_not_allowed — aufrufende Adresse nicht zugelassen.
ip_not_allowed — aufrufende Adresse nicht zugelassen.{
"type": "https://docs.lws.fr/kvm/errors/ip-not-allowed",
"title": "Adresse non autorisée",
"status": 403,
"code": "ip_not_allowed",
"detail": "L'adresse 203.0.113.10 ne figure pas parmi les adresses autorisées de ce compte.",
"request_id": "3f9a1c07b2e45d18"
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
404
Ressource nicht gefunden: vm_not_found — VPS existiert nicht oder liegt außerhalb des Umfangs des Schlüssels.
vm_not_found — VPS existiert nicht oder liegt außerhalb des Umfangs des Schlüssels.{
"type": "https://docs.lws.fr/kvm/errors/vm-not-found",
"title": "VPS introuvable",
"status": 404,
"code": "vm_not_found",
"detail": "Aucun VPS 999999 sur ce compte.",
"request_id": "3f9a1c07b2e45d18"
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
429
Kontingent überschritten: rate_limited — stündliches Kontingent der Gruppe ausgeschöpft.
rate_limited — stündliches Kontingent der Gruppe ausgeschöpft.{
"type": "https://docs.lws.fr/kvm/errors/rate-limited",
"title": "Quota dépassé",
"status": 429,
"code": "rate_limited",
"detail": "Quota dépassé pour les opérations de type « read » : 3600 appels par heure. Réessayez dans 37 seconde(s).",
"request_id": "3f9a1c07b2e45d18",
"family": "read",
"limit": 3600,
"retry_after": 37
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
502
Abhängigkeit nicht erreichbar: hypervisor_unreachable; upstream_unavailable — VPS-Inventar vorübergehend nicht verfügbar.
hypervisor_unreachable; upstream_unavailable — VPS-Inventar vorübergehend nicht verfügbar.Hypervisor nicht erreichbar
{
"type": "https://docs.lws.fr/kvm/errors/hypervisor-unreachable",
"title": "Hyperviseur injoignable",
"status": 502,
"code": "hypervisor_unreachable",
"detail": "L'hyperviseur hébergeant ce VPS n'a pas répondu. Réessayez dans quelques instants.",
"request_id": "3f9a1c07b2e45d18"
}
VPS-Inventar vorübergehend nicht verfügbar
{
"type": "https://docs.lws.fr/kvm/errors/upstream-unavailable",
"title": "Service momentanément indisponible",
"status": 502,
"code": "upstream_unavailable",
"detail": "Inventaire des VM indisponible.",
"request_id": "3f9a1c07b2e45d18"
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
503
Hostserver im Wartungseingriff: server_maintenance — Hostserver in einem von LWS angekündigten Eingriff und nicht erreichbar; beachten Sie Retry-After.
server_maintenance — Hostserver in einem von LWS angekündigten Eingriff und nicht erreichbar; beachten Sie Retry-After.{
"type": "https://docs.lws.fr/kvm/errors/server-maintenance",
"title": "Intervention en cours sur le serveur hôte",
"status": 503,
"code": "server_maintenance",
"detail": "Le serveur hébergeant ce VPS fait l'objet d'une intervention programmée par LWS : il est momentanément inaccessible. Fin prévue : 2026-10-21T18:00:00+02:00.",
"request_id": "3f9a1c07b2e45d18",
"maintenance": {
"kind": "works",
"started_at": "2026-10-21T14:00:00+02:00",
"expected_end": "2026-10-21T18:00:00+02:00"
}
}
Felder der Antwort 18
-
typestring (uri)erforderlich -
titlestringerforderlichKurztitel
-
statusinteger (int64)erforderlichHTTP-Status
-
codestringerforderlichStabiler Maschinencode (siehe „Fehler“ in Erste Schritte)
-
detailstringerforderlichAusführliche Meldung
-
request_idstringerforderlichBezeichner der Anfrage, an den Support weiterzugeben
-
errorsobjectvalidation_failed: Meldung je fehlerhaftem Parameter -
required_levelstringinsufficient_scope: vom Vorgang geforderte Stufe -
task_idstringtask_already_running: laufende Aufgabe auf diesem VPS -
familystringrate_limited: ausgeschöpfte Kontingentgruppe -
limitinteger (int64)rate_limited: stündliche Obergrenze der Gruppe -
retry_afterinteger (int64)rate_limited: Sekunden bis zum nächsten Versuch -
lockstringserver_locked: vom Hypervisor gesetzte Sperre (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress– ein Vorgang läuft, versuchen Sie es nachRetry-Aftererneut;suspended– der VPS befindet sich im Ruhezustand, starten Sie ihn zuerst;support_notified– ungewöhnliche Sperre, das LWS-Team ist informiert und kümmert sich darum -
maintenanceobjectserver_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (nullbei einem Vorfall) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)