ovahubRecuperar una solicitud de instantánea
/api/v1/servers/:id/snapshots/recover
Recupera la solicitud de instantánea del miembro que la inició en la organización actual. Solo completa el cierre local a partir de la aceptación guardada y devuelve el estado de la tarea original.
Antes de llamar
Usa los valores originales de action y requestKey. No crea solicitudes ni llama al proveedor. El cierre local requiere un registro succeeded, un finishedAt válido, un objeto de respuesta guardado y ningún ID de tarea del proveedor. Si falta el registro original, devuelve 409; las pruebas incompletas no se convierten en éxito. Revisa pending y taskStatus: state=succeeded por sí solo no demuestra que el proveedor haya terminado. El GET de la tarea sigue siendo de solo lectura.
Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.
Ejemplo de petición
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/snapshots/recover" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"action": "create",
"requestKey": "<ORIGINAL_REQUEST_KEY>"
}'Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"taskKey": "server:507f1f77bcf86cd799439012:snapshot_create:original_request_001",
"action": "snapshot_create",
"state": "succeeded",
"pending": false,
"localFinishPending": false,
"taskId": null,
"taskStatus": null,
"error": null,
"createdAt": "2026-11-07T12:00:00.000Z",
"finishedAt": "2026-11-07T12:00:01.000Z",
"actorUserId": "507f1f77bcf86cd799439013"
}Parámetros
idRuta · Obligatoriostring
ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.
actionCuerpo JSON · Obligatorio"create" | "update" | "delete" | "restore"
La acción de instantánea original. Usa la misma action que en la solicitud snapshot_action existente; este endpoint no inicia una acción nueva.
requestKeyCuerpo JSON · Obligatoriostring
El requestKey original de snapshot_action, de 8–100 caracteres: A–Z, a–z, 0–9, guion bajo o guion. No generes una clave nueva para recuperar la solicitud.
Respuesta
Estado HTTP 200 / 202
Devuelve la tarea de instantánea original tras comprobar el cierre local guardado. No llama al proveedor ni crea una solicitud nueva.
taskKeystringClave estable de la operación en la plataforma.
actionstringNombre de la acción registrada.
statestring ('started' | 'succeeded' | 'failed')Estado de la operación en la plataforma, distinto del estado de la tarea del proveedor.
pendingbooleanEl estado HTTP es 202 si es true; de lo contrario, 200.
localFinishPendingbooleanEs true si la solicitud de instantánea está en succeeded, tiene una respuesta guardada y una fecha de finalización válida, no tiene ID de tarea del proveedor y falta completar el cierre local de la aceptación. Usa recover_snapshot con los valores originales de action y requestKey; el GET de la tarea sigue siendo de solo lectura.
taskIdstring | nullIdentificador de la tarea del proveedor, si existe.
taskStatusstring | nullÚltimo estado observado de la tarea del proveedor.
errorstring | nullError registrado sin datos sensibles, si existe.
createdAtstring (ISO 8601)Fecha y hora de creación de la operación en la plataforma.
finishedAtstring (ISO 8601) | nullFecha y hora de finalización en la plataforma, si existen.
actorUserIdstring (ObjectId) | nullID de la cuenta del autor original, o null si falta en el historial. El lector debe ser miembro activo del mismo equipo fijo.