Skip to main content
示例使用创建客户端中的 api 客户端。appId 是你的某个应用的 ID:api.account.me() 会列出它们。

接受的输入

apps.create() 和 apps.commit() 接受: 在边缘运行时和浏览器中,请传入 Blob、File 或 Uint8Array:路径仅在存在 node:fs 的环境中可用。 上传限制为 100 MB。更大的文件会在发送任何内容之前于本地以 FILE_TOO_LARGE(状态 0)失败。上传采用流式传输且没有超时:传入 signal 即可取消上传。

创建应用

apps.create(file) 会 deploy 一个根目录包含 squarecloud.app 配置文件的 .zip。

向应用提交 commit

apps.commit(appId, file, { path, filename, signal }) 将文件上传到现有应用中:
  • .zip 会在 path(默认为应用根目录)处被解压。
  • 其他任何文件会放置在 path/<filename>。
文件名取 filename,否则取文件自身的名称(路径或 File),否则为 commit.zip。
commit 不会重启应用。调用 apps.restart() 以使其生效。

取消上传

被中止的上传会以该 signal 的 reason 拒绝。

错误

无法打开的本地路径会抛出文件系统错误,而不是 SquareCloudAPIError。完整列表请参见错误。

后续步骤

管理文件

列出、读取、写入、移动和删除应用文件。

上传 API 参考

这些方法背后的 REST 端点。

用 CLI 上传

在终端中完成同样的操作。