刪除雲端備份
刪除某個環境在雲端的備份。會一併清理三樣東西:環境包、帳號密碼信封、雲 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 |



