Read workspace statistics

GET/api/box/v1/{boxId}/workspace/stats

Requires an active, authorized Box and a completed restore. Sandbox requires an explicitly started running lease; file access never allocates or wakes a VM. Paths are canonical under /workspace; symbolic links are rejected. Workspace capacity is 256 MiB; writes are limited to 16 MiB per request.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: fileRead

参数

boxId · path · 必填

Existing Box resource ID selected in Console, not its parent product activation ID.

path · query · 必填

Required canonical directory path; explicitly send /workspace for the root.

响应

200

Directory descendant counts and runtime-declared capacity.

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.