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[].typestringserver、firewall 或 network。
events[].actionstring請求結構中定義的安全動作名稱。
events[].actorobjectid 與 name;身分不可用時為 null,不查詢其他團隊身分。
events[].resourceobject平台 id 和顯示名稱,不可用時為 null;可能是已回收資源。
events[].createdAtstring操作受理時的 ISO 8601 時間。