Skip to main content
PUT
创建/修改文件
string
必填
你账户的 API 密钥。你可以在账户设置中找到它。
创建/修改文件会将 content 写入应用内正在运行的 path,如果文件不存在则创建它,存在则覆盖它。content 既可以是文本文件的 UTF-8 字符串,也可以是用于二进制内容的 { type: "Buffer", data: number[] } 字节数组。可用它进行小范围、有针对性的编辑,例如调整某个配置值或放入一个生成的文件,而无需重新上传整个应用;如需批量更改或上传 .zip,请改用提交应用 写入 squarecloud.appsquarecloud.config 会被特殊处理:平台会将其解析为应用的配置(显示名称、描述、内存、autorestart、子域名)并校验每个字段,非法值会返回具体的错误代码(例如 INVALID_MEMORYINVALID_SUBDOMAIN),而不会写入文件。这类配置重写的速率限制为每个用户每 15 秒 1 次请求。 在工作区共享的应用上,调用者需要具有 Maintainer 或 Administrator 角色,没有受限文件权限的成员会被阻止写入 .env 等排除路径。与其他文件管理器路由一样,此操作不会重启应用,需要新进程才能生效的更改请调用重启应用

参数

string
必填
应用的 ID。你可以在应用控制面板的 URL 中找到它。
string
必填
文件应被创建的路径。示例:/test.txt
string
必填
待创建文件的内容。

响应

string
指示调用是否成功。成功时为 success,否则为 error

常见错误