Method: projects.locations.runtimes.reportEvent

מדווח על אירוע בזמן ריצה ומעבד אותו.

בקשת HTTP

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

פרמטרים של נתיב

פרמטרים
name

string

חובה. פורמט: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

כדי לתת הרשאה, צריך את הרשאת IAM הבאה במשאב שצוין name:

  • 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
  • https://www.googleapis.com/auth/notebooks

ניתן למצוא מידע נוסף כאן: Authentication Overview.

אירוע

ההגדרה של אירוע עבור מחברת מנוהלת או מנוהלת למחצה.

ייצוג ב-JSON 
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
שדות
reportTime

string (Timestamp format)

הזמן שבו האירוע דווח.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט 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

ההגדרה של סוגי האירועים.

טיפוסים בני מנייה (enum)
EVENT_TYPE_UNSPECIFIED לא צוין אירוע.
IDLE המופע או זמן הריצה לא פעילים
HEARTBEAT המופע או זמן הריצה זמינים. האירוע הזה מציין שהמחשוב הבסיסי של המופע או של זמן הריצה פועל.
HEALTH מצב התקינות של המופע או זמן הריצה זמין. האירוע הזה מציין מידע על תקינות המופע או זמן הריצה.
MAINTENANCE המופע או זמן הריצה זמינים. האירוע הזה מאפשר למופע או לסביבת זמן ריצה לשלוח מידע על תחזוקת המארח למישור הבקרה. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance