跳至文檔內容
開發者文檔API 參考查詢快照清單
GETBearer 權杖

查詢快照清單

/api/v1/servers/:id/snapshots

查詢伺服器快照與數量上限。快照出現在清單中不代表供應商已可執行還原。

API 欄位名稱、型別與程式碼在所有語言中保持原樣。

請求範例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/snapshots" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

僅提供範例,此頁不會發送 API 請求。

參數

id路徑 · 必填

string

資源 ID:24 個十六進位字元。請使用對應列表端點回傳的平台 ID,而非供應商的執行個體 ID。

回應

HTTP 狀態 200

讀取所屬伺服器的快照額度與目前列出的快照。

limitnumber

方案的快照額度。

snapshotsarray

目前供應商回傳的快照記錄或預覽資料。

snapshots[].idstring

快照識別碼。

snapshots[].namestring

快照名稱。

snapshots[].instanceIdstring

供應商執行個體識別碼。

snapshots[].descriptionstring | null (optional)

快照說明。

snapshots[].createdAtstring (optional)

供應商提供的建立日期值(若有)。

snapshots[].autoDeleteAtstring (optional)

供應商提供的自動刪除日期(若有)。

snapshots[].imageIdstring (optional)

供應商提供的映像識別碼(若有)。

snapshots[].imageNamestring (optional)

供應商提供的映像名稱(若有)。

simulatedboolean (true, optional)

隔離測試資源會提供此欄位,其快照清單為空。