Create a snapshot

Create a snapshot from a Docker image (async build).

POST /v2/sandboxes/snapshots

Error

A valid request URL is required to generate request examples

201

{
  "created_at": "<string>",
  "created_by": "<string>",
  "docker_image": "<string>",
  "fs_capacity_bytes": 123,
  "fs_used_bytes": 123,
  "id": "<string>",
  "image_digest": "<string>",
  "memory_snapshot_size_bytes": 123,
  "name": "<string>",
  "registry_id": "<string>",
  "source_sandbox_id": "<string>",
  "status": "<string>",
  "status_message": "<string>",
  "updated_at": "<string>"
}

{
  "detail": {
    "error": "<string>",
    "error_id": "<string>",
    "message": "<string>"
  }
}

{
  "detail": {
    "error": "<string>",
    "error_id": "<string>",
    "message": "<string>"
  }
}

{
  "detail": {
    "error": "<string>",
    "error_id": "<string>",
    "message": "<string>"
  }
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Body

application/json

docker_image · string · required

fs_capacity_bytes · integer · required

name · string · required

registry_id · string

Response

201

application/json

Created

created_at · string

created_by · string

docker_image · string

fs_capacity_bytes · integer

fs_used_bytes · integer

id · string

image_digest · string

memory_snapshot_size_bytes · integer

MemorySnapshotSizeBytes is non-nil iff the snapshot was captured with VM memory state. A non-nil value is the canonical signal that this snapshot can warm-restore from memory; nil means rootfs only.

name · string

registry_id · string

source_sandbox_id · string

status · string

status_message · string

updated_at · string