Skip to content

刪除雲端備份 ​

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