REST Resource: projects.locations.runtimes

משאב: זמן ריצה

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

ייצוג ב-JSON 
{
  "name": string,
  "state": enum (State),
  "healthState": enum (HealthState),
  "accessConfig": {
    object (RuntimeAccessConfig)
  },
  "softwareConfig": {
    object (RuntimeSoftwareConfig)
  },
  "metrics": {
    object (RuntimeMetrics)
  },
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "runtimeMigrationEligibility": {
    object (RuntimeMigrationEligibility)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "virtualMachine": {
    object (VirtualMachine)
  }
  // End of mutually exclusive fields.
  "migrated": boolean
}
שדות
name

string

פלט בלבד. שם המשאב של זמן הריצה. פורמט: projects/{project}/locations/{location}/runtimes/{runtimeId}
state

enum (State)

פלט בלבד. המצב של סביבת זמן הריצה.
healthState

enum (HealthState)

פלט בלבד. ‫healthState של זמן הריצה.
accessConfig

object (RuntimeAccessConfig)

הגדרות התצורה לגישה לזמן הריצה.
softwareConfig

object (RuntimeSoftwareConfig)

הגדרות התצורה של התוכנה בתוך זמן הריצה.
metrics

object (RuntimeMetrics)

פלט בלבד. כולל מדדים של דמון זמן הריצה, כמו סטטוס השירות ונתונים סטטיסטיים של JupyterLab.
createTime

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".
updateTime

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".
labels

map (key: string, value: string)

זה שינוי אופציונלי. התוויות שמשויכות ל-Managed Notebook או לסביבת זמן הריצה. מפתחות של תוויות צריכים להכיל 1 עד 63 תווים, ולעמוד בדרישות של RFC 1035. הערכים של התוויות יכולים להיות ריקים, אבל אם הם קיימים, הם צריכים להכיל בין תו אחד ל-63 תווים, ולעמוד בדרישות של RFC 1035. אפשר לשייך עד 32 תוויות לאשכול.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
runtimeMigrationEligibility

object (RuntimeMigrationEligibility)

פלט בלבד. בודק את ההיתכנות של מעבר מ-GmN ל-WbI.
סוג זמן הריצה. בשלב הזה יש תמיכה רק במכונה וירטואלית ב-Compute Engine. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
virtualMachine

object (VirtualMachine)

משתמשים בתמונה של מכונת VM ב-Compute Engine כדי להפעיל את מחברת המופעים המנוהלת.
סוף השדות הבלעדיים.
migrated

boolean

פלט בלבד. ערך בוליאני שמציין אם ה-notebook הזה הועבר למופע של Workbench

VirtualMachine

זמן ריצה באמצעות מכונה וירטואלית לחישובים.

ייצוג ב-JSON 
{
  "instanceName": string,
  "instanceId": string,
  "virtualMachineConfig": {
    object (VirtualMachineConfig)
  }
}
שדות
instanceName

string

פלט בלבד. השם הידידותי למשתמש של מכונת Compute Engine מנוהלת.
instanceId

string

פלט בלבד. המזהה הייחודי של מכונת Compute Engine המנוהלת.
virtualMachineConfig

object (VirtualMachineConfig)

הגדרות של מכונה וירטואלית.

VirtualMachineConfig

הגדרות התצורה של המכונה הווירטואלית.

ייצוג ב-JSON 
{
  "zone": string,
  "machineType": string,
  "containerImages": [
    {
      object (ContainerImage)
    }
  ],
  "dataDisk": {
    object (LocalDisk)
  },
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "shieldedInstanceConfig": {
    object (RuntimeShieldedInstanceConfig)
  },
  "acceleratorConfig": {
    object (RuntimeAcceleratorConfig)
  },
  "network": string,
  "subnet": string,
  "internalIpOnly": boolean,
  "tags": [
    string
  ],
  "guestAttributes": {
    string: string,
    ...
  },
  "metadata": {
    string: string,
    ...
  },
  "labels": {
    string: string,
    ...
  },
  "nicType": enum (NicType),
  "reservedIpRange": string,
  "bootImage": {
    object (BootImage)
  }
}
שדות
zone

string

פלט בלבד. האזור שבו נמצאת המכונה הווירטואלית. אם משתמשים בבקשה אזורית, שירות ה-notebooks יבחר מיקום באזור זמן הריצה המתאים. בבקשת GET, הפרמטר zone תמיד יהיה קיים. דוגמה: * us-central1-b
machineType

string

חובה. סוג המכונה של Compute Engine שמשמשת לסביבות זמן ריצה. השם הקצר תקין. דוגמאות: * n1-standard-2 * e2-standard-8
containerImages[]

object (ContainerImage)

זה שינוי אופציונלי. שימוש ברשימה של קובצי אימג' של קונטיינרים לשימוש כליבות במופע של מחברת.
dataDisk

object (LocalDisk)

חובה. הגדרות של אפשרויות דיסק נתונים.
encryptionConfig

object (EncryptionConfig)

זה שינוי אופציונלי. הגדרות ההצפנה של דיסק הנתונים של המכונה הווירטואלית.
shieldedInstanceConfig

object (RuntimeShieldedInstanceConfig)

זה שינוי אופציונלי. הגדרות של מכונה וירטואלית מוגנת.
acceleratorConfig

object (RuntimeAcceleratorConfig)

זה שינוי אופציונלי. הגדרת המאיץ של Compute Engine לזמן הריצה הזה.
network

string

זה שינוי אופציונלי. הרשת של Compute Engine שתשמש לתקשורת בין המכונות. אי אפשר לציין אותו עם רשת משנה. אם לא מציינים את network או את subnet, המערכת משתמשת ברשת 'default' של הפרויקט, אם היא קיימת.

כתובת URL מלאה או URI חלקי. דוגמאות:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/global/networks/default
  • projects/[projectId]/global/networks/default

סביבות זמן ריצה הן משאבים מנוהלים בתשתית של Google. סביבות זמן הריצה תומכות בהגדרות הרשת הבאות:

  • רשת בניהול Google (השדות Network ו-Subnet ריקים)
  • ‫VPC בפרויקט הצרכן (נדרשת רשת ורשת משנה). צריך להגדיר גישה לשירותים פרטיים.
  • VPC משותף (נדרשת רשת ורשת משנה). צריך להגדיר גישה לשירותים פרטיים.
subnet

string

זה שינוי אופציונלי. רשת המשנה של Compute Engine שתשמש לתקשורת בין המכונות. אי אפשר לציין אותו עם רשת.

אפשר להזין כתובת URL מלאה או URI חלקי. דוגמאות:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/regions/us-east1/subnetworks/sub0
  • projects/[projectId]/regions/us-east1/subnetworks/sub0
internalIpOnly

boolean

זה שינוי אופציונלי. אם הערך הוא true, בזמן הריצה יהיו רק כתובות IP פנימיות. כברירת מחדל, זמני הריצה לא מוגבלים לכתובות IP פנימיות, ויוקצו לכל מכונה וירטואלית כתובות IP חיצוניות ארעיות. אפשר להפעיל את ההגבלה הזו ב-internalIpOnly רק ברשתות שמופעלת בהן רשת משנה, וצריך להגדיר את כל התלות כך שאפשר יהיה לגשת אליהן בלי כתובות IP חיצוניות.
tags[]

string

זה שינוי אופציונלי. תגי הרשת של Compute Engine שרוצים להוסיף לזמן הריצה (ראו הוספת תגי רשת).
guestAttributes

map (key: string, value: string)

פלט בלבד. מאפייני האורח של Compute Engine. (ראו מאפייני אורח של פרויקט ומופע).

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
metadata

map (key: string, value: string)

זה שינוי אופציונלי. ערכי המטא-נתונים של Compute Engine שרוצים להוסיף למכונה הווירטואלית. (ראו מטא-נתונים של פרויקטים ושל מכונות וירטואליות).

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
labels

map (key: string, value: string)

זה שינוי אופציונלי. התוויות לשיוך לזמן הריצה הזה. מפתחות של תוויות צריכים להכיל 1 עד 63 תווים, ולעמוד בדרישות של RFC 1035. הערכים של התוויות יכולים להיות ריקים, אבל אם הם קיימים, הם צריכים להכיל בין תו אחד ל-63 תווים, ולעמוד בדרישות של RFC 1035. אפשר לשייך עד 32 תוויות לאשכול.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
nicType

enum (NicType)

זה שינוי אופציונלי. סוג ה-vNIC שבו יש להשתמש בממשק הזה. יכול להיות שמדובר ב-gVNIC או ב-VirtioNet.
reservedIpRange

string

זה שינוי אופציונלי. השם של טווח כתובות ה-IP השמור משמש לקישור בין רשתות VPC שכנות (peering). הקצאת רשת המשנה תשתמש בטווח name אם הוא הוקצה.

דוגמה: managed-notebooks-range-c

PEERING_RANGE_NAME_3=managed-notebooks-range-c
gcloud compute addresses create $PEERING_RANGE_NAME_3 \
  --global \
  --prefix-length=24 \
  --description="Google Cloud Managed Notebooks Range 24 c" \
  --network=$NETWORK \
  --addresses=192.168.0.0 \
  --purpose=VPC_PEERING

ערך השדה יהיה: managed-notebooks-range-c
bootImage

object (BootImage)

זה שינוי אופציונלי. מטא-נתונים של קובץ אימג' לאתחול שמשמשים לשדרוג בזמן הריצה.

LocalDisk

מקור מידע של דיסק מקומי מצורף.

ייצוג ב-JSON 
{
  "autoDelete": boolean,
  "boot": boolean,
  "deviceName": string,
  "guestOsFeatures": [
    {
      object (RuntimeGuestOsFeature)
    }
  ],
  "index": integer,
  "initializeParams": {
    object (LocalDiskInitializeParams)
  },
  "interface": string,
  "kind": string,
  "licenses": [
    string
  ],
  "mode": string,
  "source": string,
  "type": string
}
שדות
autoDelete

boolean

זה שינוי אופציונלי. פלט בלבד. ההגדרה מציינת אם הדיסק יימחק אוטומטית כשהמופע יימחק (אבל לא כשהדיסק מנותק מהמופע).
boot

boolean

זה שינוי אופציונלי. פלט בלבד. מציין שזה דיסק אתחול. המכונה הווירטואלית תשתמש במחיצה הראשונה של הדיסק עבור מערכת הקבצים הבסיסית שלה.
deviceName

string

זה שינוי אופציונלי. פלט בלבד. מציינים שם ייחודי למכשיר לפי בחירתכם, שמופיע בעץ /dev/disk/by-id/google-* של מערכת הפעלה מסוג Linux שפועלת בתוך המופע. אפשר להשתמש בשם הזה כדי להפנות למכשיר לצורך הרכבה, שינוי גודל וכו', מתוך המופע.

אם לא מציינים שם, השרת בוחר שם מכשיר שמוגדר כברירת מחדל להחלה על הדיסק הזה, בתבנית persistent-disk-x, כאשר x הוא מספר שמוקצה על ידי Google Compute Engine. השדה הזה רלוונטי רק לדיסקים קשיחים קבועים.
guestOsFeatures[]

object (RuntimeGuestOsFeature)

פלט בלבד. מציינת רשימה של תכונות להפעלה במערכת ההפעלה של האורח. רלוונטי רק לתמונות שניתן להפעיל מהן את המחשב. במאמר בנושא הפעלת תכונות של מערכת הפעלה אורחת מופיעה רשימה של האפשרויות הזמינות.
index

integer

פלט בלבד. אינדקס מבוסס-אפס של הדיסק הזה, כאשר 0 שמור לדיסק האתחול. אם יש הרבה דיסקים שמצורפים למופע, לכל דיסק יהיה מספר אינדקס ייחודי.
initializeParams

object (LocalDiskInitializeParams)

קלט בלבד. מציינת את הפרמטרים של דיסק חדש שייווצר לצד המכונה החדשה. אפשר להשתמש בפרמטרים של אתחול כדי ליצור דיסקים לאתחול או כונני SSD מקומיים שמצורפים למופע החדש.

הנכס הזה לא יכול להתקיים יחד עם נכס המקור. אפשר להגדיר רק אחד מהם, אבל לא את שניהם.
interface

string

מציין את ממשק הדיסק שבו יש להשתמש לצירוף הדיסק הזה, שהוא SCSI או NVME. ברירת המחדל היא SCSI. תמיד צריך להשתמש ב-SCSI בדיסקים מתמידים, והבקשה תיכשל אם תנסו לצרף דיסק מתמיד בכל פורמט אחר מלבד SCSI. אפשר להשתמש ב-NVME או ב-SCSI עבור כונני SSD מקומיים. למידע על מאפייני הביצועים של SCSI over NVMe, אפשר לעיין במאמר בנושא ביצועים של SSD מקומי. הערכים האפשריים:

  • NVME
  • SCSI
kind

string

פלט בלבד. סוג המשאב. תמיד מחשבים את הערך של ‎#attachedDisk‎ עבור דיסקים שמצורפים.
licenses[]

string

פלט בלבד. כל הרישיונות התקפים שגלויים לכולם.
mode

string

המצב שבו הדיסק הזה מצורף, READ_WRITE או READ_ONLY. אם לא מציינים את המצב, ברירת המחדל היא לצרף את הדיסק במצב READ_WRITE. הערכים האפשריים:

  • READ_ONLY
  • READ_WRITE
source

string

מציין כתובת URL תקינה, חלקית או מלאה, למשאב קיים של Persistent Disk.
type

string

מציין את סוג הדיסק, SCRATCH או PERSISTENT. אם לא מציינים ערך, ברירת המחדל היא PERSISTENT. הערכים האפשריים:

  • PERSISTENT
  • SCRATCH

RuntimeGuestOsFeature

זה שינוי אופציונלי. רשימה של תכונות להפעלה במערכת ההפעלה של האורח. רלוונטי רק לתמונות שניתן להפעיל מהן את המחשב. רשימת האפשרויות הזמינות תכונות של מערכת הפעלה אורחת לדיסק האתחול.

ייצוג ב-JSON 
{
  "type": string
}
שדות
type

string

המזהה של תכונה נתמכת. רשימת האפשרויות הזמינות

הערכים האפשריים:

  • FEATURE_TYPE_UNSPECIFIED
  • MULTI_IP_SUBNET
  • SECURE_BOOT
  • UEFI_COMPATIBLE
  • VIRTIO_SCSI_MULTIQUEUE
  • WINDOWS

LocalDiskInitializeParams

קלט בלבד. מציינת את הפרמטרים של דיסק חדש שייווצר לצד המכונה החדשה. משתמשים בפרמטרים של אתחול כדי ליצור דיסקים לאתחול או כונני SSD מקומיים שמצורפים לסביבת זמן הריצה החדשה. הנכס הזה לא יכול להתקיים יחד עם נכס המקור. אפשר להגדיר רק אחד מהם, אבל לא את שניהם.

ייצוג ב-JSON 
{
  "description": string,
  "diskName": string,
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "labels": {
    string: string,
    ...
  }
}
שדות
description

string

זה שינוי אופציונלי. צריך לציין את המאפיין הזה כשיוצרים את הדיסק.
diskName

string

זה שינוי אופציונלי. מציין את שם הדיסק. אם לא מציינים שם, ברירת המחדל היא להשתמש בשם של המופע. אם הדיסק עם שם המופע כבר קיים באזור או באזור המשנה שצוינו, ייווצר שם חדש באופן אוטומטי.
diskSizeGb

string (int64 format)

זה שינוי אופציונלי. ההגדרה קובעת את גודל הדיסק ב-GB בבסיס 2. אם לא מציינים גודל, הדיסק יהיה באותו גודל של התמונה (בדרך כלל 10GB). אם מציינים גודל, הוא חייב להיות 10GB או יותר. ברירת המחדל היא 100GB.
diskType

enum (DiskType)

קלט בלבד. סוג דיסק האתחול שמצורף למכונה הזו. ברירת המחדל היא דיסק מתמיד סטנדרטי (PD_STANDARD).
labels

map (key: string, value: string)

זה שינוי אופציונלי. תוויות להחלה על הדיסק הזה. אפשר לשנות את התוויות האלה בהמשך באמצעות השיטה disks.setLabels. השדה הזה רלוונטי רק לדיסקים קשיחים קבועים.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DiskType

סוגי דיסקים אפשריים.

טיפוסים בני מנייה (enum)
DISK_TYPE_UNSPECIFIED לא הוגדר סוג הדיסק.
PD_STANDARD סוג של דיסק מתמיד סטנדרטי.
PD_SSD סוג הדיסק המתמיד שמבוסס על SSD.
PD_BALANCED סוג דיסק אחסון מתמיד מאוזן.
PD_EXTREME סוג דיסק אחסון מתמיד מסוג Extreme.

EncryptionConfig

מייצג הגדרה של מפתח הצפנה בהתאמה אישית שאפשר להחיל על משאב. כל הדיסקים במכונה הווירטואלית יוצפנו.

ייצוג ב-JSON 
{
  "kmsKey": string
}
שדות
kmsKey

string

מזהה משאב Cloud KMS של מפתח ההצפנה בניהול הלקוח שמשמש להגנה על משאב, כמו דיסקים. הפורמט הוא: projects/{PROJECT_ID}/locations/{REGION}/keyRings/{KEY_RING_NAME}/cryptoKeys/{KEY_NAME}

RuntimeShieldedInstanceConfig

קבוצה של אפשרויות של מכונה מוגנת. תמונות שמשתמשות בתכונות נתמכות של מכונות וירטואליות מוגנות לא כל השילובים תקפים.

ייצוג ב-JSON 
{
  "enableSecureBoot": boolean,
  "enableVtpm": boolean,
  "enableIntegrityMonitoring": boolean
}
שדות
enableSecureBoot

boolean

המאפיין הזה מגדיר אם האתחול המאובטח מופעל במופע.

ההפעלה המאובטחת עוזרת לוודא שבמערכת פועלת רק תוכנה מקורית. היא עושה זאת באמצעות אימות החתימה הדיגיטלית של כל רכיבי האתחול, ועצירת תהליך האתחול אם אימות החתימה נכשל. ההגדרה מושבתת כברירת מחדל.
enableVtpm

boolean

ההגדרה קובעת אם ה-vTPM מופעל במופע. מופעל כברירת מחדל.
enableIntegrityMonitoring

boolean

ההגדרה קובעת אם המעקב אחר התקינות מופעל במופע.

האפשרות הזו מאפשרת מעקב ואימות של תקינות האתחול של המופע. האימות מתבצע בהשוואה לערך הבסיסי של מדיניות השלמות. ה-Baseline הזה נגזר בהתחלה מקובץ האימג' לאתחול שמהימן באופן מרומז כשהמופע נוצר. מופעל כברירת מחדל.

RuntimeAcceleratorConfig

הגדרה של סוגי מאיצי החומרה שאפשר להשתמש בהם. מידע על סוגי מאיצים ב-Compute Engine דוגמאות:

  • nvidia-tesla-k80
  • nvidia-tesla-p100
  • nvidia-tesla-v100
  • nvidia-tesla-p4
  • nvidia-tesla-t4
  • nvidia-tesla-a100
ייצוג ב-JSON 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
שדות
type

enum (AcceleratorType)

מודל מאיץ.
coreCount

string (int64 format)

מספר ליבות המעבד של המאיץ הזה.

AcceleratorType

סוג המאיץ.

טיפוסים בני מנייה (enum)
ACCELERATOR_TYPE_UNSPECIFIED לא צוין סוג המאיץ.
NVIDIA_TESLA_K80

סוג המאיץ הוא Nvidia Tesla K80.
NVIDIA_TESLA_P100 סוג המאיץ הוא Nvidia Tesla P100.
NVIDIA_TESLA_V100 סוג המאיץ הוא Nvidia Tesla V100.
NVIDIA_TESLA_P4 סוג המאיץ הוא Nvidia Tesla P4.
NVIDIA_TESLA_T4 סוג המאיץ הוא Nvidia Tesla T4.
NVIDIA_TESLA_A100 סוג המאיץ הוא Nvidia Tesla A100 – 40GB.
NVIDIA_L4 סוג המאיץ הוא Nvidia L4.
TPU_V2 (בקרוב) סוג המאיץ הוא TPU V2.
TPU_V3 (בקרוב) סוג המאיץ הוא TPU V3.
NVIDIA_TESLA_T4_VWS סוג המאיץ הוא NVIDIA Tesla T4 Virtual Workstations.
NVIDIA_TESLA_P100_VWS סוג המאיץ הוא NVIDIA Tesla P100 Virtual Workstations.
NVIDIA_TESLA_P4_VWS סוג המאיץ הוא NVIDIA Tesla P4 Virtual Workstations.

NicType

סוג מנהל ההתקן של ה-vNIC. ברירת המחדל צריכה להיות UNSPECIFIED_NIC_TYPE.

טיפוסים בני מנייה (enum)
UNSPECIFIED_NIC_TYPE לא צוין סוג.
VIRTIO_NET VIRTIO
GVNIC GVNIC

BootImage

בסוג הזה אין שדות.

הגדרה של תמונת האתחול שמשמשת את זמן הריצה. משמשת כדי לאפשר שדרוג בזמן ריצה.

מדינה

ההגדרה של המצבים של זמן הריצה הזה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוין מצב.
STARTING שכבת המחשוב מתחילה את זמן הריצה. הוא לא מוכן לשימוש.
PROVISIONING שכבת החישוב מתקינה את המסגרות הנדרשות ורושמת את זמן הריצה ב-Proxy של המחברת. אי אפשר להשתמש בו.
ACTIVE זמן הריצה פועל כרגע. הוא מוכן לשימוש.
STOPPING לוגיקת הבקרה מפסיקה את זמן הריצה. אי אפשר להשתמש בו.
STOPPED זמן הריצה הופסק. אי אפשר להשתמש בו.
DELETING סביבת זמן הריצה נמחקת. אי אפשר להשתמש בו.
UPGRADING מתבצע שדרוג של זמן הריצה. אי אפשר להשתמש בו.
INITIALIZING סביבת זמן הריצה נוצרת ומוגדרת. הוא לא מוכן לשימוש.

HealthState

מצב המשנה של זמן הריצה.

טיפוסים בני מנייה (enum)
HEALTH_STATE_UNSPECIFIED מצב המשנה של זמן הריצה לא ידוע.
HEALTHY הסביבה בזמן הריצה נמצאת במצב תקין (לדוגמה, שדים קריטיים פועלים). רלוונטי למצב ACTIVE.
UNHEALTHY ידוע שמצב זמן הריצה לא תקין (לדוגמה, שדים קריטיים לא פועלים). חל על מצב ACTIVE.
AGENT_NOT_INSTALLED סביבת זמן הריצה לא התקינה סוכן למעקב אחר תקינות המכשיר. ההגדרה חלה על מצב פעיל.
AGENT_NOT_RUNNING הסוכן של מעקב אחר תקינות זמן הריצה לא פועל. ההגדרה חלה על מצב פעיל.

RuntimeAccessConfig

הגדרת הכניסה לסביבת זמן הריצה

ייצוג ב-JSON 
{
  "accessType": enum (RuntimeAccessType),
  "runtimeOwner": string,
  "proxyUri": string
}
שדות
accessType

enum (RuntimeAccessType)

סוג מצב הגישה של המופע הזה.
runtimeOwner

string

הבעלים של זמן הריצה הזה אחרי שהוא נוצר. פורמט: alias@example.com בשלב הזה יש תמיכה רק בבעלים אחד.
proxyUri

string

פלט בלבד. נקודת הקצה של ה-proxy שמשמשת לגישה לסביבת זמן הריצה.

RuntimeAccessType

דרכים אפשריות לגשת לסביבת זמן הריצה. מצב אימות. בשלב הזה יש תמיכה רק במשתמש יחיד.

טיפוסים בני מנייה (enum)
RUNTIME_ACCESS_TYPE_UNSPECIFIED גישה לא מוגדרת.
SINGLE_USER כניסה של משתמש יחיד.
SERVICE_ACCOUNT מצב חשבון שירות. במצב Service Account, יוצר זמן הריצה יציין חשבון שירות שקיים בפרויקט הצרכן. שימוש בשדה 'חשבון שירות בזמן ריצה'. משתמשים שניגשים ל-Runtime צריכים הרשאה מסוג ActAs (משתמש בחשבון שירות).

RuntimeSoftwareConfig

הגדרה של בחירת תוכנה בתוך סביבת זמן הריצה. המאפיינים שצריך להגדיר בזמן הריצה. מציינים את מפתחות המאפיינים בפורמט key:value, לדוגמה:

  • idleShutdown: true
  • idleShutdownTimeout: 180
  • enableHealthMonitoring: true
ייצוג ב-JSON 
{
  "notebookUpgradeSchedule": string,
  "idleShutdownTimeout": integer,
  "installGpuDriver": boolean,
  "customGpuDriverPath": string,
  "postStartupScript": string,
  "kernels": [
    {
      object (ContainerImage)
    }
  ],
  "postStartupScriptBehavior": enum (PostStartupScriptBehavior),
  "enableHealthMonitoring": boolean,
  "idleShutdown": boolean,
  "upgradeable": boolean,
  "disableTerminal": boolean,
  "version": string,
  "mixerDisabled": boolean
}
שדות
notebookUpgradeSchedule

string

ביטוי Cron באזור הזמן UTC, שמשמש לתזמון שדרוג אוטומטי של המופע. צריך להשתמש בפורמט cron.
idleShutdownTimeout

integer

הזמן בדקות להמתנה לפני השבתת זמן הריצה. ברירת מחדל: 180 דקות
installGpuDriver

boolean

התקנה אוטומטית של Nvidia Driver. ברירת מחדל: True
customGpuDriverPath

string

מציינים נתיב מותאם אישית ב-Cloud Storage שבו מאוחסן מנהל ההתקן של ה-GPU. אם לא מציינים, המערכת תבחר אוטומטית מתוך מנהלי התקנים רשמיים של GPU.
postStartupScript

string

נתיב לסקריפט Bash שמופעל אוטומטית אחרי שמפעילים באופן מלא את מופע המחברת. הנתיב צריך להיות כתובת URL או נתיב Cloud Storage ‏ (gs://path-to-file/file-name).
kernels[]

object (ContainerImage)

זה שינוי אופציונלי. שימוש ברשימה של קובצי אימג' של קונטיינרים לשימוש כליבות במופע של מחברת.
postStartupScriptBehavior

enum (PostStartupScriptBehavior)

התנהגות של סקריפט לטעינה בזמן ההפעלה אחרי ההפעלה.
enableHealthMonitoring

boolean

בודק ששירותי הליבה הפנימיים פועלים. ברירת מחדל: True
idleShutdown

boolean

סביבת זמן הריצה תושבת אוטומטית אחרי idle_shutdown_time. ברירת מחדל: True
upgradeable

boolean

פלט בלבד. ערך בוליאני שמציין אם יש תמונה חדשה יותר במשפחת תמונות.
disableTerminal

boolean

ערך בוליאני שמציין אם הטרמינל של JupyterLab יהיה זמין או לא. ברירת מחדל: False
version

string

פלט בלבד. גרסה של קובץ אימג' לאתחול כמו M100, מתווית הגרסה של התמונה.
mixerDisabled

boolean

ערך בוליאני שמציין אם צריך להשבית את לקוח המיקסר. ברירת מחדל: False

PostStartupScriptBehavior

התנהגות של סקריפט לטעינה בזמן ההפעלה אחרי ההפעלה.

טיפוסים בני מנייה (enum)
POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED התנהגות לא מוגדרת של סקריפט לטעינה בזמן ההפעלה אחרי הפעלה. הפעלה חד-פעמית בזמן היצירה.
RUN_EVERY_START מריץ את הסקריפט לטעינה בזמן ההפעלה שסופק במהלך היצירה אחרי ההפעלה בכל הפעלה.
DOWNLOAD_AND_RUN_EVERY_START מוריד ומריץ את הסקריפט לטעינה בזמן ההפעלה שסופק בכל הפעלה.

RuntimeMetrics

הדוח מכיל מדדים של דמון בזמן ריצה, כמו מערכת הפעלה, ליבות ונתוני סשנים.

ייצוג ב-JSON 
{
  "systemMetrics": {
    string: string,
    ...
  }
}
שדות
systemMetrics

map (key: string, value: string)

פלט בלבד. מדדי המערכת.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RuntimeMigrationEligibility

‫RuntimeMigrationEligibility מייצג את המידע על היתכנות של העברה מ-GmN ל-WbI.

ייצוג ב-JSON 
{
  "warnings": [
    enum (Warning)
  ],
  "errors": [
    enum (Error)
  ]
}
שדות
warnings[]

enum (Warning)

פלט בלבד. הגדרות מסוימות יוגדרו כברירת מחדל במהלך ההעברה.
errors[]

enum (Error)

פלט בלבד. הגדרות מסוימות מונעות את ההעברה האוטומטית של GmN. נדרשת העברה ידנית.

אזהרה

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

טיפוסים בני מנייה (enum)
WARNING_UNSPECIFIED סוג ברירת המחדל.
UNSUPPORTED_ACCELERATOR_TYPE ה-GmN משתמש בסוג מאיץ שלא נתמך ב-WbI. הוא יועבר ללא מאיץ. המשתמשים יכולים לצרף מאיץ אחרי ההעברה.
UNSUPPORTED_OS ה-GMN משתמש במערכת הפעלה שלא נתמכת ב-WbI (למשל Debian 10). היא תוחלף ב-Debian 11 ב-WbI.
RESERVED_IP_RANGE ה-GmN הזה מוגדר עם טווח IP שמור, שכבר לא רלוונטי ב-WbI.
GOOGLE_MANAGED_NETWORK רשת ה-GMN הזו מוגדרת עם רשת שמנוהלת על ידי Google. צריך לציין את האפשרויות network ו-subnet להעברה.
POST_STARTUP_SCRIPT ה-GmN הזה מוגדר עם סקריפט לטעינה בזמן ההפעלה. אפשר לציין את postStartupScriptOption להעברה.
SINGLE_USER ה-GmN הזה מוגדר במצב משתמש יחיד. אפשר לציין את האפשרות serviceAccount להעברה.

שגיאה

הודעת שגיאה בהעברה מציינת שהגדרות מסוימות מונעות את ההעברה האוטומטית של ה-GmN. נדרשת העברה ידנית.

טיפוסים בני מנייה (enum)
ERROR_UNSPECIFIED סוג ברירת המחדל.
CUSTOM_CONTAINER ה-GmN מוגדר עם מאגרי תגים בהתאמה אישית, ואי אפשר להעביר אותו.

Methods

create

 יוצרת סביבת ריצה חדשה בפרויקט ובמיקום נתונים מסוימים.

delete

 מחיקה של סביבת זמן ריצה אחת.

get

 קבלת פרטים של זמן ריצה יחיד.

getIamPolicy

 מקבלת את מדיניות בקרת הגישה למשאב.

list

 הצגת רשימה של סביבות זמן ריצה בפרויקט ובמיקום נתונים.

migrate

 העברה של סביבת זמן ריצה קיימת למופע חדש של Workbench.

patch

 עדכון ההגדרות של זמן הריצה של ה-Notebook.

reportEvent

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

reset

 איפוס של סביבת זמן ריצה של מחברת מנוהלת.

setIamPolicy

 הגדרת מדיניות בקרת הגישה במשאב שצוין.

start

 מפעיל סביבת ריצה של מחברת מנוהלת.

stop

 הפסקת זמן ריצה של מחברת מנוהלת.

switch

 החלפת סביבת ריצה של נוטבוק מנוהל.

testIamPermissions

 הפונקציה מחזירה את ההרשאות שיש למבצע הקריאה במשאב שצוין.