VPS Snapshots

Get snapshot

get/snapshots/{snapshot_uuid}

View a snapshot: its status, disk size, monthly cost and the estimated time to deploy it in each location.

Authorization

Authorization
Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Path parameters

snapshot_uuid*string

Responses

Successful Response

application/json

uuid*string
origin*string

vps (taken from the server) or backup (converted from a backup)

name*string
description?string | null
status*string

pending, converting, available, failed or deleting

healthy?boolean

False when the stored copy failed a health check: the snapshot can not be deployed

Defaulttrue
os_type?string | null

linux or windows, known once the conversion has run

disk_gb?integer | null
estimated_gb*integer
billable_gb?number | null

GB stored and billed: compressed size rounded up to 0.01 GB, at least 1 GB and never above the disk. Null until the snapshot is available

location?SnapshotLocationOut | null
Properties (2)
name*string
description?string | null
store_location?SnapshotLocationOut | null
Properties (2)
name*string
description?string | null
project_id?integer | null
source_vps*SnapshotSourceVPSOut
Properties (3)
id?integer | null
name?string | null
deleted*boolean
template*SnapshotTemplateOut
Properties (4)
template_name?string | null
name?string | null
operating_system?string | null
min_ram?integer | null

Minimum plan RAM in MB of the source image, null without one

price_gb_month*number

USD per GB stored per month

monthly_cost*number
hourly_cost*number
max_monthly_cost*number

Monthly cost if the copy took the whole disk; the real cost is usually lower

deploying_count*integer
created_at?string | null
available_at?string | null
deploy_estimates?array<SnapshotDeployEstimateOut>
Properties (3)
location_name*string
remote*boolean
minutes*integer