停止应用
停止运行中的应用(POST /v2/apps//stop),保留其文件、变量和配置。应用已停止时返回 409。
POST
停止应用
需要具有
apps:control 权限范围的 API 密钥。
关闭一个正在运行的应用,但不会删除它:容器会停止,但应用的文件、环境变量和配置会被保留,因此可以随时通过启动应用重新启动它。如果应用已经处于停止状态,请求会返回 409 CONTAINER_ALREADY_STOPPED,而不是不做任何操作。
当你想暂时释放应用的资源时,应使用此端点,例如在非工作时间暂停一个后台 worker,而又不像删除应用那样放弃应用名额。在工作区共享的应用上,调用者需要具备 manager、maintain 或 admin 角色。
该请求的速率限制为每个应用每 3 秒 1 次停止,以及每个用户跨所有应用每 15 秒 20 次生命周期操作,超出该上限后会被短暂封锁。如果该应用正在进行 snapshot 恢复(最长约 2 分钟),该请求也会以 403 RESTORE_IN_PROGRESS 被拒绝:请等待恢复完成后重试。
参数
string
必填
应用的 ID。你可以在应用控制面板的 URL 中找到它。
响应
string
指示调用是否成功。成功时为
success,否则为 error。常见错误
相关内容
- CLI:
squarecloud app stop - SDK:
api.apps.stop()(JavaScript)、client.apps.stop()(Python)、c.Apps.Stop()(Go)

