ovahub
本文へ
ドキュメントAPI リファレンス操作記録を取得
GETBearer トークン

操作記録を取得

/api/v1/audit

固定チームのサーバー、スナップショット、ファイアウォール、プライベートネットワークの送信済み操作を取得します。廃止したリソースを含み、監査権限が必要です。1ページ10件。認証情報や実行状態は返しません。

呼び出す前に

業務記録の読み取りのみです。操作の再試行やプロバイダーへの接続は行いません。認証情報、署名、応答原文、実行状態を除外し、完全な監査エクスポートではありません。

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。1ページ10件。

レスポンス

HTTP ステータス 200

認証済み固定チームの安全な操作記録。タスク状態、認証情報、プロバイダー内容は含みません。

pageinteger

要求するページ番号。1から開始します。

limit10

固定のページサイズ。

totalinteger

この固定チームで条件に一致する記録の総数。

eventsarray

条件に一致する最新の操作。最大10件。

events[].idstring

server、firewall、networkの接頭辞を持つ固定記録ID。

events[].typestring

server、firewall、networkのいずれか。

events[].actionstring

リクエストスキーマで定義された安全な操作名。

events[].actorobject

idとname。取得できないIDはnull。他チームの情報は検索しません。

events[].resourceobject

プラットフォームIDと表示名。取得できない場合はnull。廃止済みリソースの場合もあります。

events[].createdAtstring

操作受付時刻（ISO 8601）。

関連

リクエストとエラー認証MCP · list_audit_records