List snapshot directory

GET/api/box/v1/{boxId}/backups/{backupId}/files

Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Lists direct children from an immutable manifest, sorted by path.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: fileRead

参数

boxId · path · 必填: Existing Box resource ID selected in Console, not its parent product activation ID.
backupId · path · 必填: Existing backupId in this Box.
path · query · 可选: Directory in this snapshot.
limit · query · 可选: Maximum entries.
cursor · query · 可选: Unmodified nextCursor: an offset in the immutable directory listing.

响应

200: Snapshot directory page.
400: Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.
401: Missing, invalid, expired or revoked organization credential.
403: Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.
404: Resource, execution, snapshot, restore or file not found within the authorized organization.
409: State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.
500: The request could not be completed. Preserve any durable identity before retrying.
503: Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.

正在加载 API 参考文档…

Box · 接入与鉴权

基础 URLhttps://sinecloud.dev/api/box/v1/{boxId}

打开控制台 · 创建 API 密钥 · 查看所有 API

下载 API 索引

首次调用前

在控制台选择组织、准备资源，并创建具有所需产品权限范围的组织 API Key。每次调用都会检查当前权限、资源访问权限、预算和可用资金。

在控制台创建并选择 Box，将 boxId 替换为实际 Box 资源 ID，不能使用父级激活记录 ID。接口目录涵盖工作区文件、目录、命令执行、持久化状态、Sandbox 运行窗口和保留备份。Lite 命令无需启动虚拟机；Sandbox 命令需要已明确确认并预留资金的运行窗口，虚拟机空闲分配时间也会计费。文件访问不会启动虚拟机。

按各接口要求授予 boxRun、fileRead 或 fileWrite 等权限。创建备份同时需要 boxRun 与 fileRead。资源创建、发起恢复和删除备份使用控制台会话。恢复结果不明确的任务时，请保留原始执行标识。

组织密钥鉴权与基础 URL

产品 API 的生产源地址是 https://sinecloud.dev，不是文档站点。路径前缀为 /api/box/v1/{boxId}。请使用接口注明的完整路径，并将资源 ID、模型与端点版本替换为实际值。

Authorization: Bearer $SINECLOUD_API_KEY

将 SINECLOUD_API_KEY 设置为你自己的环境变量值，切勿使用平台服务凭据。各接口的 x-sinecloud-scopes 会注明所需的权限范围。

此文档为只读参考，请在控制台或自己的客户端中发起请求。浏览文档不会创建密钥、启动执行或产生执行费用。请保留请求 ID 和执行回执；连接中断不会取消任务，再次提交前请按接口说明恢复并确认状态。