Listar os sistemas disponíveis

GET /api/v1/catalog/os-templates

operationIdgetOsTemplates

Nível exigido: Apenas leitura
Quota: leitura, 3600 chamadas por hora

Modelos de sistema utilizáveis numa reinstalação: category: ssh (sistemas simples) e category: app (aplicação pré-instalada). Lista não paginada.

O par os / variant é exatamente o que POST /servers/{vmid}/rebuild espera. min_memory_gb está em gigabytes (0: sem mínimo) e permite verificar se um VPS é elegível antes de o reinstalar.

Respostas

200

Catálogo

{
  "data": [
    {
      "os": "almalinux-10",
      "variant": "default",
      "distribution": "almalinux",
      "version": "10",
      "commercial_name": "AlmaLinux 10",
      "category": "ssh",
      "min_memory_gb": 0,
      "managed": false
    },
    {
      "os": "debian-12",
      "variant": "forgejo",
      "distribution": "debian",
      "version": "12",
      "commercial_name": "Forgejo",
      "category": "app",
      "min_memory_gb": 2,
      "managed": false
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 41,
    "total": 41,
    "total_pages": 1
  }
}

Campos da resposta 14

data object[]

obrigatório
os string

A indicar na reinstalação

Exemplo: debian-12
variant string

A indicar na reinstalação

Exemplo: default
distribution string
version string
commercial_name string
category string

ssh: sistema simples; app: aplicação pré-instalada
min_memory_gb integer (int64)

Memória mínima, em GB; 0: sem mínimo
managed boolean

Template gerido
meta object

Paginação. As listas não paginadas devolvem tudo e meta reflete o número devolvido.

PaginationMeta

obrigatório
page integer (int64)

Página devolvida

Exemplo: 1
per_page integer (int64)

Tamanho da página

Exemplo: 25
total integer (int64)

Número total de elementos

Exemplo: 887
total_pages integer (int64)

Número total de páginas

Exemplo: 36

401

Autenticação recusada: invalid_token — cabeçalho Authorization ausente ou mal formado, ou chave desconhecida; access_disabled — acesso à API cortado para esta conta, ou serviço de API momentaneamente suspenso pela LWS.

cabeçalho Authorization ausente ou mal formado, ou chave desconhecida

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

acesso à API cortado para esta conta, ou serviço de API momentaneamente suspenso pela 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 da resposta 18

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)

403

Acesso recusado: ip_not_allowed — endereço de chamada não autorizado.

{
  "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 da resposta 18

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)

429

Quota excedida: rate_limited — quota horária da família esgotada.

{
  "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 « read » : 3600 appels par heure. Réessayez dans 37 seconde(s).",
  "request_id": "3f9a1c07b2e45d18",
  "family": "read",
  "limit": 3600,
  "retry_after": 37
}

Campos da resposta 18

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)

502

Dependência inacessível: upstream_unavailable — catálogo momentaneamente indisponível.

{
  "type": "https://docs.lws.fr/kvm/errors/upstream-unavailable",
  "title": "Service momentanément indisponible",
  "status": 502,
  "code": "upstream_unavailable",
  "detail": "Le catalogue des systèmes n'a pas pu être obtenu. Réessayez dans quelques instants.",
  "request_id": "3f9a1c07b2e45d18"
}

Campos da resposta 18

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)

Listar os sistemas disponíveis

Respostas

Comunicar um erro

Assistente IA