REST Resource: projects.locations.instances

משאב: מכונה

ההגדרה של מכונת ה-notebook.

ייצוג ב-JSON 
{
  "name": string,
  "proxyUri": string,
  "instanceOwners": [
    string
  ],
  "creator": string,
  "state": enum (State),
  "upgradeHistory": [
    {
      object (UpgradeHistoryEntry)
    }
  ],
  "id": string,
  "healthState": enum (HealthState),
  "healthInfo": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "disableProxyAccess": boolean,
  "labels": {
    string: string,
    ...
  },
  "thirdPartyProxyUrl": string,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "enableThirdPartyIdentity": boolean,
  "enableManagedEuc": boolean,
  "enableDeletionProtection": boolean,

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

string

פלט בלבד. מזהה. השם של מופע ה-Notebook הזה. פורמט: projects/{projectId}/locations/{location}/instances/{instanceId}
proxyUri

string

פלט בלבד. נקודת הקצה של ה-proxy שמשמשת לגישה לנוטבוק של Jupyter.
instanceOwners[]

string

זה שינוי אופציונלי. הבעלים של המופע הזה אחרי שהוא נוצר. פורמט: alias@example.com

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

string

פלט בלבד. כתובת האימייל של הישות ששלחה את הבקשה המקורית של instances.create.
state

enum (State)

פלט בלבד. המצב של המופע הזה.
upgradeHistory[]

object (UpgradeHistoryEntry)

פלט בלבד. היסטוריית השדרוגים של המכונה הזו.
id

string

פלט בלבד. המזהה הייחודי של המשאב.
healthState

enum (HealthState)

פלט בלבד. ‫healthState של המכונה.
healthInfo

map (key: string, value: string)

פלט בלבד. מידע נוסף על תקינות המופע. דוגמה:

healthInfo": {
  "docker_proxy_agent_status": "1",
  "docker_status": "1",
  "jupyterlab_api_status": "-1",
  "jupyterlab_status": "-1",
  "updated": "2020-10-18 09:40:03.573409"
}

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
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".
disableProxyAccess

boolean

זה שינוי אופציונלי. אם הערך הוא True, מופע המחברת לא יירשם בשרת ה-proxy.
labels

map (key: string, value: string)

זה שינוי אופציונלי. תוויות להחלה על המופע הזה. אפשר לשנות את ההגדרות האלה בהמשך באמצעות השיטה instances.patch.

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

string

פלט בלבד. נקודת הקצה של ה-proxy של מאגרי כוח העבודה שמשמשת לגישה לקובץ ה-notebook של Jupyter.
satisfiesPzs

boolean

פלט בלבד. שמור לשימוש עתידי להפרדת אזורים.
satisfiesPzi

boolean

פלט בלבד. שמור לשימוש עתידי לבידוד אזורים.
enableThirdPartyIdentity

boolean

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

boolean

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

boolean

זה שינוי אופציונלי. אם הערך הוא true, ההגנה מפני מחיקה תופעל עבור מופע Workbench הזה. אם הערך הוא False, ההגנה מפני מחיקה תושבת עבור מופע Workbench הזה.
הגדרות של מכונת ה-Notebook. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
gceSetup

object (GceSetup)

זה שינוי אופציונלי. הגדרת Compute Engine לנוטבוק. שימוש בשדות שמוגדרים ב-Notebook.
סוף השדות הבלעדיים.

GceSetup

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

ייצוג ב-JSON 
{
  "machineType": string,
  "minCpuPlatform": string,
  "acceleratorConfigs": [
    {
      object (AcceleratorConfig)
    }
  ],
  "serviceAccounts": [
    {
      object (ServiceAccount)
    }
  ],
  "bootDisk": {
    object (BootDisk)
  },
  "dataDisks": [
    {
      object (DataDisk)
    }
  ],
  "shieldedInstanceConfig": {
    object (ShieldedInstanceConfig)
  },
  "networkInterfaces": [
    {
      object (NetworkInterface)
    }
  ],
  "disablePublicIp": boolean,
  "tags": [
    string
  ],
  "metadata": {
    string: string,
    ...
  },
  "systemMetadata": {
    string: string,
    ...
  },
  "enableIpForwarding": boolean,
  "gpuDriverConfig": {
    object (GPUDriverConfig)
  },
  "confidentialInstanceConfig": {
    object (ConfidentialInstanceConfig)
  },
  "instanceId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "vmImage": {
    object (VmImage)
  },
  "containerImage": {
    object (ContainerImage)
  }
  // End of mutually exclusive fields.
}
שדות
machineType

string

זה שינוי אופציונלי. סוג המכונה של המכונה הווירטואלית. https://cloud.google.com/compute/docs/machine-resource
minCpuPlatform

string

זה שינוי אופציונלי. פלטפורמת ה-CPU המינימלית לשימוש במופע הזה. רשימת הערכים התקינים זמינה בכתובת https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform#availablezones
acceleratorConfigs[]

object (AcceleratorConfig)

זה שינוי אופציונלי. מאיצי החומרה שנעשה בהם שימוש במופע הזה. אם אתם משתמשים במאיצים, ודאו שההגדרה שלכם כוללת מספיק מעבדי vCPU וזיכרון כדי לתמוך ב-machineType שבחרתם. בשלב הזה יש תמיכה רק בהגדרת תאוצה אחת.
serviceAccounts[]

object (ServiceAccount)

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

object (BootDisk)

זה שינוי אופציונלי. דיסק האתחול של המכונה הווירטואלית.
dataDisks[]

object (DataDisk)

זה שינוי אופציונלי. דיסקים של נתונים שמצורפים למכונת ה-VM. בשלב הזה יש תמיכה רק בדיסק נתונים אחד.
shieldedInstanceConfig

object (ShieldedInstanceConfig)

זה שינוי אופציונלי. הגדרה של מכונה וירטואלית מוגנת. תמונות שמשתמשות בתכונות נתמכות של מכונות וירטואליות מוגנות.
networkInterfaces[]

object (NetworkInterface)

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

boolean

זה שינוי אופציונלי. אם הערך הוא True, לא תוקצה כתובת IP חיצונית למכונה הווירטואלית הזו.
tags[]

string

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

map (key: string, value: string)

זה שינוי אופציונלי. מטא-נתונים בהתאמה אישית להחלה על המופע הזה.

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

map (key: string, value: string)

פלט בלבד. מייצג מטא-נתונים שמנוהלים על ידי המערכת עבור המופע הזה: קבוצת המשנה של metadata שהמפתחות שלה הם מפתחות מערכת מוכרים של Workbench.

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

boolean

זה שינוי אופציונלי. דגל להפעלה או להשבתה של העברת IP, ברירת המחדל היא false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward
gpuDriverConfig

object (GPUDriverConfig)

זה שינוי אופציונלי. הגדרות של דרייברים של GPU.
confidentialInstanceConfig

object (ConfidentialInstanceConfig)

זה שינוי אופציונלי. הגדרת מופע סודי.
instanceId

string

פלט בלבד. המזהה הייחודי של משאב המכונה ב-Compute Engine.
סוג התמונה, שיכול להיות אחת מהאפשרויות הבאות: תמונת מכונת VM או קובץ אימג' של קונטיינר. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
vmImage

object (VmImage)

זה שינוי אופציונלי. משתמשים בתמונה של מכונה וירטואלית ב-Compute Engine כדי להפעיל את מחברת Jupyter.
containerImage

object (ContainerImage)

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

AcceleratorConfig

הגדרת מאיץ למכונת VM. הגדרה של מאיץ חומרה. שימו לב: אין בדיקה של שילובים של type ו-coreCount. אין תמיכה ב-TPU. כדי למצוא שילוב תקין, אפשר לעיין במאמר בנושא GPUs on Compute Engine.

ייצוג ב-JSON 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
שדות
type

enum (AcceleratorType)

זה שינוי אופציונלי. סוג המאיץ.
coreCount

string (int64 format)

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

AcceleratorType

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

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

הוצא משימוש: במקומו צריך להשתמש ב-NVIDIA_TESLA_T4 (N1) או ב-NVIDIA_L4 (G2). ‫Compute Engine מוציא משימוש את ה-GPU‏ 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_A100_80GB סוג המאיץ הוא Nvidia Tesla A100 - 80GB.
NVIDIA_L4 סוג המאיץ הוא Nvidia Tesla L4.
NVIDIA_H100_80GB סוג המאיץ הוא Nvidia Tesla H100 – 80GB.
NVIDIA_H100_MEGA_80GB סוג המאיץ הוא Nvidia Tesla H100 - MEGA 80GB.
NVIDIA_H200_141GB סוג המאיץ הוא Nvidia Tesla H200 – 141GB.
NVIDIA_TESLA_T4_VWS סוג המאיץ הוא NVIDIA Tesla T4 Virtual Workstations.
NVIDIA_TESLA_P100_VWS

הוצא משימוש: במקומו צריך להשתמש ב-NVIDIA_TESLA_T4_VWS. ‫Compute Engine מוציא משימוש את NVIDIA Tesla P100 GPU (תחנות עבודה וירטואליות) בכל המערכת, והוא כבר לא זמין למופעים חדשים.
NVIDIA_TESLA_P4_VWS סוג המאיץ הוא NVIDIA Tesla P4 Virtual Workstations.
NVIDIA_B200 סוג המאיץ הוא NVIDIA B200.
NVIDIA_RTX6000 ‫NVIDIA RTX 6000.

ServiceAccount

חשבון שירות שמשמש כזהות.

ייצוג ב-JSON 
{
  "email": string,
  "scopes": [
    string
  ]
}
שדות
email

string

זה שינוי אופציונלי. כתובת האימייל של חשבון השירות.
scopes[]

string

פלט בלבד. רשימת ההיקפים שיהיו זמינים לחשבון השירות הזה. הערך מוגדר על ידי CLH ל-https://www.googleapis.com/auth/cloud-platform

VmImage

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

ייצוג ב-JSON 
{
  "project": string,
  "imageDescription": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "name": string,
  "family": string
  // End of mutually exclusive fields.
}
שדות
project

string

חובה. השם של הפרויקט בענן של Google שאליו שייך קובץ האימג' של המכונה הווירטואלית. פורמט: {projectId}
imageDescription

string

פלט בלבד. תיאור קריא לאנשים של התמונה שפועלת במופע (לדוגמה, Debian 11, Python 3.10), שנוצר בזמן הקריאה מתוך הגדרת הגרסה של התמונה (מקור האמת). מגדירים את האפשרות 'מותאם אישית' לתמונות של דיסק אתחול שלא מזוהות.
ההפניה לקובץ אימג' חיצוני של מכונה וירטואלית ב-Compute Engine. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
name

string

זה שינוי אופציונלי. משתמשים בשם של אימג' של מכונה וירטואלית כדי למצוא את האימג'.
family

string

זה שינוי אופציונלי. משתמשים במשפחת תמונות ה-VM הזו כדי למצוא את התמונה. התמונה הכי חדשה במשפחה הזו תשמש אתכם.
סוף השדות הבלעדיים.

ContainerImage

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

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

string

חובה. הנתיב למאגר של קובץ אימג' של קונטיינר. לדוגמה: gcr.io/{projectId}/{imageName}
tag

string

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

BootDisk

ההגדרה של דיסק אתחול.

ייצוג ב-JSON 
{
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string
}
שדות
diskSizeGb

string (int64 format)

זה שינוי אופציונלי. גודל דיסק האתחול ב-GB שמצורף למופע הזה, עד למקסימום של 64,000GB ‏ (64TB). אם לא מציינים ערך, ברירת המחדל היא הערך המומלץ של 150GB.
diskType

enum (DiskType)

זה שינוי אופציונלי. מציין את סוג הדיסק.
diskEncryption

enum (DiskEncryption)

זה שינוי אופציונלי. שיטת הצפנת הדיסק שמשמשת בדיסקים של האתחול והנתונים, ברירת המחדל היא GMEK.
kmsKey

string

זה שינוי אופציונלי. מפתח KMS שמשמש להצפנת הדיסקים. רלוונטי רק אם diskEncryption הוא CMEK. פורמט: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

מידע נוסף על שימוש במפתחות הצפנה משלכם

DiskType

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

טיפוסים בני מנייה (enum)
DISK_TYPE_UNSPECIFIED לא הוגדר סוג הדיסק.
PD_STANDARD סוג של דיסק מתמיד סטנדרטי.
PD_SSD סוג הדיסק המתמיד שמבוסס על SSD.
PD_BALANCED סוג דיסק אחסון מתמיד מאוזן.
PD_EXTREME סוג דיסק אחסון מתמיד מסוג Extreme.
HYPERDISK_BALANCED מייצג את סוג דיסק האחסון המתמיד המאוזן Hyperdisk Balanced. אפשר להשתמש בו כדיסק אתחול או כדיסק נתונים.
HYPERDISK_EXTREME מייצג את סוג הדיסק לאחסון מתמיד Hyperdisk Extreme. אפשר להשתמש בו רק כדיסק נתונים.
HYPERDISK_THROUGHPUT מייצג את סוג הדיסק המתמיד Hyperdisk Throughput. אפשר להשתמש בו רק כדיסק נתונים.
HYPERDISK_BALANCED_HIGH_AVAILABILITY מייצג את סוג הדיסק המתמיד Hyperdisk Balanced High Availability. אפשר להשתמש בו כדיסק אתחול או כדיסק נתונים.
HYPERDISK_ML מייצג את סוג הדיסק המתמיד Hyperdisk ML. אפשר להשתמש בו כדיסק אתחול או כדיסק נתונים.

DiskEncryption

הגדרה של אפשרויות הצפנת הדיסק.

טיפוסים בני מנייה (enum)
DISK_ENCRYPTION_UNSPECIFIED לא צוינה הצפנת דיסק.
GMEK שימוש במפתחות הצפנה בניהול Google להצפנת דיסק האתחול.
CMEK שימוש במפתחות הצפנה בניהול הלקוח כדי להצפין את דיסק האתחול.

DataDisk

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

ייצוג ב-JSON 
{
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string,
  "resourcePolicies": [
    string
  ]
}
שדות
diskSizeGb

string (int64 format)

זה שינוי אופציונלי. גודל הדיסק ב-GB שמצורף למופע של המכונה הווירטואלית הזו, עד למקסימום של 64,000GB ‏ (64TB). אם לא מציינים ערך, ברירת המחדל היא 100.
diskType

enum (DiskType)

זה שינוי אופציונלי. מציין את סוג הדיסק.
diskEncryption

enum (DiskEncryption)

זה שינוי אופציונלי. שיטת הצפנת הדיסק שמשמשת בדיסקים של האתחול והנתונים, ברירת המחדל היא GMEK.
kmsKey

string

זה שינוי אופציונלי. מפתח KMS שמשמש להצפנת הדיסקים. רלוונטי רק אם diskEncryption הוא CMEK. פורמט: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

מידע נוסף על שימוש במפתחות הצפנה משלכם
resourcePolicies[]

string

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

ShieldedInstanceConfig

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

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

boolean

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

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

boolean

זה שינוי אופציונלי. ההגדרה קובעת אם ה-vTPM מופעל במכונת ה-VM.
enableIntegrityMonitoring

boolean

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

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

NetworkInterface

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

ייצוג ב-JSON 
{
  "network": string,
  "subnet": string,
  "nicType": enum (NicType),
  "accessConfigs": [
    {
      object (AccessConfig)
    }
  ],
  "internalIp": string
}
שדות
network

string

זה שינוי אופציונלי. השם של ה-VPC שבו נמצאת המכונה הווירטואלית הזו. פורמט: projects/{projectId}/global/networks/{network_id}
subnet

string

זה שינוי אופציונלי. השם של רשת המשנה שבה נמצאת המכונה הווירטואלית הזו. פורמט: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
nicType

enum (NicType)

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

object (AccessConfig)

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

string

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

NicType

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

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

AccessConfig

הגדרת גישה שמצורפת לממשק הרשת של מכונה.

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

string

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

GPUDriverConfig

הגדרה של דרייבר GPU

ייצוג ב-JSON 
{
  "enableGpuDriver": boolean,
  "customGpuDriverPath": string
}
שדות
enableGpuDriver

boolean

זה שינוי אופציונלי. האם משתמש הקצה מאשר ל-Google Cloud להתקין מנהל התקן של GPU במכונת ה-VM הזו. אם השדה הזה ריק או מוגדר כ-False, מנהל ההתקן של ה-GPU לא יותקן. רלוונטי רק למכונות עם GPU.
customGpuDriverPath

string

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

ConfidentialInstanceConfig

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

ייצוג ב-JSON 
{
  "confidentialInstanceType": enum (ConfidentialInstanceType)
}
שדות
confidentialInstanceType

enum (ConfidentialInstanceType)

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

ConfidentialInstanceType

סוג המופע הסודי.

טיפוסים בני מנייה (enum)
CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED לא צוין סוג. אין להשתמש בערך הזה.
SEV ‫AMD Secure Encrypted Virtualization.

מדינה

ההגדרה של המצבים של המופע הזה.

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

UpgradeHistoryEntry

הערך של היסטוריית השדרוגים של תמונות מכונות וירטואליות.

ייצוג ב-JSON 
{
  "snapshot": string,
  "vmImage": string,
  "containerImage": string,
  "framework": string,
  "version": string,
  "state": enum (State),
  "createTime": string,
  "action": enum (Action),
  "targetVersion": string
}
שדות
snapshot

string

זה שינוי אופציונלי. קובץ ה-snapshot של דיסק האתחול של מופע ה-notebook הזה לפני השדרוג.
vmImage

string

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

string

זה שינוי אופציונלי. קובץ אימג' של קונטיינר לפני שדרוג המופע הזה.
framework

string

זה שינוי אופציונלי. המסגרת של מכונת ה-notebook.
version

string

זה שינוי אופציונלי. הגרסה של מופע ה-notebook לפני השדרוג הזה.
state

enum (State)

פלט בלבד. המצב של רשומת היסטוריית השדרוג של המופע הזה.
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".
action

enum (Action)

זה שינוי אופציונלי. פעולה. חזרה לגרסה קודמת או שדרוג.
targetVersion

string

זה שינוי אופציונלי. גרסת המכונה הווירטואלית לטירגוט, כמו m63.

מדינה

ההגדרה של המצבים של רשומה בהיסטוריית השדרוגים.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוין מצב.
STARTED השדרוג של המופע מתחיל.
SUCCEEDED השדרוג של המופע בוצע בהצלחה.
FAILED שדרוג המופע נכשל.

פעולה

ההגדרה של הפעולות ברשומה הזו בהיסטוריית השדרוגים.

טיפוסים בני מנייה (enum)
ACTION_UNSPECIFIED לא צוינה פעולה.
UPGRADE שדרוג.
ROLLBACK רולבק.

HealthState

מצב התקינות של המכונה.

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

Methods

checkUpgradability

 בודקת אם אפשר לשדרג את מופע ה-Notebook.

create

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

delete

 מחיקה של מופע יחיד.

diagnose

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

get

 קבלת פרטים של מופע יחיד.

getConfig

 הפונקציה מחזירה פרמטרים שונים של הגדרות.

getIamPolicy

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

list

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

patch

 ‫UpdateInstance מעדכן מכונה.

reset

 איפוס של מכונת ה-notebook.

resizeDisk

 שינוי הגודל של דיסק של מופע Notebook לקיבולת גבוהה יותר.

restore

 ‫RestoreInstance משחזרת מכונה מ-BackupSource.

rollback

 החזרה של מחברת לגרסה הקודמת.

setIamPolicy

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

start

 מפעיל מכונת notebook.

stop

 הפסקת מכונת notebook.

testIamPermissions

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

upgrade

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