Method: projects.locations.runtimes.reportEvent

Meldet und verarbeitet ein Laufzeitereignis.

HTTP-Anfrage

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

Pfadparameter

Parameter
name

string

Erforderlich. Format: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • iam.permissions.none

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
Felder
vmId

string

Erforderlich. Das VM-Hardwaretoken zur Authentifizierung der VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

object (Event)

Erforderlich. Das zu meldende Ereignis.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

Ereignis

Die Definition eines Ereignisses für eine verwaltete / teilverwaltete Notebook-Instanz.

JSON-Darstellung 
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
Felder
reportTime

string (Timestamp format)

Zeitpunkt des Ereignisberichts.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
type

enum (EventType)

Ereignistyp.
details

map (key: string, value: string)

Optional. Termindetails. Dieses Feld wird verwendet, um Ereignisinformationen zu übergeben.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

EventType

Die Definition der Ereignistypen.

Enums
EVENT_TYPE_UNSPECIFIED Das Ereignis ist nicht angegeben.
IDLE Die Instanz / Laufzeit ist inaktiv
HEARTBEAT Die Instanz / Laufzeit ist verfügbar. Dieses Ereignis gibt an, dass die zugrunde liegende Compute-Instanz / ‑Laufzeit betriebsbereit ist.
HEALTH Der Systemstatus der Instanz / Laufzeit ist verfügbar. Dieses Ereignis gibt Informationen zum Zustand von Instanz und Laufzeit an.
MAINTENANCE Die Instanz / Laufzeit ist verfügbar. Mit diesem Ereignis kann die Instanz / Laufzeit Informationen zur Hostwartung an die Steuerungsebene senden. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance