GETBearer トークン

サーバーの操作履歴を取得

/api/v1/servers/:id/events

プラットフォームに記録されたサーバー操作を、1 ページ 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 桁の16進数文字列です。対応する一覧エンドポイントが返すプラットフォーム ID を使用し、プロバイダーのインスタンス ID は使用しないでください。

pageクエリ · 任意

integer

クエリ値は整数として解析されます。1–1,000,000、既定値は 1。hasNext に従って次ページを取得してください。

HTTP ステータス 200

プラットフォームに記録されたサーバー操作と観測された状態をページ分割して取得します。

pagenumber

指定されたページ。既定値は 1。

hasNextboolean

次のページが存在するかどうか。

eventsarray

ルートが既定のページ番号を指定するため、この API では最大 10 件を返します。

events[].idstring (ObjectId)

プラットフォームの操作イベント識別子。

events[].actionstring

記録された操作。自動更新イベントの名前は autorenew_on または autorenew_off です。

events[].statusstring

観測された状態。進行中のタスクは pending として返されます。

events[].errornull

この一覧では現在、イベントのエラー詳細の代わりに null を返します。

events[].createdAtstring (ISO 8601)

イベントの作成日時。

events[].actorUserIdstring (ObjectId) | null

元の操作者のアカウントID。履歴が不完全ならnullです。現在の閲覧者は同じ固定チームの有効メンバーである必要があります。

events[].taskKeystring | null

送信済みの元タスクキー。get_server_taskで読み取り専用照会でき、未記録ならnullです。再送信、ロック解除、元の操作者の権限付与は行いません。