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

必需。用于对虚拟机进行身份验证的虚拟机硬件令牌。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 规范化（即转换为 UTC 零时区格式并在末尾附加 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