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

詳情請參閱Authentication Overview。

事件

代管 / 半代管型筆記本執行個體的事件定義。

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