ISO-Image auswerfen
DELETE
/api/v1/
operationIddeleteServerIso
- Erforderliche Stufe
- Betrieb
- Kontingent
- Mutation, 300 Aufrufe pro Stunde
Leert das optische Laufwerk. Sofortiger und wie das Einhängen überprüfter Vorgang: Die Antwort meldet mounted: null nur, wenn das Laufwerk tatsächlich leer ist.
Pfadparameter
-
vmidstring erforderlich -
Bezeichner des VPS. Er muss zum Konto und zum Umfang des Schlüssels gehören.
Antworten
200
Laufwerk geleert
{
"data": {
"mounted": null
}
}
Felder der Antwort 2
-
dataobjecterforderlich -
mountedstringEingehängtes Volume, erneut vom Hypervisor gelesen
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: insufficient_scope — Stufe des Schlüssels unzureichend; ip_not_allowed — aufrufende Adresse nicht zugelassen.
insufficient_scope — Stufe des Schlüssels unzureichend; ip_not_allowed — aufrufende Adresse nicht zugelassen.Stufe des Schlüssels unzureichend
{
"type": "https://docs.lws.fr/kvm/errors/insufficient-scope",
"title": "Droits insuffisants",
"status": 403,
"code": "insufficient_scope",
"detail": "Niveau de permission « exploitation » requis.",
"request_id": "3f9a1c07b2e45d18",
"required_level": "exploitation"
}
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)
409
Konflikt mit dem aktuellen Zustand: invalid_state — der Hypervisor hat die Änderung nicht übernommen (zum Beispiel Image nicht im Speicher vorhanden); service_suspended — VPS deaktiviert oder abgelaufen: Nur Lesevorgänge bleiben möglich; server_locked — VPS vom Hypervisor gesperrt, siehe reason; bei operation_in_progress gibt Retry-After die empfohlene Wartezeit an.
invalid_state — der Hypervisor hat die Änderung nicht übernommen (zum Beispiel Image nicht im Speicher vorhanden); service_suspended — VPS deaktiviert oder abgelaufen: Nur Lesevorgänge bleiben möglich; server_locked — VPS vom Hypervisor gesperrt, siehe reason; bei operation_in_progress gibt Retry-After die empfohlene Wartezeit an.der Hypervisor hat die Änderung nicht übernommen (zum Beispiel Image nicht im Speicher vorhanden)
{
"type": "https://docs.lws.fr/kvm/errors/invalid-state",
"title": "Opération impossible en l'état",
"status": 409,
"code": "invalid_state",
"detail": "L'hyperviseur n'a pas appliqué le changement. Vérifiez que cette image existe.",
"request_id": "3f9a1c07b2e45d18"
}
VPS deaktiviert oder abgelaufen: Nur Lesevorgänge bleiben möglich
{
"type": "https://docs.lws.fr/kvm/errors/service-suspended",
"title": "Service suspendu",
"status": 409,
"code": "service_suspended",
"detail": "Le VPS 116807 est expiré.",
"request_id": "3f9a1c07b2e45d18"
}
VPS vom Hypervisor gesperrt, siehe reason; bei operation_in_progress gibt Retry-After die empfohlene Wartezeit an
{
"type": "https://docs.lws.fr/kvm/errors/server-locked",
"title": "Serveur verrouillé",
"status": 409,
"code": "server_locked",
"detail": "Action impossible pour le moment : une sauvegarde est en cours sur le serveur. Réessayez dans quelques minutes.",
"request_id": "3f9a1c07b2e45d18",
"lock": "snapshot",
"reason": "operation_in_progress"
}
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 « mutation » : 300 appels par heure. Réessayez dans 95 seconde(s).",
"request_id": "3f9a1c07b2e45d18",
"family": "mutation",
"limit": 300,
"retry_after": 95
}
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)