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

查詢操作紀錄

/api/v1/audit

依固定團隊分頁查詢伺服器、快照、防火牆和私有網路的已提交操作,包含已回收資源。需要審計權限,每頁十筆,不返回憑據或執行狀態。

呼叫前請注意

僅查詢業務紀錄,不重試操作或呼叫供應商;不返回憑據、簽名、供應商原文或執行狀態,亦非完整審計匯出。

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

請求範例

cURL
curl "https://tovahub.com/api/v1/audit?type=all&action=shutdown&page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

回應示例
JSON
{
  "page": 1,
  "limit": 10,
  "total": 1,
  "events": [
    {
      "id": "server:507f1f77bcf86cd799439014",
      "type": "server",
      "action": "shutdown",
      "actor": {
        "id": "507f1f77bcf86cd799439012",
        "name": "Alex"
      },
      "resource": {
        "id": "507f1f77bcf86cd799439013",
        "name": "api-node"
      },
      "createdAt": "2026-11-12T04:00:00.000Z"
    }
  ]
}

參數

type查詢字串 · 選填

string

all、server、firewall 或 network,預設 all。

action查詢字串 · 選填

string

結構中定義的單一動作或 all,預設 all;類型與動作不符時回傳空頁。

page查詢字串 · 選填

integer

頁碼 1–10000,每頁十筆。

回應

HTTP 狀態 200

目前固定團隊的安全操作紀錄;不含任務狀態、憑據或供應商內容。

pageinteger

要求的頁碼,從 1 開始。

limit10

固定每頁筆數。

totalinteger

此固定團隊符合篩選的紀錄總數。

eventsarray

符合條件的最新操作,最多十筆。

events[].idstring

穩定紀錄 ID,前綴為 server、firewall 或 network。

events[].typestring

server、firewall 或 network。

events[].actionstring

請求結構中定義的安全動作名稱。

events[].actorobject

id 與 name;身分不可用時為 null,不查詢其他團隊身分。

events[].resourceobject

平台 id 和顯示名稱,不可用時為 null;可能是已回收資源。

events[].createdAtstring

操作受理時的 ISO 8601 時間。