문서 본문으로 이동
문서API 참조스냅샷 목록 조회
GETBearer 토큰

스냅샷 목록 조회

/api/v1/servers/:id/snapshots

서버 스냅샷과 개수 제한을 조회합니다. 목록에 표시되어도 공급업체에서 복원할 준비가 되었다는 뜻은 아닙니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/snapshots" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

매개변수

id경로 · 필수

string

리소스 ID로, 24자리 16진수 문자열입니다. 공급업체 인스턴스 ID가 아니라 해당 목록 엔드포인트에서 반환한 플랫폼 ID를 사용하세요.

응답

HTTP 상태 200

소유한 서버의 스냅샷 한도와 현재 표시되는 스냅샷을 조회합니다.

limitnumber

요금제의 스냅샷 한도입니다.

snapshotsarray

현재 공급업체에서 반환한 스냅샷 기록 또는 미리보기 데이터입니다.

snapshots[].idstring

스냅샷 식별자입니다.

snapshots[].namestring

스냅샷 이름입니다.

snapshots[].instanceIdstring

공급업체 인스턴스 식별자입니다.

snapshots[].descriptionstring | null (optional)

스냅샷 설명입니다.

snapshots[].createdAtstring (optional)

공급업체가 제공한 생성 날짜 값이며, 있는 경우에만 제공됩니다.

snapshots[].autoDeleteAtstring (optional)

공급업체가 제공한 자동 삭제 날짜이며, 있는 경우에만 제공됩니다.

snapshots[].imageIdstring (optional)

공급업체가 제공한 이미지 식별자이며, 있는 경우에만 제공됩니다.

snapshots[].imageNamestring (optional)

공급업체가 제공한 이미지 이름이며, 있는 경우에만 제공됩니다.

simulatedboolean (true, optional)

격리된 테스트 리소스에 포함되며, 해당 스냅샷 목록은 비어 있습니다.