oc checkpoint

Alias: oc cp

Ask AI about this page

`oc checkpoint create <sandbox-id>`

Create a named checkpoint of a running sandbox. HTTP API →

query --namestringrequired

Checkpoint name

query --retention-policystringdefault: none

Optional retention policy. Use delete_oldest to delete the oldest eligible checkpoint before creating this one.

query --retention-max-countintdefault: 10

Maximum checkpoints of this type to keep when --retention-policy delete_oldest is set. Must be between 1 and 10 for full checkpoints, or 1 and 100 for disk-only checkpoints.

bash

1oc cp create sb-abc --name before-migration

bash

12345oc cp create sb-abc \
  --name autosave \
  --kind disk_only \
  --retention-policy delete_oldest \
  --retention-max-count 100

`oc checkpoint list <sandbox-id>`

List checkpoints for a sandbox. HTTP API →

Output columns: ID, NAME, STATUS, SIZE, CREATED

`oc checkpoint restore <sandbox-id> <checkpoint-id>`

Revert a sandbox in-place to a checkpoint. All changes since the checkpoint are lost. HTTP API →

`oc checkpoint spawn <checkpoint-id>`

Create a new sandbox from a checkpoint (fork). HTTP API →

query --timeoutintdefault: 300

Idle timeout for the new sandbox

bash

12ID=$(oc cp spawn cp-xyz --json | jq -r '.sandboxID')
oc exec "$ID" --wait -- echo "forked sandbox ready"

`oc checkpoint delete <sandbox-id> <checkpoint-id>`

Delete a checkpoint. HTTP API →