snapshots

Your org's volume snapshots (paged)

List your org's snapshots with their source node, state, size, image and any expiry. A ready snapshot preserves the captured disk after its source machine stops or fails. triggered_by tells who took each snapshot. It is customer for a snapshot your org took, and system for one the platform took to keep a copy of a parked disk. A system snapshot does not bill storage. Failed uploads remain visible, and the platform retries while the source disk stays parked. Snapshots expire only when you set an expiry. A snapshot's region identifies its storage location; downloads across regions can take longer. A snapshot that shows a region is stored on one storage cluster in one datacenter. A snapshot without a region is in central storage, which keeps copies in several availability zones. Direct restores require a compatible node type and image.

get/preview/snapshots

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/snapshots
  • Auth: HTTP bearer

Query parameters

cursorstring

Opaque page cursor: the next_cursor a previous response returned. Omit for the first page.

limitinteger

Rows per page. Clamped to the range shown.

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Response

The capability's JSON result.

next_cursorstring

Pass as ?cursor= for the next page. Absent on the last page. Opaque: never parse it.

object'list' required

Changes

No recorded changes to this operation across all 1 revision of this API.