Lister les adresses IP

200

Adresses du VPS

{
  "data": [
    {
      "address": "31.207.34.214",
      "type": "IPv4",
      "primary": true,
      "reverse": "vps116807.serveur-vps.net"
    },
    {
      "address": "2a00:7ee0:9:1:11:6807:1:1",
      "type": "IPv6",
      "primary": true,
      "reverse": "vps116807.serveur-vps.net"
    },
    {
      "address": "51.83.12.98",
      "type": "IPv4",
      "primary": false,
      "reverse": null
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 3,
    "total": 3,
    "total_pages": 1
  }
}

Champs de la réponse 10

data object[]

requis
address string
type string

parmi : IPv4, IPv6
primary boolean

Adresse principale du VPS
reverse string

Reverse DNS ; null si absent ou non résolu
meta object

Pagination. Les listes non paginées renvoient tout et meta reflète le nombre renvoyé.

PaginationMeta

requis
page integer (int64)

Page renvoyée

Exemple: 1
per_page integer (int64)

Taille de page

Exemple: 25
total integer (int64)

Nombre total d'éléments

Exemple: 887
total_pages integer (int64)

Nombre total de pages

Exemple: 36

401

Authentification refusée : invalid_token — en-tête Authorization absent ou malformé, ou clé inconnue ; access_disabled — accès API coupé pour ce compte, ou service API momentanément coupé par LWS.

en-tête Authorization absent ou malformé, ou clé inconnue

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

accès API coupé pour ce compte, ou service API momentanément coupé par 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"
}

Champs de la réponse 18

type string (uri)

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

requis
title string

Titre court

Exemple: VPS introuvable

requis
status integer (int64)

Statut HTTP

Exemple: 404

requis
code string

Code machine stable (voir « Erreurs » dans Pour commencer)

Exemple: vm_not_found

requis
detail string

Message détaillé

Exemple: Aucun VPS 999999 sur ce compte.

requis
request_id string

Identifiant de la requête, à communiquer au support

Exemple: 3f9a1c07b2e45d18

requis
errors object

validation_failed : message par paramètre fautif
required_level string

insufficient_scope : niveau exigé par l'opération

parmi : read, exploitation, full
task_id string

task_already_running : tâche en cours sur ce VPS

Exemple: tsk_000002d5
family string

rate_limited : famille de quota épuisée

parmi : read, mutation, heavy
limit integer (int64)

rate_limited : plafond horaire de la famille
retry_after integer (int64)

rate_limited : secondes à attendre
lock string

server_locked : verrou posé par l'hyperviseur (backup, snapshot, suspended…)

Exemple: snapshot
reason string

server_locked : operation_in_progress, une opération est en cours, réessayez après Retry-After ; suspended, le VPS hiberne, démarrez-le d'abord ; support_notified, verrou anormal, l'équipe LWS est prévenue et intervient

parmi : operation_in_progress, suspended, support_notified
maintenance object

server_maintenance : nature de l'intervention, début et fin prévue (null pour un incident)
kind string

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

403

Accès refusé : ip_not_allowed — adresse d'appel non autorisée.

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

Champs de la réponse 18

type string (uri)

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

requis
title string

Titre court

Exemple: VPS introuvable

requis
status integer (int64)

Statut HTTP

Exemple: 404

requis
code string

Code machine stable (voir « Erreurs » dans Pour commencer)

Exemple: vm_not_found

requis
detail string

Message détaillé

Exemple: Aucun VPS 999999 sur ce compte.

requis
request_id string

Identifiant de la requête, à communiquer au support

Exemple: 3f9a1c07b2e45d18

requis
errors object

validation_failed : message par paramètre fautif
required_level string

insufficient_scope : niveau exigé par l'opération

parmi : read, exploitation, full
task_id string

task_already_running : tâche en cours sur ce VPS

Exemple: tsk_000002d5
family string

rate_limited : famille de quota épuisée

parmi : read, mutation, heavy
limit integer (int64)

rate_limited : plafond horaire de la famille
retry_after integer (int64)

rate_limited : secondes à attendre
lock string

server_locked : verrou posé par l'hyperviseur (backup, snapshot, suspended…)

Exemple: snapshot
reason string

server_locked : operation_in_progress, une opération est en cours, réessayez après Retry-After ; suspended, le VPS hiberne, démarrez-le d'abord ; support_notified, verrou anormal, l'équipe LWS est prévenue et intervient

parmi : operation_in_progress, suspended, support_notified
maintenance object

server_maintenance : nature de l'intervention, début et fin prévue (null pour un incident)
kind string

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

404

Ressource introuvable : vm_not_found — VPS inexistant ou hors de la portée de la clé.

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

Champs de la réponse 18

type string (uri)

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

requis
title string

Titre court

Exemple: VPS introuvable

requis
status integer (int64)

Statut HTTP

Exemple: 404

requis
code string

Code machine stable (voir « Erreurs » dans Pour commencer)

Exemple: vm_not_found

requis
detail string

Message détaillé

Exemple: Aucun VPS 999999 sur ce compte.

requis
request_id string

Identifiant de la requête, à communiquer au support

Exemple: 3f9a1c07b2e45d18

requis
errors object

validation_failed : message par paramètre fautif
required_level string

insufficient_scope : niveau exigé par l'opération

parmi : read, exploitation, full
task_id string

task_already_running : tâche en cours sur ce VPS

Exemple: tsk_000002d5
family string

rate_limited : famille de quota épuisée

parmi : read, mutation, heavy
limit integer (int64)

rate_limited : plafond horaire de la famille
retry_after integer (int64)

rate_limited : secondes à attendre
lock string

server_locked : verrou posé par l'hyperviseur (backup, snapshot, suspended…)

Exemple: snapshot
reason string

server_locked : operation_in_progress, une opération est en cours, réessayez après Retry-After ; suspended, le VPS hiberne, démarrez-le d'abord ; support_notified, verrou anormal, l'équipe LWS est prévenue et intervient

parmi : operation_in_progress, suspended, support_notified
maintenance object

server_maintenance : nature de l'intervention, début et fin prévue (null pour un incident)
kind string

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

429

Quota dépassé : rate_limited — quota horaire de la famille épuisé.

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

Champs de la réponse 18

type string (uri)

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

requis
title string

Titre court

Exemple: VPS introuvable

requis
status integer (int64)

Statut HTTP

Exemple: 404

requis
code string

Code machine stable (voir « Erreurs » dans Pour commencer)

Exemple: vm_not_found

requis
detail string

Message détaillé

Exemple: Aucun VPS 999999 sur ce compte.

requis
request_id string

Identifiant de la requête, à communiquer au support

Exemple: 3f9a1c07b2e45d18

requis
errors object

validation_failed : message par paramètre fautif
required_level string

insufficient_scope : niveau exigé par l'opération

parmi : read, exploitation, full
task_id string

task_already_running : tâche en cours sur ce VPS

Exemple: tsk_000002d5
family string

rate_limited : famille de quota épuisée

parmi : read, mutation, heavy
limit integer (int64)

rate_limited : plafond horaire de la famille
retry_after integer (int64)

rate_limited : secondes à attendre
lock string

server_locked : verrou posé par l'hyperviseur (backup, snapshot, suspended…)

Exemple: snapshot
reason string

server_locked : operation_in_progress, une opération est en cours, réessayez après Retry-After ; suspended, le VPS hiberne, démarrez-le d'abord ; support_notified, verrou anormal, l'équipe LWS est prévenue et intervient

parmi : operation_in_progress, suspended, support_notified
maintenance object

server_maintenance : nature de l'intervention, début et fin prévue (null pour un incident)
kind string

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

502

Dépendance injoignable : upstream_unavailable — inventaire des VPS momentanément indisponible.

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

Champs de la réponse 18

type string (uri)

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

requis
title string

Titre court

Exemple: VPS introuvable

requis
status integer (int64)

Statut HTTP

Exemple: 404

requis
code string

Code machine stable (voir « Erreurs » dans Pour commencer)

Exemple: vm_not_found

requis
detail string

Message détaillé

Exemple: Aucun VPS 999999 sur ce compte.

requis
request_id string

Identifiant de la requête, à communiquer au support

Exemple: 3f9a1c07b2e45d18

requis
errors object

validation_failed : message par paramètre fautif
required_level string

insufficient_scope : niveau exigé par l'opération

parmi : read, exploitation, full
task_id string

task_already_running : tâche en cours sur ce VPS

Exemple: tsk_000002d5
family string

rate_limited : famille de quota épuisée

parmi : read, mutation, heavy
limit integer (int64)

rate_limited : plafond horaire de la famille
retry_after integer (int64)

rate_limited : secondes à attendre
lock string

server_locked : verrou posé par l'hyperviseur (backup, snapshot, suspended…)

Exemple: snapshot
reason string

server_locked : operation_in_progress, une opération est en cours, réessayez après Retry-After ; suspended, le VPS hiberne, démarrez-le d'abord ; support_notified, verrou anormal, l'équipe LWS est prévenue et intervient

parmi : operation_in_progress, suspended, support_notified
maintenance object

server_maintenance : nature de l'intervention, début et fin prévue (null pour un incident)
kind string

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

Paramètres du chemin

Réponses

Signaler une erreur

Assistant IA