ovahub스냅샷 요청 후처리
/api/v1/servers/:id/snapshots/recover
현재 조직에서 원래 구성원이 보낸 스냅샷 요청을 다시 확인합니다. 저장된 접수 기록에 따른 로컬 후처리만 마치고 원래 작업 상태를 반환합니다.
호출 전 확인
원래 action과 requestKey를 사용하세요. 새 요청을 만들거나 공급업체를 호출하지 않습니다. 로컬 후처리에는 succeeded 기록, 유효한 finishedAt, 저장된 응답 객체가 필요하며 공급업체 작업 ID가 없어야 합니다. 원래 기록이 없으면 409를 반환하고 불완전한 증거를 성공으로 바꾸지 않습니다. pending과 taskStatus도 확인하세요. state=succeeded만으로는 공급업체의 완료가 확인되지 않습니다. 작업 GET은 읽기 전용입니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
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>"
}'예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
{
"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"
}매개변수
id경로 · 필수string
리소스 ID로, 24자리 16진수 문자열입니다. 공급업체 인스턴스 ID가 아니라 해당 목록 엔드포인트에서 반환한 플랫폼 ID를 사용하세요.
actionJSON 본문 · 필수"create" | "update" | "delete" | "restore"
원래 스냅샷 작업입니다. 기존 snapshot_action 요청과 동일한 action을 사용하세요. 이 엔드포인트는 새 작업을 시작하지 않습니다.
requestKeyJSON 본문 · 필수string
원래 snapshot_action의 requestKey입니다. 8–100자로 A–Z, a–z, 0–9, 밑줄 또는 하이픈을 사용할 수 있습니다. 복구를 위해 새 키를 만들지 마세요.
응답
HTTP 상태 200 / 202
저장된 로컬 후처리 상태를 확인한 후 원래 스냅샷 작업을 반환합니다. 공급업체를 호출하거나 새 요청을 만들지 않습니다.
taskKeystring플랫폼 작업의 고정 키입니다.
actionstring기록된 작업 이름입니다.
statestring ('started' | 'succeeded' | 'failed')플랫폼 측 작업 상태로, 공급업체 작업 상태와 다릅니다.
pendingbooleantrue이면 HTTP 상태는 202이고, 그렇지 않으면 200입니다.
localFinishPendingboolean스냅샷 요청이 succeeded이고 저장된 응답과 유효한 완료 시각이 있으며 공급업체 작업 ID가 없고 로컬 접수 후처리가 남아 있으면 true입니다. 원래 action과 requestKey로 recover_snapshot을 호출하세요. 작업 GET은 읽기 전용입니다.
taskIdstring | null공급업체 작업 식별자이며, 있는 경우에만 제공됩니다.
taskStatusstring | null마지막으로 관측된 공급업체 작업 상태입니다.
errorstring | null민감한 정보를 제거한 기록 오류이며, 있는 경우에만 제공됩니다.
createdAtstring (ISO 8601)플랫폼 측 작업 생성 시각입니다.
finishedAtstring (ISO 8601) | null플랫폼 측 완료 시각이며, 있는 경우에만 제공됩니다.
actorUserIdstring (ObjectId) | null원래 작업자의 계정 ID이며 불완전한 기록은 null입니다. 현재 독자는 동일한 고정 팀의 활성 구성원이어야 합니다.