跳转到内容

删除云端备份 ​

删除某个环境在云端的备份。会一并清理三样东西:环境包、账号密码信封、云 ID 登记。删除后该环境无法再从云端恢复,本地环境不受影响。

接口定义:POST · 核对日期:2026-11-19。

请求 ​

http
POST /api/deleteCloudBackup
api-key: REPLACE_WITH_LOCAL_API_KEY

从客户端 API 页面复制实际本地服务地址和 api-key;API 端口动态分配,不是浏览器 CDP 端口。参见概述与鉴权。

JSON 请求体 ​

参数类型必填说明
idinteger否环境 ID,与 cloudId 二选一;传了 id 时自动取该环境的 cloudId
cloudIdstring否云端环境 ID,与 id 二选一;本地环境已删除时用它直接清理云端残留
providerstring否oss 或 webdav;默认取环境配置的提供方
webdavobject否WebDAV 连接配置;不传则使用环境里已保存的配置
webdav.urlstring否WebDAV 地址
webdav.usernamestring否WebDAV 账号
webdav.passwordstring否WebDAV 密码
webdav.baseDirstring否基础目录,如 /

id 与 cloudId 至少提供一个。只清理 OSS 备份时无需传 webdav。

cURL ​

bash
BASE_URL='http://127.0.0.1:REPLACE_WITH_API_PORT'
API_KEY='REPLACE_WITH_LOCAL_API_KEY'
curl --request POST "${BASE_URL}/api/deleteCloudBackup" \
  --header "api-key: ${API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "provider": "oss"
}'

按 cloudId 清理(本地环境已不存在时):

bash
curl --request POST "${BASE_URL}/api/deleteCloudBackup" \
  --header "api-key: ${API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "provider": "oss"
}'

响应示例 ​

json
{
  "success": true,
  "data": {
    "cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "provider": "oss",
    "id": 1
  }
}
字段类型说明
data.cloudIdstring被清理的云端环境 ID
data.providerstring实际使用的存储提供方
data.idinteger关联的本地环境 ID;按 cloudId 清理且本地无对应环境时可能为 0

说明 ​

  • 这是不可恢复操作。只想停止后续上传、保留已有备份时,用设置云同步开关传 enable: false。
  • 删除只影响云端,本地环境与其数据目录不会被动到。要删除本地环境,用删除环境。
  • 未登录或会员过期返回 HTTP 403;id 与 cloudId 都不传返回 HTTP 400。
  • 删除前可以先调列出云端备份确认 cloudId。