Method: projects.locations.runtimes.reportEvent

Informa y procesa un evento del entorno de ejecución.

Solicitud HTTP

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

Parámetros de ruta

Parámetros
name

string

Obligatorio. Formato: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • iam.permissions.none

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
Campos
vmId

string

Obligatorio. Es el token de hardware de la VM para autenticarla. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

object (Event)

Obligatorio. Es el evento que se denunciará.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Evento

Es la definición de un evento para una instancia de notebook administrada o parcialmente administrada.

Representación JSON 
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
Campos
reportTime

string (Timestamp format)

Es la fecha y hora del informe del evento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
type

enum (EventType)

Es el tipo de evento.
details

map (key: string, value: string)

Es opcional. Son los detalles del evento. Este campo se usa para pasar información del evento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

EventType

Es la definición de los tipos de eventos.

Enums
EVENT_TYPE_UNSPECIFIED No se especificó el evento.
IDLE La instancia o el entorno de ejecución están inactivos
HEARTBEAT El tiempo de ejecución o la instancia están disponibles. Este evento indica que el tiempo de ejecución o la instancia de procesamiento subyacente están operativos.
HEALTH El estado de la instancia o del tiempo de ejecución está disponible. Este evento indica información sobre el estado del entorno de ejecución o de la instancia.
MAINTENANCE El tiempo de ejecución o la instancia están disponibles. Este evento permite que la instancia o el entorno de ejecución envíen información de mantenimiento del host al plano de control. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance