跳至文檔內容
開發者文檔API 參考查詢伺服器操作紀錄
GETBearer 權杖

查詢伺服器操作紀錄

/api/v1/servers/:id/events

分頁查詢平台記錄的伺服器操作,每頁 10 筆。

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

請求範例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/events?page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

回應示例
JSON
{
  "page": 1,
  "hasNext": false,
  "events": []
}

參數

id路徑 · 必填

string

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

page查詢字串 · 選填

integer

查詢值會解析為整數,範圍 1–1,000,000,預設為 1。請依 hasNext 繼續查詢。

回應

HTTP 狀態 200

分頁讀取平台記錄的伺服器操作及其觀測狀態。

pagenumber

請求的頁碼,預設為一。

hasNextboolean

是否還有下一頁。

eventsarray

此 API 最多回傳十筆,因為路由會提供預設頁碼。

events[].idstring (ObjectId)

平台操作事件識別碼。

events[].actionstring

記錄的操作;自動續約事件名稱為 autorenew_on 或 autorenew_off。

events[].statusstring

觀測到的狀態;進行中的工作會回報為 pending。

events[].errornull

此清單目前回傳 null,不提供事件錯誤詳細資訊。

events[].createdAtstring (ISO 8601)

事件建立時間。

events[].actorUserIdstring (ObjectId) | null

原操作人帳號編號;歷史缺失為null。目前讀者須為同一固定團隊的有效成員。

events[].taskKeystring | null

原已提交任務編號,可用get_server_task只讀查詢;缺失為null。不重送、解鎖或授予原操作人的權限。