Export snapshot as a tar archive

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

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. Streams the retained verified snapshot as a tar attachment, not a live workspace archive.

组织 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.

响应

200

Snapshot tar archive.

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.