Bootstrap & Snapshots
Read snapshot
Read the latest snapshot or a snapshot at a specific offset.
GET
Latest snapshot
GET /ds/{bucket}/{stream}/snapshot redirects to the latest published snapshot’s offset-specific URL.
Bucket ID.
Stream ID.
| Status | Meaning |
|---|---|
307 | Redirect to /ds/{bucket}/{stream}/snapshot/{offset}. |
404 | Stream not found, expired, or no snapshot has been published. |
Location, Stream-Next-Offset, Stream-Snapshot-Offset, and Stream-Up-To-Date.
Snapshot at offset
GET /ds/{bucket}/{stream}/snapshot/{offset} returns the snapshot blob at a specific offset.
Snapshot offset (hex or decimal token).
| Status | Meaning |
|---|---|
200 | Snapshot blob returned. |
404 | Stream, snapshot, or offset not found. |
Content-Type, Stream-Next-Offset, Stream-Snapshot-Offset, Stream-Up-To-Date, and Stream-Closed.
Snapshot reads go through a linearizable freshness check to ensure you see the latest published snapshot. If the snapshot blob hasn’t replicated to the current node yet, the request may be redirected to the leader.
See snapshots for the snapshot lifecycle.