Modificar un conjunto de reglas

PUT /api/v1/firewall/sets/{id}

operationIdputFirewallSet

Nivel requerido: Explotación
Cuota: mutación, 300 llamadas por hora

Sustituye el nombre y la totalidad de las reglas: no es una fusión, las reglas ausentes del cuerpo desaparecen. description ausente del cuerpo se conserva; presente y vacía, se borra.

La actualización del cortafuegos de todos los VPS en los que está aplicado el conjunto se pone en cola de inmediato (cuente unos minutos): modificar un conjunto en uso cambia el cortafuegos de varias máquinas a la vez (applied_to indica cuáles).

Con una clave limitada a una selección de VPS, un conjunto aplicado también a un VPS que la clave no cubre no puede modificarse ni eliminarse (409 invalid_state): hágalo desde el panel o amplíe el alcance de la clave.

Parámetros de ruta

id string obligatorio: Identificador del conjunto de reglas.

patrón ^\d+$ Ejemplo: 34

Cuerpo de la solicitud

application/json

name string

máx. 100 caracteres

obligatorio
description string

opcional
rules object[]

obligatorio
port string

Puerto (443) o intervalo (8000-8100), límites de 1 a 65535

Ejemplo: 443

obligatorio
protocol string

uno de: TCP, UDP

obligatorio
subnet string

Direcciones IPv4/IPv6 (se acepta CIDR, salvo /0 en IPv6) separadas por comas; ausente, vacío o NULL: desde cualquier lugar, tanto en IPv4 como en IPv6

Ejemplo: 45.54.45.54

opcional

Ejemplo de solicitud

{
  "name": "Web public",
  "rules": [
    {
      "port": "443",
      "protocol": "TCP",
      "subnet": "45.54.45.54"
    },
    {
      "port": "8000-8100",
      "protocol": "TCP",
      "subnet": "NULL"
    }
  ]
}

Respuestas

200

Conjunto actualizado

{
  "data": {
    "id": "34",
    "name": "Web public",
    "description": "HTTPS depuis le bureau",
    "rules": [
      {
        "port": "443",
        "protocol": "TCP",
        "sources": [
          "45.54.45.54"
        ],
        "open_to_any": false
      }
    ],
    "applied_to": [
      "116807"
    ]
  }
}

Campos de la respuesta 10

data object

FirewallSet

obligatorio
id string

Ejemplo: 34
name string
description string
rules object[]
port string

Puerto o intervalo inicio-fin

Ejemplo: 443
protocol string

Protocolo, siempre en mayúsculas

uno de: TCP, UDP
sources string[]

Direcciones o rangos CIDR autorizados; vacío si la regla está abierta a todo el mundo
open_to_any boolean

true si ninguna dirección restringe la regla
applied_to string[]

VPS (cubiertos por la clave) a los que está aplicado el conjunto

400

Parámetros no válidos: validation_failed — nombre ausente o demasiado largo, o regla no válida (se indica su posición).

{
  "type": "https://docs.lws.fr/kvm/errors/validation-failed",
  "title": "Paramètres invalides",
  "status": 400,
  "code": "validation_failed",
  "detail": "Règle #2 : port hors limites (99999)",
  "request_id": "3f9a1c07b2e45d18",
  "errors": {
    "rules": "Règle #2 : port hors limites (99999)"
  }
}

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: set_not_found — conjunto desconocido o perteneciente a otra cuenta.

{
  "type": "https://docs.lws.fr/kvm/errors/set-not-found",
  "title": "Jeu de règles introuvable",
  "status": 404,
  "code": "set_not_found",
  "detail": "Jeu de règles introuvable.",
  "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: invalid_state — conjunto aplicado también a VPS que la clave no cubre.

{
  "type": "https://docs.lws.fr/kvm/errors/invalid-state",
  "title": "Opération impossible en l'état",
  "status": 409,
  "code": "invalid_state",
  "detail": "Ce jeu de règles est aussi appliqué à des VPS que cette clé ne couvre pas. Modifiez-le depuis le panel, ou étendez la portée de la clé à ces VPS.",
  "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: upstream_unavailable — imposible registrar.

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

Modificar un conjunto de reglas

Parámetros de ruta

Cuerpo de la solicitud

Respuestas

Informar de un error

Asistente IA