Esquema

Problem

• type string (uri)

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

  obrigatório
• title string

  Título curto

  Exemplo: VPS introuvable

  obrigatório
• status integer (int64)

  Estado HTTP

  Exemplo: 404

  obrigatório
• code string

  Código de máquina estável (ver «Erros» em Primeiros passos)

  Exemplo: vm_not_found

  obrigatório
• detail string

  Mensagem detalhada

  Exemplo: Aucun VPS 999999 sur ce compte.

  obrigatório
• request_id string

  Identificador do pedido, a comunicar ao suporte

  Exemplo: 3f9a1c07b2e45d18

  obrigatório
• errors object

  validation_failed: mensagem por parâmetro incorreto

• required_level string

  insufficient_scope: nível exigido pela operação

  um de: read, exploitation, full

• task_id string

  task_already_running: tarefa em curso neste VPS

  Exemplo: tsk_000002d5

• family string

  rate_limited: família de quota esgotada

  um de: read, mutation, heavy

• limit integer (int64)

  rate_limited: limite horário da família

• retry_after integer (int64)

  rate_limited: segundos a aguardar

• lock string

  server_locked: bloqueio aplicado pelo hipervisor (backup, snapshot, suspended…)

  Exemplo: snapshot

• reason string

  server_locked: operation_in_progress, há uma operação em curso, tente novamente após Retry-After; suspended, o VPS está em hibernação, inicie-o primeiro; support_notified, bloqueio anómalo, a equipa LWS foi avisada e está a intervir

  um de: operation_in_progress, suspended, support_notified

• maintenance object

  server_maintenance: natureza da intervenção, início e fim previsto (null para um incidente)

• kind string

  um de: works, incident

• started_at string (date-time)
• expected_end string (date-time)

{
  "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",
  "errors": [],
  "required_level": "read",
  "task_id": "tsk_000002d5",
  "family": "read",
  "limit": 0,
  "retry_after": 0,
  "lock": "snapshot",
  "reason": "operation_in_progress",
  "maintenance": {
    "kind": "works",
    "started_at": "2026-01-15T10:30:00Z",
    "expected_end": "2026-01-15T10:30:00Z"
  }
}