Method: projects.locations.runtimes.reportEvent

Signale et traite un événement d'exécution.

Requête HTTP

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

Paramètres de chemin

Paramètres
name

string

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • iam.permissions.none

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
Champs
vmId

string

Obligatoire. Jeton matériel de la VM pour l'authentification de la VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

object (Event)

Obligatoire. Événement à signaler.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

Événement

Définition d'un événement pour une instance de notebook gérée / semi-gérée.

Représentation JSON 
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
Champs
reportTime

string (Timestamp format)

Heure du rapport sur l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
type

enum (EventType)

Type d'événement.
details

map (key: string, value: string)

Facultatif. Détails de l'événement. Ce champ permet de transmettre des informations sur l'événement.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

EventType

Définition des types d'événements.

Enums
EVENT_TYPE_UNSPECIFIED L'événement n'est pas spécifié.
IDLE L'instance / l'exécution est inactive
HEARTBEAT L'instance / l'environnement d'exécution est disponible. Cet événement indique que le calcul sous-jacent de l'instance / du runtime est opérationnel.
HEALTH L'état de l'instance / du runtime est disponible. Cet événement indique des informations sur l'état de l'instance ou de l'exécution.
MAINTENANCE L'instance / l'environnement d'exécution est disponible. Cet événement permet à l'instance / au runtime d'envoyer des informations sur la maintenance de l'hôte au plan de contrôle. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance