Restablecer el DNS inverso por defecto
DELETE
/api/v1/
operationIddeleteReverseDns
- Nivel requerido
- Explotación
- Cuota
- mutación, 300 llamadas por hora
Restablece el DNS inverso asignado en la entrega del VPS, por ejemplo vps116807.serveur-vps.net para el VPS 116807. Una dirección siempre tiene un DNS inverso: la respuesta contiene el nombre restablecido.
Parámetros de ruta
-
vmidstring obligatorio -
Identificador del VPS. Debe pertenecer a la cuenta y al alcance de la clave.
-
ipstring obligatorio -
Dirección IPv4 o IPv6, que debe pertenecer al VPS.
Respuestas
200
DNS inverso restablecido
{
"data": {
"address": "31.207.34.214",
"reverse": "vps116807.serveur-vps.net"
}
}
Campos de la respuesta 3
-
dataobjectobligatorio -
addressstring -
reversestringNombre registrado, en minúsculas
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.
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
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
403
Acceso denegado: insufficient_scope — nivel de la clave insuficiente; ip_not_allowed — dirección de origen no autorizada.
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
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
404
Recurso no encontrado: vm_not_found — VPS fuera del alcance, o dirección que no pertenece a este VPS.
vm_not_found — VPS fuera del alcance, o dirección que no pertenece a este VPS.{
"type": "https://docs.lws.fr/kvm/errors/vm-not-found",
"title": "VPS introuvable",
"status": 404,
"code": "vm_not_found",
"detail": "L'adresse 51.83.12.1 n'appartient pas au VPS 116807.",
"request_id": "3f9a1c07b2e45d18"
}
Campos de la respuesta 18
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
409
Conflicto con el estado actual: service_suspended — VPS desactivado o caducado: solo siguen siendo posibles las lecturas.
service_suspended — VPS desactivado o caducado: solo siguen siendo posibles las lecturas.{
"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"
}
Campos de la respuesta 18
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
429
Cuota superada: rate_limited — cuota por hora de la familia agotada.
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
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
502
Dependencia inaccesible: upstream_unavailable — imposible registrar el DNS inverso, o inventario de VPS momentáneamente no disponible.
upstream_unavailable — imposible registrar el DNS inverso, o inventario de VPS momentáneamente no disponible.{
"type": "https://docs.lws.fr/kvm/errors/upstream-unavailable",
"title": "Service momentanément indisponible",
"status": 502,
"code": "upstream_unavailable",
"detail": "Le reverse DNS n'a pas pu être enregistré. Réessayez dans quelques instants.",
"request_id": "3f9a1c07b2e45d18"
}
Campos de la respuesta 18
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)
503
Servidor anfitrión en intervención: server_maintenance — servidor anfitrión en una intervención anunciada por LWS e inaccesible; respete Retry-After.
server_maintenance — servidor anfitrión en una intervención anunciada por LWS e inaccesible; respete 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"
}
}
Campos de la respuesta 18
-
typestring (uri)obligatorio -
titlestringobligatorioTítulo breve
-
statusinteger (int64)obligatorioEstado HTTP
-
codestringobligatorioCódigo de máquina estable (véase «Errores» en Primeros pasos)
-
detailstringobligatorioMensaje detallado
-
request_idstringobligatorioIdentificador de la petición, que debe facilitarse al soporte
-
errorsobjectvalidation_failed: mensaje por parámetro erróneo -
required_levelstringinsufficient_scope: nivel exigido por la operación -
task_idstringtask_already_running: tarea en curso en este VPS -
familystringrate_limited: familia de cuota agotada -
limitinteger (int64)rate_limited: límite por hora de la familia -
retry_afterinteger (int64)rate_limited: segundos de espera -
lockstringserver_locked: bloqueo establecido por el hipervisor (backup,snapshot,suspended…) -
reasonstringserver_locked:operation_in_progress, hay una operación en curso, vuelva a intentarlo trasRetry-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 -
maintenanceobjectserver_maintenance: naturaleza de la intervención, inicio y fin previsto (nullpara una incidencia) -
kindstring -
started_atstring (date-time) -
expected_endstring (date-time)