Method: projects.locations.runtimes.reportEvent

ランタイム イベントを報告して処理します。

HTTP リクエスト

POST https://notebooks.googleapis.com/v1/{name}:reportEvent

パスパラメータ

パラメータ
name

string

必須。形式: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

認可には、指定されたリソース name に対する次の IAM の権限が必要です。

  • iam.permissions.none

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
フィールド
vmId

string

必須。VM を認証するための VM ハードウェア トークン。https://cloud.google.com/compute/docs/instances/verifying-instance-identity

event

object (Event)

必須。報告するイベント。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/notebooks

詳細については、Authentication Overview をご覧ください。

イベント

マネージド / 準マネージド ノートブック インスタンスの Event の定義。

JSON 表現
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
フィールド
reportTime

string (Timestamp format)

イベント レポートの時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

type

enum (EventType)

イベントタイプ。

details

map (key: string, value: string)

省略可。イベントの詳細。このフィールドは、イベント情報を渡すために使用されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

EventType

イベントタイプの定義。

列挙型
EVENT_TYPE_UNSPECIFIED イベントが指定されていません。
IDLE インスタンス / ランタイムがアイドル状態である
HEARTBEAT インスタンス / ランタイムが使用可能です。このイベントは、インスタンス / ランタイムの基盤となるコンピューティングが動作していることを示します。
HEALTH インスタンス / ランタイムの健全性が利用可能です。このイベントは、インスタンス / ランタイムの健全性情報を示します。
MAINTENANCE インスタンス / ランタイムが使用可能です。このイベントにより、インスタンス / ランタイムはホスト メンテナンス情報をコントロール プレーンに送信できます。https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance