Method: projects.locations.runtimes.migrate

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

בקשת HTTP

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

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

פרמטרים
name

string

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

לצורך הרשאה נדרשת אחת או יותר מההרשאות הבאות ב-IAM במשאב שצוין name:

  • notebooks.runtimes.get
  • notebooks.instances.create

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "network": string,
  "subnet": string,
  "serviceAccount": string,
  "requestId": string,
  "postStartupScriptOption": enum (PostStartupScriptOption)
}
שדות
network

string

זה שינוי אופציונלי. השם של ה-VPC שבו נמצא המופע החדש. הפעולה הזו נדרשת אם סביבת זמן הריצה משתמשת ברשת שמנוהלת על ידי Google. אם סביבת זמן הריצה משתמשת ברשת בבעלות הלקוח, היא תשתמש מחדש באותו VPC, והשדה הזה צריך להיות ריק. פורמט: projects/{projectId}/global/networks/{network_id}
subnet

string

זה שינוי אופציונלי. השם של רשת המשנה שבה נמצא המופע החדש. הפעולה הזו נדרשת אם סביבת זמן הריצה משתמשת ברשת שמנוהלת על ידי Google. אם סביבת זמן הריצה משתמשת ברשת בבעלות הלקוח, היא תשתמש מחדש באותה רשת משנה, והשדה הזה צריך להיות ריק. פורמט: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
serviceAccount

string

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

string

זה שינוי אופציונלי. מזהה ייחודי אוניברסלי (UUID) של בקשה אידמפוטנטית.
postStartupScriptOption

enum (PostStartupScriptOption)

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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

PostStartupScriptOption

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

טיפוסים בני מנייה (enum)
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED לא צוינה אפשרות לסקריפט לטעינה בזמן ההפעלה. ברירת המחדל היא POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP לא להעביר את הסקריפט לטעינה בזמן ההפעלה למופע החדש של סביבת העבודה.
POST_STARTUP_SCRIPT_OPTION_RERUN מורידים מחדש את אותו סקריפט לטעינה בזמן ההפעלה ומריצים אותו כמו מחברת Google מנוהלת.