File-level restore

Browsing a backup's files without restoring it. A session gives a read-only view of one backup's disks: it finds and mounts their filesystems, lists directories and downloads single files, and ends at its deadline, after being left idle, or when it is closed. To bring back whole disks or servers, use Restores or Attachments instead. Errors raised while reading the filesystem itself, such as a path that does not exist or a directory given to download, keep their HTTP status but carry a body of the form {"error": {"code": 404, "message": "..."}} rather than a problem document.

📄️ List open browse sessions

Any reader of the project the token is scoped to.

📄️ Browse a backup's files

Opens a read-only session over a backup's disks, without restoring it. The answer lists the filesystems found on them, and the operating system is found and mounted straight away when there is one. ext4, XFS, NTFS and LVM volumes can be read. The session ends at its deadline, or sooner when left idle.

📄️ Close a browse session

Any reader of the project the token is scoped to.

📄️ Show a browse session

The filesystems found on the backup, which of them are mounted and where, any LVM volumes, and when the session ends.

📄️ Download a file

Streams one file. A `Range` header, or `offset` and `length`, fetch part of it, so an interrupted download can resume where it stopped.

📄️ Mount a filesystem

Mounts the filesystem on `device` at `mount_point`, `/` when left out. With `inspect`, finds and mounts the operating system instead. Answers with everything now mounted.

📄️ Show a file's details

Any reader of the project the token is scoped to.

📄️ List a directory

Answers the directory's `path` and its `entries`, each shaped like the answer of GET /v1/flr-sessions/{id}/stat.