ovahub스냅샷 관리
/api/v1/servers/:id/snapshots/action
소속 조직 서버의 스냅샷을 생성, 이름 변경, 삭제 또는 복원합니다. 응답은 스냅샷 자체가 아닌 작업을 설명합니다.
호출 전 확인
삭제와 복원에는 confirm=true가 필요합니다. 복원하면 서버 데이터가 교체됩니다. 같은 requestKey는 원래 작업을 반환합니다. 무작정 재시도하지 말고 해당 taskKey로 조회하세요.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/snapshots/action" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"action": "create",
"requestKey": "docs_example_001",
"name": "before-update"
}'예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
매개변수
id경로 · 필수string
리소스 ID로, 24자리 16진수 문자열입니다. 공급업체 인스턴스 ID가 아니라 해당 목록 엔드포인트에서 반환한 플랫폼 ID를 사용하세요.
actionJSON 본문 · 필수"create" | "update" | "delete" | "restore"
스냅샷 작업입니다.
requestKeyJSON 본문 · 필수string
8–100자이며 A–Z, a–z, 0–9, 밑줄 또는 하이픈만 허용합니다. 같은 작업을 재시도할 때는 동일한 키와 동일한 입력값을 유지하세요.
snapshotIdJSON 본문 · 선택string
공급업체 스냅샷 ID로, 1–80자입니다. update, delete, restore에 필수입니다.
nameJSON 본문 · 선택string
앞뒤 공백을 제거한 이름으로, 1–30자입니다. create와 update에 필수입니다.
descriptionJSON 본문 · 선택string
앞뒤 공백을 제거한 설명으로, 최대 255자입니다.
confirmJSON 본문 · 선택boolean
영향을 검토한 뒤에만 true로 설정합니다. stop(강제 전원 차단), terminate, reinstall, changepass 및 스냅샷 삭제·복원에 필요합니다.
응답
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플랫폼 측 완료 시각이며, 있는 경우에만 제공됩니다.