Method: projects.locations.runtimes.reportEvent

Segnala ed elabora un evento di runtime.

Richiesta HTTP

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

Parametri del percorso

Parametri
name

string

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

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • iam.permissions.none

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
Campi
vmId

string

Obbligatorio. Il token hardware della VM per l'autenticazione della VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

object (Event)

Obbligatorio. L'evento da segnalare.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Evento

La definizione di un evento per un'istanza di notebook gestita / semi-gestita.

Rappresentazione JSON 
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
Campi
reportTime

string (Timestamp format)

Ora della segnalazione dell'evento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
type

enum (EventType)

Tipo di evento.
details

map (key: string, value: string)

Facoltativo. Dettagli dell'evento. Questo campo viene utilizzato per trasmettere le informazioni sugli eventi.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

EventType

La definizione dei tipi di eventi.

Enum
EVENT_TYPE_UNSPECIFIED L'evento non è specificato.
IDLE L'istanza / il runtime è inattivo
HEARTBEAT L'istanza / il runtime è disponibile. Questo evento indica che il calcolo sottostante dell'istanza / del runtime è operativo.
HEALTH L'integrità dell'istanza / del runtime è disponibile. Questo evento indica le informazioni sull'integrità dell'istanza / del runtime.
MAINTENANCE L'istanza / il runtime è disponibile. Questo evento consente all'istanza / al runtime di inviare informazioni sulla manutenzione dell'host al piano di controllo. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance