Activar o desactivar el cortafuegos

Diferido Asíncrono · 202

PUT /api/v1/servers/{vmid}/firewall

operationIdputServerFirewall

Nivel requerido: Explotación para activar, Completo para desactivar
Cuota: mutación, 300 llamadas por hora

Activa o desactiva el filtrado en el VPS y, a continuación, actualiza sus reglas.

La activación se aplica a las reglas de los conjuntos aplicados al VPS: una vez activo el cortafuegos, se bloquea todo el tráfico entrante que no autorice ninguno de ellos, tanto en IPv4 como en IPv6. Si no hay ningún conjunto aplicado, no tiene efecto y enabled sigue en false: aplique primero un conjunto (POST /servers/{vmid}/firewall/sets/{id}).

El nivel exigido depende del sentido del cambio: activar (enabled: true) protege, basta con una clave Explotación; desactivar (enabled: false) expone la máquina, se necesita una clave Completo.

La matriz tasks puede estar vacía si la tarea de sincronización aún no es visible en el momento de la respuesta: en ese caso, el estado se vuelve a leer con GET /servers/{vmid}/firewall.

Esta solicitud se procesa en segundo plano: responde de inmediato mientras el trabajo continúa. Sígala con los endpoints de tareas o solicitudes.

Parámetros de ruta

vmid string obligatorio: Identificador del VPS. Debe pertenecer a la cuenta y al alcance de la clave.

patrón ^\d+$ Ejemplo: 116807

Cuerpo de la solicitud

application/json

enabled boolean

true: activar el filtrado; false: desactivarlo

obligatorio

Ejemplo de solicitud

{
  "enabled": true
}

Respuestas

202

Solicitud aceptada y puesta en cola. Siga la tarea devuelta con GET /tasks/{id}.

La solicitud fue aceptada, no completada. La respuesta incluye una tarea que seguir.

{
  "data": {
    "tasks": [
      {
        "id": "tsk_000002e1",
        "status": "pending",
        "action": "firewall.sync",
        "vmid": "116807",
        "description": "Mise à jour des règles Firewall pour la VM : 116807",
        "created_at": "2026-08-20T14:31:02+02:00",
        "finished_at": null
      }
    ]
  }
}

Campos de la respuesta 9

data object
tasks object[]

Tareas creadas; siempre una matriz
id string

Identificador opaco

Ejemplo: tsk_000002e1
status string

unknown indicaría un estado que la API no sabe nombrar

uno de: pending, succeeded, failed, unknown
action string

Tipo de tarea

uno de: server.start, server.stop, server.shutdown, server.reboot, server.reset, server.rebuild, server.enable_rescue, server.disable_rescue, server.reboot_rescue, snapshot.create, snapshot.delete, snapshot.rollback, backup.create, backup.restore, iso.mount, iso.unmount, firewall.sync, firewall.unblock_port_25 TaskAction
vmid string
description string
created_at string (date-time)
finished_at string (date-time)

null mientras la tarea está en ejecución

400

Parámetros no válidos: validation_failed — enabled ausente o no booleano.

{
  "type": "https://docs.lws.fr/kvm/errors/validation-failed",
  "title": "Paramètres invalides",
  "status": 400,
  "code": "validation_failed",
  "detail": "Paramètre « enabled » invalide.",
  "request_id": "3f9a1c07b2e45d18",
  "errors": {
    "enabled": "Booléen attendu : true pour activer le pare-feu, false pour le désactiver."
  }
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

401

Autenticación rechazada: invalid_token — encabezado Authorization ausente o mal formado, o clave desconocida; access_disabled — acceso a la API cortado para esta cuenta, o servicio de API cortado momentáneamente por LWS.

encabezado Authorization ausente o mal formado, o clave desconocida

{
  "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"
}

acceso a la API cortado para esta cuenta, o servicio de API cortado momentáneamente por LWS

{
  "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"
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

403

Acceso denegado: insufficient_scope — nivel de la clave insuficiente; ip_not_allowed — dirección de origen no autorizada.

nivel de la clave insuficiente

{
  "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"
}

dirección de origen no autorizada

{
  "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"
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

404

Recurso no encontrado: vm_not_found — VPS inexistente o fuera del alcance de la clave.

{
  "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"
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

409

Conflicto con el estado actual: task_already_running — ya hay una sincronización del cortafuegos o una reinstalación en curso; service_suspended — VPS desactivado o caducado: solo siguen siendo posibles las lecturas.

ya hay una sincronización del cortafuegos o una reinstalación en curso

{
  "type": "https://docs.lws.fr/kvm/errors/task-already-running",
  "title": "Opération déjà en cours",
  "status": 409,
  "code": "task_already_running",
  "detail": "Une synchronisation du pare-feu est déjà en cours sur ce VPS. Attendez qu'elle aboutisse.",
  "request_id": "3f9a1c07b2e45d18",
  "task_id": "tsk_000002d5"
}

VPS desactivado o caducado: solo siguen siendo posibles las lecturas

{
  "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"
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

429

Cuota superada: rate_limited — cuota por hora de la familia agotada.

{
  "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
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

502

Dependencia inaccesible: hypervisor_unreachable — la base de datos del hipervisor no responde, no se ha modificado nada; upstream_unavailable — inventario de VPS momentáneamente no disponible.

la base de datos del hipervisor no responde, no se ha modificado nada

{
  "type": "https://docs.lws.fr/kvm/errors/hypervisor-unreachable",
  "title": "Hyperviseur injoignable",
  "status": 502,
  "code": "hypervisor_unreachable",
  "detail": "La base de l'hyperviseur n'a pas répondu, le pare-feu n'a pas été modifié.",
  "request_id": "3f9a1c07b2e45d18"
}

inventario de VPS momentáneamente no disponible

{
  "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"
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

503

Servidor anfitrión en intervención: server_maintenance — servidor anfitrión en una intervención anunciada por LWS e inaccesible; respete 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"
  }
}

Campos de la respuesta 18

type string (uri)

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

obligatorio
title string

Título breve

Ejemplo: VPS introuvable

obligatorio
status integer (int64)

Estado HTTP

Ejemplo: 404

obligatorio
code string

Código de máquina estable (véase «Errores» en Primeros pasos)

Ejemplo: vm_not_found

obligatorio
detail string

Mensaje detallado

Ejemplo: Aucun VPS 999999 sur ce compte.

obligatorio
request_id string

Identificador de la petición, que debe facilitarse al soporte

Ejemplo: 3f9a1c07b2e45d18

obligatorio
errors object

validation_failed: mensaje por parámetro erróneo
required_level string

insufficient_scope: nivel exigido por la operación

uno de: read, exploitation, full
task_id string

task_already_running: tarea en curso en este VPS

Ejemplo: tsk_000002d5
family string

rate_limited: familia de cuota agotada

uno de: read, mutation, heavy
limit integer (int64)

rate_limited: límite por hora de la familia
retry_after integer (int64)

rate_limited: segundos de espera
lock string

server_locked: bloqueo establecido por el hipervisor (backup, snapshot, suspended…)

Ejemplo: snapshot
reason string

server_locked: operation_in_progress, hay una operación en curso, vuelva a intentarlo tras Retry-After; suspended, el VPS está en hibernación, arránquelo primero; support_notified, bloqueo anómalo, el equipo de LWS ha sido avisado y está interviniendo

uno de: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: naturaleza de la intervención, inicio y fin previsto (null para una incidencia)
kind string

uno de: works, incident
started_at string (date-time)
expected_end string (date-time)

Activar o desactivar el cortafuegos

Parámetros de ruta

Cuerpo de la solicitud

Respuestas

Informar de un error

Asistente IA