删除云端备份
删除某个环境在云端的备份。会一并清理三样东西:环境包、账号密码信封、云 ID 登记。删除后该环境无法再从云端恢复,本地环境不受影响。
接口定义:POST · 核对日期:2026-11-19。
请求
http
POST /api/deleteCloudBackup
api-key: REPLACE_WITH_LOCAL_API_KEY从客户端 API 页面复制实际本地服务地址和 api-key;API 端口动态分配,不是浏览器 CDP 端口。参见概述与鉴权。
JSON 请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 否 | 环境 ID,与 cloudId 二选一;传了 id 时自动取该环境的 cloudId |
cloudId | string | 否 | 云端环境 ID,与 id 二选一;本地环境已删除时用它直接清理云端残留 |
provider | string | 否 | oss 或 webdav;默认取环境配置的提供方 |
webdav | object | 否 | WebDAV 连接配置;不传则使用环境里已保存的配置 |
webdav.url | string | 否 | WebDAV 地址 |
webdav.username | string | 否 | WebDAV 账号 |
webdav.password | string | 否 | WebDAV 密码 |
webdav.baseDir | string | 否 | 基础目录,如 / |
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.cloudId | string | 被清理的云端环境 ID |
data.provider | string | 实际使用的存储提供方 |
data.id | integer | 关联的本地环境 ID;按 cloudId 清理且本地无对应环境时可能为 0 |



