備份管理 | 鑽石託管 DiamondHost

BASE URLhttps://panel.diamondhost.tw/api/client/servers/{server}/backups

GET/

列出備份

回傳所有備份的狀態、大小、校驗值與建立時間。

程式範例cURL / Node.js / Python

curl -X GET "${BASE_URL}/" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"

POST/

建立備份

建立新的伺服器備份，可指定名稱與忽略路徑。

REQUEST BODY

{
  "name": "Before update",
  "ignored": "cache\nlogs",
  "is_locked": false
}

程式範例cURL / Node.js / Python

curl -X POST "${BASE_URL}/" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Before update",
  "ignored": "cache\nlogs",
  "is_locked": false
}'

GET/{backup}/download

取得下載 URL

產生具時效性的備份下載網址。

程式範例cURL / Node.js / Python

curl -X GET "${BASE_URL}/{backup}/download" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"

POST/{backup}/lock

切換備份鎖定

鎖定後可避免備份遭到一般刪除或自動清理。

程式範例cURL / Node.js / Python

curl -X POST "${BASE_URL}/{backup}/lock" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"

POST/{backup}/restore

還原備份

以備份內容覆寫伺服器檔案，可選擇是否清除既有檔案。

REQUEST BODY

{ "truncate": true }

程式範例cURL / Node.js / Python

curl -X POST "${BASE_URL}/{backup}/restore" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "truncate": true }'

DELETE/{backup}

刪除備份

永久刪除未鎖定的備份。

程式範例cURL / Node.js / Python

curl -X DELETE "${BASE_URL}/{backup}" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Accept: application/json"