squarecloud blob 用于管理你的 Blob Storage 中的文件。文件通过其 ID 来标识,blob list 和 blob upload 会打印该 ID。
这些命令需要具有 blob:read 和 blob:write scope 的 API 密钥。浏览器登录会同时申请这两个 scope。3.2.0 版本之前通过浏览器登录获得的密钥缺少它们:此时第一个 Blob 命令会请你再次运行 squarecloud auth login。SQUARECLOUD_API_KEY 中的密钥同样需要这两个 scope。
squarecloud blob list
用法
prefix 下的文件。私有文件会显示 (private),而不是 URL。
--json 时,它会以 JSON 数组的形式打印这些文件。
squarecloud blob upload
用法
上传一个文件,并打印它的 ID 和 URL。服务会保留文件的扩展名。在默认名称中,服务不接受的字符会被替换为
_。要发送文件夹,请先用 squarecloud zip 把它压缩。
输出
- 大文件: 超过 90 MiB 的文件会分片上传,每次 6 个分片,分片大小根据服务返回的限制确定。进度输出到 stderr,因此 stdout 只包含结果。
- 失败: 失败或被取消(
Ctrl+C)的上传会被中止,因此不会占用你的未完成上传名额。只有读取和分片会被重试,速率限制永远不会重试。 - 私有文件: CLI 不会显示 URL,而是显示生成临时链接的命令
blob url。
--json 时,stdout 只以 JSON 格式输出已保存的文件(ID、可见性、URL 和大小,分片上传时还包括分片数量)。
squarecloud blob url
用法
$(...) 中。对于临时链接,CLI 会在 stderr 上说明它的有效期限。
--json 时,它会打印链接及其过期时间、可见性、大小和内容类型。
squarecloud blob delete
用法
删除前会询问
Delete <ID> for good? There is no trash [y/N]。delete 没有 JSON 输出。
squarecloud blob stats
用法
输出
--json 时,它会以 JSON 格式打印完整的用量记录。
相关内容
要在你自己的代码中使用 Blob Storage,请从 Blob SDK 开始。

