Entsperrung von Port 25 beantragen

POST /api/v1/servers/{vmid}/firewall/unblock-port25

operationIdpostServerUnblockPort25

Erforderliche Stufe: Betrieb
Kontingent: Mutation, 300 Aufrufe pro Stunde

Der ausgehende Port 25 (SMTP) ist auf den VPS standardmäßig gesperrt. Dieser Aufruf stellt einen Antrag auf Entsperrung, der vom LWS-Team geprüft wird: Es handelt sich nicht um eine sofortige Aktion auf dem VPS, und solange der Antrag nicht angenommen ist, gibt es keine Aufgabe zu verfolgen.

Die Antwort ist der Zustand der Firewall des VPS, dessen port_25.status auf pending wechselt. Verfolgen Sie die weitere Entwicklung anschließend über GET /servers/{vmid}/firewall: pending (wartet auf Prüfung), processing (angenommen, Entsperrung läuft), done, failed. Ein abgelehnter Antrag setzt den Zustand auf none zurück.

Pfadparameter

vmid string erforderlich: Bezeichner des VPS. Er muss zum Konto und zum Umfang des Schlüssels gehören.

Muster ^\d+$ Beispiel: 116807

Anfrage-Body

application/json

reason string

Begründung des Antrags, vom LWS-Team gelesen

max. 500 Zeichen min. 1 Zeichen

erforderlich

Beispielanfrage

{
  "reason": "Serveur de messagerie transactionnelle pour notre boutique en ligne."
}

Antworten

200

Antrag gespeichert; Zustand der Firewall aktualisiert

{
  "data": {
    "enabled": false,
    "available": true,
    "client_rules": [],
    "lws_rules": [
      {
        "port": "25",
        "protocol": "TCP",
        "sources": [],
        "open_to_any": true,
        "set": "LWS - Protection mail"
      }
    ],
    "port_25": {
      "status": "pending"
    }
  }
}

Felder der Antwort 17

data object

ServerFirewall

erforderlich
enabled boolean

null: Zustand unbekannt (Datenbank des Hypervisors nicht erreichbar)
available boolean

false, wenn der Zustand nicht gelesen werden konnte
client_rules object[]
port string

Port oder Bereich Anfang-Ende

Beispiel: 443
protocol string

Protokoll, immer in Großbuchstaben

eines von: TCP, UDP
sources string[]

Zugelassene Adressen oder CIDR-Bereiche; leer, wenn die Regel für alle offen ist
open_to_any boolean

true, wenn keine Adresse die Regel einschränkt
set string

Regelsatz, aus dem die Regel stammt
lws_rules object[]

Von LWS gesetzte Regeln, nicht änderbar
port string

Port oder Bereich Anfang-Ende

Beispiel: 443
protocol string

Protokoll, immer in Großbuchstaben

eines von: TCP, UDP
sources string[]

Zugelassene Adressen oder CIDR-Bereiche; leer, wenn die Regel für alle offen ist
open_to_any boolean

true, wenn keine Adresse die Regel einschränkt
set string

Regelsatz, aus dem die Regel stammt
port_25 object
status string

Verfolgung des Antrags auf Entsperrung des ausgehenden Ports 25

eines von: none, pending, processing, done, failed

400

Ungültige Parameter: validation_failed — reason fehlt, ist leer oder länger als 500 Zeichen.

{
  "type": "https://docs.lws.fr/kvm/errors/validation-failed",
  "title": "Paramètres invalides",
  "status": 400,
  "code": "validation_failed",
  "detail": "Paramètre « reason » invalide.",
  "request_id": "3f9a1c07b2e45d18",
  "errors": {
    "reason": "Motif requis, chaîne non vide."
  }
}

Felder der Antwort 18

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (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.

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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

403

Zugriff verweigert: 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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

404

Ressource nicht gefunden: 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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

409

Konflikt mit dem aktuellen Zustand: invalid_state — für diesen VPS wartet bereits ein Antrag auf Prüfung (pending); service_suspended — VPS deaktiviert oder abgelaufen: Nur Lesevorgänge bleiben möglich.

für diesen VPS wartet bereits ein Antrag auf Prüfung (pending)

{
  "type": "https://docs.lws.fr/kvm/errors/invalid-state",
  "title": "Opération impossible en l'état",
  "status": 409,
  "code": "invalid_state",
  "detail": "Une demande de déblocage du port 25 est déjà en cours pour ce VPS.",
  "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"
}

Felder der Antwort 18

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

429

Kontingent überschritten: 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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

502

Abhängigkeit nicht erreichbar: upstream_unavailable — 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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

503

Hostserver im Wartungseingriff: 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

type string (uri)

Beispiel: https://docs.lws.fr/kvm/errors/vm-not-found

erforderlich
title string

Kurztitel

Beispiel: VPS introuvable

erforderlich
status integer (int64)

HTTP-Status

Beispiel: 404

erforderlich
code string

Stabiler Maschinencode (siehe „Fehler“ in Erste Schritte)

Beispiel: vm_not_found

erforderlich
detail string

Ausführliche Meldung

Beispiel: Aucun VPS 999999 sur ce compte.

erforderlich
request_id string

Bezeichner der Anfrage, an den Support weiterzugeben

Beispiel: 3f9a1c07b2e45d18

erforderlich
errors object

validation_failed: Meldung je fehlerhaftem Parameter
required_level string

insufficient_scope: vom Vorgang geforderte Stufe

eines von: read, exploitation, full
task_id string

task_already_running: laufende Aufgabe auf diesem VPS

Beispiel: tsk_000002d5
family string

rate_limited: ausgeschöpfte Kontingentgruppe

eines von: read, mutation, heavy
limit integer (int64)

rate_limited: stündliche Obergrenze der Gruppe
retry_after integer (int64)

rate_limited: Sekunden bis zum nächsten Versuch
lock string

server_locked: vom Hypervisor gesetzte Sperre (backup, snapshot, suspended …)

Beispiel: snapshot
reason string

server_locked: operation_in_progress – ein Vorgang läuft, versuchen Sie es nach Retry-After erneut; 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

eines von: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: Art des Eingriffs, Beginn und voraussichtliches Ende (null bei einem Vorfall)
kind string

eines von: works, incident
started_at string (date-time)
expected_end string (date-time)

Entsperrung von Port 25 beantragen

Pfadparameter

Anfrage-Body

Antworten

Fehler melden

KI-Assistent