Reimpostare la password root

POST /api/v1/servers/{vmid}/root-password

operationIdpostServerRootPassword

Livello richiesto: Completo
Quota: modifica, 300 chiamate all'ora

Imposta una nuova password per l'account root del VPS. Operazione immediata: non c'è alcun task da seguire.

La password viene generata, non scelta: non transita nella richiesta (dove finirebbe in un log o in una cronologia della shell) e il suo alfabeto esclude i tasti che cambiano posizione tra AZERTY e QWERTY. Viene restituita una sola volta, in questa risposta, e non compare nel registro attività.

La password viene impostata nel sistema in esecuzione dall'agente QEMU (qemu-guest-agent): è utilizzabile non appena arriva la risposta, senza riavvio (effective_after_reboot vale false). Il VPS deve essere avviato e l'agente attivo, altrimenti la chiamata risponde 502.

Path parameters

vmid string required: Identificativo del VPS. Deve appartenere all'account e rientrare nell'ambito della chiave.

pattern ^\d+$ Example: 116807

Responses

200

Password impostata

{
  "data": {
    "password": "shfKvbnERTUP2345",
    "effective_after_reboot": false
  }
}

Response fields 3

data object

RootPassword

required
password string

Password generata, restituita una sola volta
effective_after_reboot boolean

Sempre false: la password è attiva non appena arriva la risposta

one of:

401

Autenticazione rifiutata: invalid_token — intestazione Authorization assente o non valida, oppure chiave sconosciuta; access_disabled — accesso API disattivato per questo account, oppure servizio API momentaneamente sospeso da LWS.

intestazione Authorization assente o non valida, oppure chiave sconosciuta

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

accesso API disattivato per questo account, oppure servizio API momentaneamente sospeso da 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"
}

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

403

Accesso negato: insufficient_scope — livello della chiave insufficiente; ip_not_allowed — indirizzo di chiamata non autorizzato.

livello della chiave insufficiente

{
  "type": "https://docs.lws.fr/kvm/errors/insufficient-scope",
  "title": "Droits insuffisants",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "Niveau de permission « full » requis.",
  "request_id": "3f9a1c07b2e45d18",
  "required_level": "full"
}

indirizzo di chiamata non autorizzato

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

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

404

Risorsa non trovata: vm_not_found — VPS inesistente o fuori dall'ambito della chiave.

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

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

409

Conflitto con lo stato attuale: service_suspended — VPS disattivato o scaduto: sono possibili solo le letture.

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

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

429

Quota superata: rate_limited — quota oraria della famiglia esaurita.

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

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

502

Dipendenza irraggiungibile: hypervisor_unreachable — hypervisor irraggiungibile, VPS arrestato o agente QEMU assente; upstream_unavailable — inventario dei VPS momentaneamente non disponibile.

hypervisor irraggiungibile, VPS arrestato o agente QEMU assente

{
  "type": "https://docs.lws.fr/kvm/errors/hypervisor-unreachable",
  "title": "Hyperviseur injoignable",
  "status": 502,
  "code": "hypervisor_unreachable",
  "detail": "Le mot de passe n'a pas pu être appliqué.",
  "request_id": "3f9a1c07b2e45d18"
}

inventario dei VPS momentaneamente non disponibile

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

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

503

Server host in intervento: server_maintenance — server host in intervento annunciato da LWS e irraggiungibile; rispetti 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"
  }
}

Response fields 18

type string (uri)

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

required
title string

Titolo breve

Example: VPS introuvable

required
status integer (int64)

Stato HTTP

Example: 404

required
code string

Codice macchina stabile (vedere «Errori» in Per iniziare)

Example: vm_not_found

required
detail string

Messaggio dettagliato

Example: Aucun VPS 999999 sur ce compte.

required
request_id string

Identificativo della richiesta, da comunicare al supporto

Example: 3f9a1c07b2e45d18

required
errors object

validation_failed: messaggio per ogni parametro errato
required_level string

insufficient_scope: livello richiesto dall'operazione

one of: read, exploitation, full
task_id string

task_already_running: task in corso su questo VPS

Example: tsk_000002d5
family string

rate_limited: famiglia di quota esaurita

one of: read, mutation, heavy
limit integer (int64)

rate_limited: limite orario della famiglia
retry_after integer (int64)

rate_limited: secondi da attendere
lock string

server_locked: blocco impostato dall'hypervisor (backup, snapshot, suspended…)

Example: snapshot
reason string

server_locked: operation_in_progress, è in corso un'operazione, riprovi dopo Retry-After; suspended, il VPS è in ibernazione, lo avvii prima; support_notified, blocco anomalo, il team LWS è stato avvisato e sta intervenendo

one of: operation_in_progress, suspended, support_notified
maintenance object

server_maintenance: natura dell'intervento, inizio e fine prevista (null per un incidente)
kind string

one of: works, incident
started_at string (date-time)
expected_end string (date-time)

Reimpostare la password root

Path parameters

Responses

Report an error

AI assistant