שילוב של הזמנות עם הנחות תמורת התחייבות לשימוש

הנחות תמורת התחייבות לשימוש (CUD) מאפשרות לכם לקבל מחירים מוזלים במיוחד על משאבי Compute Engine בתמורה לחוזי התחייבות לשימוש (שנקראים גם התחייבויות) למשך שנה או 3 שנים. אתם מתחייבים להשתמש בכמות מינימלית של משאבים או להוציא סכום מינימלי, ומקבלים בתמורה הנחות תמורת התחייבות לשימוש על עלויות השימוש במשאבים. עם זאת, התחייבויות לא שומרות קיבולת אזורית למשאבים שהתחייבתם להם. כדי לקבל משאבים אזוריים במחירים מוזלים וגם לוודא שהקיבולת שמורה להם, צריך לרכוש התחייבויות וגם ליצור הזמנות למשאבים האזוריים האלה.

במאמר הזה מוסבר איך מקבלים הנחות תמורת התחייבות לשימוש (CUD) על משאבים מוזמנים, ואיך מקשרים הזמנות להתחייבויות לשימוש במשאבים.

לפני שמתחילים

  • כדאי לעיין במידע הבסיסי על הזמנות, בדרישות ובמגבלות שלהן. מידע נוסף זמין במאמר מידע על הזמנות.
  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

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

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud

    gcloud

    1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

      gcloud init

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  • הגדרת אזור ותחום כברירת מחדל
  • REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

הנחות תמורת התחייבות לשימוש במשאבים שהזמנתם

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

  • אתם לא מקבלים הנחה אחרת על השימוש במשאבים.
  • המכונות הווירטואליות צריכות לצרוך את ההזמנות בזמן שההתחייבויות פעילות.
  • לפחות המאפיינים הבאים צריכים להיות זהים בין ההתחייבויות הפעילות לבין ההזמנות שצורכות מכונות ה-VM:

    • הפרויקט והאזור שבהם הם חלים
    • סדרת משפחות מכונות

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

  • vCPU וזיכרון: כדי לקבל הנחות על שימוש (CUD) על אחד מסוגי המשאבים האלה או על שניהם, אפשר לרכוש התחייבויות לשימוש במשאבים או התחייבויות להוצאה שכוללות את סוגי המשאבים הנדרשים. כשמכונות וירטואליות בפרויקט משתמשות בהזמנות שתואמות למאפיינים של התחייבות פעילה כזו, מערכת Compute Engine מחילה באופן אוטומטי את ההנחות על שימוש שעומד בדרישות.

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

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

  • יחידות GPU ודיסקים מקומיים של SSD: כדי לקבל הנחות CUD על אחד מסוגי המשאבים האלה או על שניהם, צריך לבצע את הפעולות הבאות:

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

    כשמכונות וירטואליות בפרויקט שלכם צורכות את ההזמנות המצורפות האלה, אתם מתחילים לקבל את ההנחות הרלוונטיות תמורת התחייבות לשימוש (CUD) על סוגי המשאבים השמורים האלה. אם מפעילים את חלוקת ההנחות תמורת התחייבות לשימוש ומצרפים הזמנה משותפת, יכול להיות שגם שימוש מפרויקטים אחרים של צרכנים יעמוד בדרישות לקבלת הנחות משותפות תמורת התחייבות לשימוש במשאבים. עם זאת, כדי שהשימוש מפרויקטים אחרים יעמוד בדרישות, צריך להגביל את השיתוף של המקום השמור רק לחשבון לחיוב ב-Cloud שבו ההתחייבויות קיימות. אם בפרויקטים שלא שייכים לאותו חשבון לחיוב ב-Cloud יש שימוש במשאבים שכלולים במקום השמור המשותף, השימוש הזה לא ייכלל בהתחייבויות של החשבון ולא תקבלו את ההנחות, אלא תחויבו לפי תעריף השימוש הרגיל.

צירוף מקומות שמורים להתחייבויות לשימוש במשאבים

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

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

סוגי משאבים שלא צריך לצרף להם הזמנות

לגבי vCPU, זיכרון ודיסקים מקומיים של Titanium SSD לשימוש בסדרות מסוימות של מכונות, לא צריך לצרף הזמנות תואמות להתחייבויות. במיוחד לגבי דיסקים מקומיים מסוג titanium, לא צריך לצרף הזמנות כשרוכשים התחייבויות שרלוונטיות לסדרות המכונות הבאות:

  • H4D מותאם לצריכת מעבד גבוהה (compute-optimized)
  • לשימוש כללי C4
  • לשימוש כללי C4A
  • לשימוש כללי C4D
  • ‫Z3 מותאם לאחסון

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

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

  • אם ההתחייבות שלכם מציינת יותר מסוגי המשאבים האלה מאשר ההזמנות המצורפות, מערכת Compute Engine שומרת קיבולת רק למשאבים שמצוינים בהתחייבות. עם זאת, עדיין תוכלו להשתמש בשארית המשאבים שהתחייבתם להם, בהתאם לזמינות שלהם באזור שלכם.
  • אם בהזמנה שלכם צוינו יותר משאבים מההתחייבות שלכם, עדיין תקבלו הנחות תמורת התחייבות לשימוש רק על השימוש במשאבים שעומדים בדרישות. כשחלוקת ה-CUD מופעלת, ההתחייבויות לשימוש במשאבים בחשבון לחיוב ב-Cloud מצטברות ומוחלות על כל שימוש שעומד בקריטריונים. אם בהזמנות שצירפתם צוינו יותר משאבים ממה שההתחייבויות שלכם יכולות לכסות, יכול להיות שתחויבו על השימוש הנוסף לפי תעריפים של שימוש לפי דרישה.

לדוגמה, כשרוכשים התחייבות ל-4 ליבות וירטואליות ולזיכרון בנפח 30GB, אפשר לבחור באחת מהאפשרויות הבאות:

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

    • ‫4 vCPU וזיכרון בנפח 30 GB
    • ‫2 vCPU וזיכרון בנפח 50 GB
    • ‫10 vCPU וזיכרון בנפח 10 GB

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

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

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

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

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

כשרוכשים התחייבות לשימוש במשאבים האלה שצריכים הזמנות מצורפות, אפשר גם לכלול באותה התחייבות משאבים שלא צריכים הזמנות מצורפות. בתרחישים כאלה, אפשר לבחור באחת מהאפשרויות הבאות:

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

כדי לקבל מידע על רכישת התחייבויות לשימוש ב-GPU או בדיסקים של SSD מקומיים, אפשר לעיין במאמרים הבאים:

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

לדוגמה, נניח שרכשתם התחייבות ל-30 GB של זיכרון ו-4 מעבדי GPU מסוג NVIDIA P100. בהזמנה המצורפת (או בשילוב של הזמנות מצורפות) אפשר לציין כל כמות של vCPU או זיכרון, אבל חייבים להיות בדיוק 4 GPUs מסוג NVIDIA P100. בדוגמה הזו, אי אפשר לצרף הזמנות שמציינות את השילובים הבאים של משאבים:

  • ‫6 יחידות GPU‏ NVIDIA P100
  • ‫2 יחידות GPU מסוג NVIDIA P100
  • ‫4 מעבדי GPU מסוג NVIDIA P100 ו-2 מעבדי GPU מסוג NVIDIA V100
  • ‫4 יחידות GPU מסוג NVIDIA P100 ו-4 דיסקים מקומיים של SSD

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

התנהגות של הזמנות אחרי רכישת התחייבות

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

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

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

רכישת התחייבויות לשימוש במשאבים עם מקומות שמורים מצורפים

כשרוכשים התחייבות חדשה, אפשר לצרף הזמנות להתחייבות באחת מהדרכים הבאות:

אחרי שרוכשים התחייבות, היא הופכת לפעילה ביום שלמחרת בחצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7 במהלך שעון הקיץ). ‫Compute Engine שומר על שיעבוד בפרויקט לכל אזור בפרויקט שבו רכשתם התחייבות. כשרוכשים התחייבות לשימוש חדשה לאזור כלשהו בפרויקט,‏ Compute Engine משייך את מנעול למניעת מחיקה לאותו אזור להתחייבות לשימוש החדשה שנוצרה.

בין מועד הרכישה של ההתחייבות לבין מועד ההפעלה שלה, הסטטוס של ההתחייבות נשאר NOT_YET_ACTIVE (או PENDING במסוףGoogle Cloud ). אחרי ההפעלה, סטטוס ההתחייבות ישתנה לACTIVE. לדוגמה, נניח שרכשתם את ההתחייבות ב-20 בינואר 2024 בשעה 22:00 לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7). ‫Compute Engine יוצר את ההתחייבות באופן מיידי, והסטטוס שלה הוא NOT_YET_ACTIVE. ההתחייבות שלכם תהפוך ל-ACTIVE ב-21 בינואר 2024, בשעה 00:00 לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7).

דרישות

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

  • צריך לרכוש את ההתחייבות וליצור את ההזמנות המצורפות באותו פרויקט ובאותו אזור.
  • אתם צריכים לרכוש את ההתחייבות וליצור את ההזמנות המצורפות למשאבים מאותה סדרה של משפחת מכונות.
  • אם בהתחייבות שלכם צוינו סוגי משאבים שנדרשות להם בקשות שמירת מקום מצורפות, אתם צריכים להשבית את אפשרות המחיקה האוטומטית בבקשות שמירת המקום המצורפות. מידע נוסף על סוגי המשאבים שנדרשת להם הזמנה מצורפת
  • אם ההתחייבות כוללת GPUs, סוג ה-GPU שצוין בהזמנה ובחוזה ההתחייבות חייב להיות זהה.
  • ב-GPU וברוב הדיסקים של SSD מקומי, מספר המשאבים השמורים מכל סוג משאב חייב להיות זהה בדיוק למספר המשאבים שהתחייבתם להשתמש בהם עבור אותו סוג משאב. עם זאת, הדרישה הזו לא רלוונטית אם מציינים בהתחייבות דיסקים מקומיים של Titanium SSD לשימוש עם סוגי מכונות C4,‏ C4A,‏ C4D,‏ H4D או Z3.

    לדוגמה, אם אתם רוצים לרכוש התחייבות ל-4 יחידות GPU מסוג V100 ול-2 דיסקים של SSD מקומי, בהזמנות שמצורפות להתחייבות צריך לציין סך של 4 יחידות GPU מסוג V100 ו-2 דיסקים של SSD מקומי. כמות ה-vCPU והזיכרון שאתם מזמינים יכולה להיות גדולה או קטנה יותר מהכמות שאתם מתחייבים לה. עם זאת, אם תציינו בהתחייבות 4 מעבדי C4A וירטואליים ו-2 דיסקים מקומיים של Titanium SSD, לא תצטרכו לצרף שום הזמנות להתחייבות.

  • לגבי GPU, רוכשים התחייבויות לסוגי ה-GPU הספציפיים שבהם רוצים להשתמש. לדוגמה, אתם יכולים לרכוש התחייבויות ל-NVIDIA P100 או ל-NVIDIA V100, אבל לא תוכלו להשתמש בהתחייבות שנרכשה עבור מעבדי GPU מסוג NVIDIA P100 כדי לכסות מעבדי GPU מסוג NVIDIA V100.

  • אם המקום השמור שצירפתם הוא מקום שמור משותף ואתם רוצים לקבל את ההנחות הרלוונטיות תמורת התחייבות לשימוש כשאתם משתמשים במקום השמור הזה מחוץ לפרויקט שבו ההתחייבות קיימת, אתם צריכים לבצע את שני השלבים הבאים:

    • שתפו את המקומות השמורים רק בין פרויקטים ששייכים לאותו חשבון לחיוב ב-Cloud כמו ההתחייבות.
    • מפעילים את חלוקת ה-CUD בחשבון לחיוב ב-Cloud.

צירוף הזמנות קיימות

אתם יכולים לצרף הזמנות קיימות כשאתם רוכשים התחייבות באמצעות Google Cloud המסוף, Google Cloud CLI או REST.

המסוף

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

  1. נכנסים לדף Committed use discounts במסוף Google Cloud . לדף Committed use discounts

  2. לוחצים על Purchase commitment. יופיע הדף Purchase a commitment (רכישת התחייבות).

  3. בשדה שם, מזינים שם להתחייבות.

  4. בשדה Region (אזור), בוחרים את האזור שבו רוצים לרכוש את ההתחייבות.

  5. בשדה Commitment type, בוחרים את סדרת משפחת המכונות של ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:

    • בסוגי מכונות A2, בוחרים באפשרות Accelerator-optimized A2.
    • בסוגי המכונות A3 Edge ו-A3 High, בוחרים באפשרות Accelerator-optimized A3.
    • לסוגי מכונות A3 Mega, בוחרים באפשרות Accelerator-optimized A3 Mega
    • בסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2
    • בסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4 (מכונות G4 עם אופטימיזציה לגרפיקה).
    • בסוגי מכונות C2, בוחרים באפשרות C2 מותאם לצריכת מעבד גבוהה (compute-optimized).
    • בסוגי מכונות C2D, בוחרים באפשרות C2D מותאם לצריכת מעבד גבוהה (compute-optimized)
    • לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3 (מכונה וירטואלית לשימוש כללי C3).
    • בסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D (C3D למטרות כלליות).
    • לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4 (מכונות לשימוש כללי C4).
    • בסוגי מכונות C4A, בוחרים באפשרות General-Purpose C4A (מכונה וירטואלית לשימוש כללי C4A).
    • לסוגי מכונות C4D, בוחרים באפשרות General-Purpose C4D (מכונות C4D לשימוש כללי).
    • בסוגי מכונות N1, בוחרים באפשרות General-Purpose N1 (לשימוש כללי N1).
    • בסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
    • בסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
    • בסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2 (סוגי מכונות M1/M2 עם אופטימיזציה לזיכרון).
    • בסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3 (מכונה וירטואלית מותאמת לזיכרון M3).
    • לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3

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

    1. מסמנים את התיבה צירוף הזמנה חדשה או קיימת.

    2. לוחצים על צירוף הזמנה קיימת. מופיעה החלונית Attach existing reservations (צירוף הזמנות קיימות) ומוצגות בה הזמנות מהפרויקט. הרשימה הזו מסוננת כך שיוצגו בה רק תוכניות שמתאימות לאזור ולסוג ההתחייבות שציינתם.

    3. בחלונית Attach existing reservations (צירוף הזמנות קיימות), מסמנים את התיבה לצד כל הזמנה שרוצים לצרף.

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

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

  7. בקטע פרטי ההתחייבות, מבצעים את הפעולות הבאות:

    1. בשדה Cores (ליבות), בודקים את הערך שמולא מראש. אפשר גם לציין מספר שונה של vCPU.

    2. בשדה זיכרון, בודקים את נפח הזיכרון שמולא מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25 GB. כדי לציין ערך זיכרון מותאם אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.

    3. מרחיבים את הקטע GPUs and local SSDs ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות שצורפו, באופן הבא:

      1. בשדה סוג ה-GPU, מאמתים את סוג ה-GPU שמולא מראש.

      2. בשדה Number of GPUs (מספר יחידות ה-GPU), בודקים את המספר שמולא מראש של יחידות ה-GPU.

      3. בשדה Local SSDs (כונני SSD מקומיים), בודקים את מספר הדיסקים שמולא מראש.

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

  8. בקטע Term:

    1. כדי לציין את התוכנית של ההתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור הנחת ה-CUD ואת משך התקופה שנקבע מראש של ההתחייבות.

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

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

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

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

  10. כדי לסיים את רכישת ההתחייבות, פועלים לפי השלבים הבאים:

    1. עוברים לחלק התחתון של הדף.

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

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

    4. לוחצים על רכישה.

gcloud

כדי לרכוש התחייבות על ידי צירוף הזמנות קיימות, מריצים את הפקודה gcloud compute commitments create. בפקודה, כוללים את הדגל --existing-reservation כדי לציין הזמנה קיימת שרוצים לצרף להתחייבות. כוללים מופע חדש של הדגל הזה לכל שריון קיים שרוצים לצרף. אפשר לצרף כמה הזמנות קיימות שרוצים להתחייבות.

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

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=PLAN \
    --type=COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

מחליפים את מה שכתוב בשדות הבאים:

  • COMMITMENT_NAME: שם ההתחייבות.
  • REGION: האזור שבו נמצאת ההתחייבות.
  • PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
  • PLAN: תוכנית ההתחייבות, שקובעת את שיעור ה-CUD ואת משך התקופה שמוגדר מראש. מציינים 12-month או 36-month.
  • CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
  • COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים של Local SSD או לשניהם:

    • למכונות מסוג A2, משתמשים ב-accelerator-optimized
    • למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-accelerator-optimized-a3
    • לסוגי מכונות A3 Mega, משתמשים באפשרות accelerator-optimized-a3-mega
    • למכונות מקבוצת G2, משתמשים ב-graphics-optimized
    • לסוגי מכונות G4, משתמשים ב-graphics-optimized-g4
    • לסוגי מכונות C2, משתמשים ב-compute-optimized
    • לסוגי מכונות C2D, משתמשים ב-compute-optimized-c2d
    • לסוגי מכונות C3, משתמשים ב-compute-optimized-c3
    • בסוגי מכונות C3D, משתמשים ב-compute-optimized-c3d
    • לסוגי מכונות N1, משתמשים ב-general-purpose
    • לסוגי מכונות C4, משתמשים ב-general-purpose-c4
    • לסוגי מכונות C4A, משתמשים ב-general-purpose-c4a
    • לסוגי מכונות C4D, משתמשים ב-general-purpose-c4d
    • בסוגי מכונות N2, משתמשים ב-general-purpose-n2
    • לסוגי מכונות N2D, משתמשים ב-general-purpose-n2d
    • לסוגי מכונות M1, משתמשים ב-memory-optimized
    • לסוגי מכונות M3, משתמשים ב-memory-optimized-m3
    • לסוגי מכונות Z3, משתמשים ב-storage-optimized-z3

  • COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.

  • COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות, ב-MB או ב-GB. לדוגמה, 10240MB או 10GB. ב-CLI של gcloud, אפשר לציין את הזיכרון במגה-בייט או בג'יגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

  • COMMITTED_LOCAL_SSD: כמות המקום ב-SSD המקומי שרוצים בהתחייבות, בגיגה-בייט.

  • COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.

  • COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.

  • RESERVATION_NAME_1 ו-RESERVATION_NAME_2: השמות של ההזמנות הקיימות שרוצים לצרף להתחייבות.

  • RESERVATION_ZONE_1 ו-RESERVATION_ZONE_2: האזורים של המקומות השמורים הקיימים שרוצים לצרף להתחייבות.

דוגמה: רכישת התחייבות על ידי צירוף הזמנות קיימות

נניח שיש לכם שתי הזמנות res-01 ו-res-02 באזורים us-central1-a ו-us-central1-b של הפרויקט myproject. נניח שההזמנות האלה כוללות קיבולת משולבת של 4 יחידות GPU מסוג NVIDIA P100 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה לשימוש ב-GPU ובדיסקים של SSD מקומיים, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, מריצים את הפקודה הבאה. ההתחייבות כוללת 96 ליבות vCPU,‏ 624 GB של זיכרון, 4 יחידות NVIDIA P100 GPU ו-1,500 GB של אחסון SSD מקומי (שווה ל-4 דיסקים מקומיים של SSD). ערך האחסון ב-SSD המקומי צריך להיות בגיגה-בייט (לדוגמה, 375GB). ב-CLI של gcloud אפשר לציין את הזיכרון במגה-בייט או בגיגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

כדי לרכוש התחייבות על ידי צירוף של מקומות שמורים קיימים, שולחים בקשת POST אל ה-method‏ regionCommitments.insert. בבקשה, כוללים את השדה existingReservations כדי לציין רשימה מופרדת בפסיקים של כל ההזמנות הקיימות שרוצים לצרף להתחייבות. אתם יכולים לצרף להתחייבות כמה הזמנות קיימות שתרצו.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
  "name": "COMMITMENT_NAME",
  "plan": "PLAN",
  "type": "COMMITMENT_TYPE",
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    },
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLs"
}

מחליפים את מה שכתוב בשדות הבאים:

  • COMMITMENT_NAME: שם ההתחייבות.
  • REGION: האזור שבו נמצאת ההתחייבות.
  • PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
  • PLAN: תוכנית ההתחייבות, שקובעת את שיעור ה-CUD ואת משך התקופה שמוגדר מראש. מציינים TWELVE_MONTH או THIRTY_SIX_MONTH.
  • COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים של Local SSD או לשניהם:

    • למכונות מסוג A2, משתמשים ב-ACCELERATOR_OPTIMIZED
    • למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-ACCELERATOR_OPTIMIZED_A3
    • לסוגי מכונות A3 Mega, משתמשים באפשרות ACCELERATOR_OPTIMIZED_A3_MEGA
    • למכונות מקבוצת G2, משתמשים ב-GRAPHICS_OPTIMIZED
    • לסוגי מכונות G4, משתמשים ב-GRAPHICS_OPTIMIZED_G4
    • לסוגי מכונות C2, משתמשים ב-COMPUTE_OPTIMIZED
    • לסוגי מכונות C2D, משתמשים ב-COMPUTE_OPTIMIZED_C2D
    • לסוגי מכונות C3, משתמשים ב-COMPUTE_OPTIMIZED_C3
    • בסוגי מכונות C3D, משתמשים ב-COMPUTE_OPTIMIZED_C3D
    • לסוגי מכונות N1, משתמשים ב-GENERAL_PURPOSE
    • לסוגי מכונות C4, משתמשים ב-GENERAL_PURPOSE_C4
    • לסוגי מכונות C4A, משתמשים ב-GENERAL_PURPOSE_C4A
    • לסוגי מכונות C4D, משתמשים ב-GENERAL_PURPOSE_C4D
    • בסוגי מכונות N2, משתמשים ב-GENERAL_PURPOSE_N2
    • לסוגי מכונות N2D, משתמשים ב-GENERAL_PURPOSE_N2D
    • לסוגי מכונות M1, משתמשים ב-MEMORY_OPTIMIZED
    • לסוגי מכונות M3, משתמשים ב-MEMORY_OPTIMIZED_M3
    • לסוגי מכונות Z3, משתמשים ב-STORAGE_OPTIMIZED_Z3

  • COMMITTED_VCPUS: מספר ליבות ה-vCPU שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.

  • COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

  • COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי שרוצים בהתחייבות, בגיגה-בייט.

  • COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.

  • COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.

  • CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.

  • END_TIME: חצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7), כהפרש מהזמן האוניברסלי המתואם (UTC). מציינים את הערך הזה רק אם הגדרתם תאריך סיום מותאם אישית להתחייבות. מציינים אחד מהערכים הבאים:

    • במהלך שעון הקיץ: 07:00:00
    • בזמנים אחרים: 08:00:00
  • RESERVATION_URLs: רשימה מופרדת בפסיקים של כתובות URL של ההזמנות הקיימות שרוצים לצרף להתחייבות. לדוגמה, כדי לצרף שתי הזמנות, res-1 ו-res-2, צריך לציין את הפרטים הבאים:

    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
    

דוגמה: רכישת התחייבות על ידי צירוף הזמנות קיימות

נניח שיש לכם שתי הזמנות res-01 ו-res-02 באזורים us-central1-a ו-us-central1-b של הפרויקט myproject. נניח שההזמנות האלה כוללות קיבולת משולבת של 4 יחידות GPU מסוג NVIDIA P100 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה עבור ה-GPU ודיסקי ה-SSD המקומיים האלה, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, שולחים את הבקשה הבאה ל-POST. ההתחייבות כוללת 96 ליבות vCPU,‏ 624 GB של זיכרון, 4 יחידות GPU מסוג NVIDIA P100 ו-1,500 GB של אחסון SSD מקומי. שימו לב: צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (GB). לגבי זיכרון, צריך לציין את הערך ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, ‏ Compute Engine משתמש ב-GB כיחידת ברירת המחדל לזיכרון.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1500",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-b/reservations/res-02"
  ]
}

יצירת הזמנות חדשות לצירוף

אפשר ליצור את ההזמנות המצורפות בזמן רכישת ההתחייבות באמצעות מסוף Google Cloud , Google Cloud CLI או REST.

המסוף

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

  1. נכנסים לדף Committed use discounts במסוף Google Cloud . לדף Committed use discounts

  2. לוחצים על Purchase commitment. יופיע הדף Purchase a commitment (רכישת התחייבות).

  3. בשדה שם, מזינים שם להתחייבות.

  4. בשדה Region (אזור), בוחרים את האזור שבו רוצים לרכוש את ההתחייבות.

  5. בשדה Commitment type, בוחרים את סדרת משפחת המכונות של ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:

    • בסוגי מכונות A2, בוחרים באפשרות Accelerator-optimized A2.
    • בסוגי המכונות A3 Edge ו-A3 High, בוחרים באפשרות Accelerator-optimized A3.
    • לסוגי מכונות A3 Mega, בוחרים באפשרות Accelerator-optimized A3 Mega
    • בסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2
    • בסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4 (מכונות G4 עם אופטימיזציה לגרפיקה).
    • בסוגי מכונות C2, בוחרים באפשרות C2 מותאם לצריכת מעבד גבוהה (compute-optimized).
    • בסוגי מכונות C2D, בוחרים באפשרות C2D מותאם לצריכת מעבד גבוהה (compute-optimized)
    • לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3 (מכונה וירטואלית לשימוש כללי C3).
    • בסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D (C3D למטרות כלליות).
    • לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4 (מכונות לשימוש כללי C4).
    • בסוגי מכונות C4A, בוחרים באפשרות General-Purpose C4A (מכונה וירטואלית לשימוש כללי C4A).
    • לסוגי מכונות C4D, בוחרים באפשרות General-Purpose C4D (מכונות C4D לשימוש כללי).
    • בסוגי מכונות N1, בוחרים באפשרות General-Purpose N1 (לשימוש כללי N1).
    • בסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
    • בסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
    • בסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2 (סוגי מכונות M1/M2 עם אופטימיזציה לזיכרון).
    • בסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3 (מכונה וירטואלית מותאמת לזיכרון M3).
    • לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3

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

    1. מסמנים את התיבה צירוף הזמנה חדשה או קיימת.

    2. לוחצים על יצירת הזמנה חדשה. יופיע החלונית Create a new reservation.

    3. בשדה Name, מזינים שם להזמנה.

    4. אופציונלי: בשדה תיאור, מזינים תיאור.

    5. בשדה Zone, בוחרים את התחום שבו רוצים שהמשאבים השמורים יהיו זמינים.

    6. בקטע Share type, מציינים איך רוצים לשתף את ההזמנה הזו:

      • כדי ליצור הזמנה לפרויקט יחיד, בוחרים באפשרות מקומי.
      • כדי ליצור הזמנה שמשותפת עם כמה פרויקטים, בוחרים באפשרות משותף. אחר כך לוחצים על הוספת פרויקטים ובוחרים את הפרויקטים הרצויים.
    7. בקטע Google Cloud Services (שירותי Google Cloud), מציינים אם לשתף את השמירה הזו עם שירותים אחרים כמו Google Kubernetes Engine או Vertex AI.

    8. בקטע Use with VM instance, בוחרים איך רוצים שהמכונות הווירטואליות ישתמשו בשריון:

      • כדי לאפשר למכונות וירטואליות עם מאפיינים תואמים להשתמש אוטומטית בבקשה הזו, מסמנים את האפשרות Use reservation automatically.
      • כדי להשתמש במשאבים שמתאימים לפרטי הבקשה רק כשמציינים אותה ספציפית (לפי שם), בוחרים באפשרות Select specific reservation.
    9. בקטע Resource details (פרטי המשאב), מבצעים את הפעולות הבאות:

      1. בשדה Number of VM instances (מספר מכונות וירטואליות), מזינים את מספר המכונות הווירטואליות.

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

      3. אופציונלי: אם רוצים לשריין יחידות GPU, לוחצים על הוספת GPU ומציינים את סוג ה-GPU ומספר יחידות ה-GPU לכל מכונה וירטואלית.

      4. אופציונלי: אם רוצים לשריין דיסקים מסוג Local SSD, מציינים את Number of disks (מספר הדיסקים) ואת Interface type (סוג הממשק).

      5. אופציונלי: אם רוצים לציין מדיניות מיקום לקבוצה, בוחרים מדיניות מהרשימה מדיניות מיקום לקבוצה או יוצרים מדיניות.

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

    11. אופציונלי: אם רוצים ליצור ולצרף עוד הזמנות חדשות, לוחצים שוב על יצירת הזמנה חדשה וחוזרים על השלבים האלה.

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

  7. בקטע פרטי ההתחייבות, מבצעים את הפעולות הבאות:

    1. בשדה Cores (ליבות), בודקים את הערך שמולא מראש. אפשר גם לציין מספר שונה של vCPU.

    2. בשדה זיכרון, בודקים את נפח הזיכרון שמולא מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25 GB. כדי לציין ערך זיכרון מותאם אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.

    3. מרחיבים את הקטע GPUs and local SSDs ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות שצורפו, באופן הבא:

      1. בשדה סוג ה-GPU, מאמתים את סוג ה-GPU שמולא מראש.

      2. בשדה Number of GPUs (מספר יחידות ה-GPU), בודקים את המספר שמולא מראש של יחידות ה-GPU.

      3. בשדה Local SSDs (כונני SSD מקומיים), בודקים את מספר הדיסקים שמולא מראש.

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

  8. בקטע Term:

    1. כדי לציין את התוכנית של ההתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור הנחת ה-CUD ואת משך התקופה שנקבע מראש של ההתחייבות.

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

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

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

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

  10. כדי לסיים את רכישת ההתחייבות, פועלים לפי השלבים הבאים:

    1. עוברים לחלק התחתון של הדף.

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

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

    4. לוחצים על רכישה.

gcloud

כדי ליצור את המקומות השמורים המצורפים בזמן רכישת ההתחייבות, מריצים את הפקודה gcloud compute commitments create.

בהתאם לכך שרוצים לצרף הזמנה אחת או כמה הזמנות, מריצים את הפקודה באחת מהדרכים הבאות:

  • כדי ליצור הזמנה אחת ולצרף אותה להתחייבות, מגדירים את המאפיינים של ההזמנה המצורפת על ידי הרצת הפקודה הבאה:

    gcloud compute commitments create COMMITMENT_NAME \
        --region=REGION \
        --project=PROJECT_ID \
        --plan PLAN \
        --type COMMITMENT_TYPE
        --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
        --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
        --custom-end-time=CUSTOM_END_DATE \
        --reservation=RESERVATION_NAME \
        --reservation-zone=RESERVATION_ZONE \
        --machine-type=RESERVED_MACHINE_TYPE \
        --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
        --vm-count=NUMBER_OF_RESERVED_VMs \
        --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
        --local-ssd=interface=INTERFACE_1,size=375 \
        --local-ssd=interface=INTERFACE_2,size=375 \
        --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
        --share-setting=SHARE_SETTING \
        --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
    
  • כדי ליצור כמה הזמנות ולצרף אותן להתחייבות, מגדירים את המאפיינים של ההזמנה באמצעות קובץ YAML, ואז מציינים את קובץ ה-YAML בפקודה שבה משתמשים כדי לרכוש את ההתחייבות. אופציונלי, אפשר גם להשתמש בגישה של קובץ YAML כדי ליצור ולצרף הזמנה אחת להתחייבות. כדי ליצור הזמנות מצורפות בשיטה הזו:

    1. יוצרים את קובץ ה-YAML בספרייה הנוכחית ומציינים את ההגדרה הרצויה לכל הזמנה מצורפת. לדוגמה, כדי להגדיר הזמנה משותפת שמשותפת עם שני פרויקטים ומציינת יחידות GPU, שני דיסקים מקומיים מסוג SSD ופלטפורמת CPU מינימלית, צריך לכלול את הטקסט הבא בקובץ ה-YAML:

      - reservation: RESERVATION_NAME
        reservation_zone: RESERVATION_ZONE
        require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
        vm_count: NUMBER_OF_RESERVED_VMs
        machine_type: RESERVED_MACHINE_TYPE
        accelerator:
        - count: RESERVED_ACCELERATOR_COUNT
          type: RESERVED_ACCELERATOR_TYPE
        localssd:
        - interface: INTERFACE_1
          size: 375
        - interface: INTERFACE_2
          size: 375
        project: OWNER_PROJECT_ID
        minimum-cpu-platform: MINIMUM_CPU_PLATFORM
        share-setting: SHARE_SETTING
        share-with:
        - CONSUMER_PROJECT_ID_1
        - CONSUMER_PROJECT_ID_2
      
      

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

    2. מריצים את הפקודה gcloud compute commitments create וכוללים את הדגל --reservation-from-file.

      gcloud compute commitments create COMMITMENT_NAME \
          --region REGION \
          --project PROJECT_ID \
          --plan PLAN \
          --type COMMITMENT_TYPE \
          --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
          --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
          --reservations-from-file=YAML_FILE
      

מחליפים את הערכים הבאים במאפיינים המתאימים של ההתחייבות ושל ההזמנות המצורפות:

משך המינוי

  • COMMITMENT_NAME: שם ההתחייבות.
  • REGION: האזור שבו נמצאת ההתחייבות.
  • PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
  • PLAN: תוכנית ההתחייבות, שקובעת את שיעור ה-CUD ואת משך התקופה שמוגדר מראש. מציינים 12-month או 36-month.
  • CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
  • COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:

    • למכונות מסוג A2, משתמשים ב-accelerator-optimized
    • למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-accelerator-optimized-a3
    • לסוגי מכונות A3 Mega, משתמשים באפשרות accelerator-optimized-a3-mega
    • למכונות מקבוצת G2, משתמשים ב-graphics-optimized
    • לסוגי מכונות G4, משתמשים ב-graphics-optimized-g4
    • לסוגי מכונות C2, משתמשים ב-compute-optimized
    • לסוגי מכונות C2D, משתמשים ב-compute-optimized-c2d
    • לסוגי מכונות C3, משתמשים ב-compute-optimized-c3
    • בסוגי מכונות C3D, משתמשים ב-compute-optimized-c3d
    • לסוגי מכונות N1, משתמשים ב-general-purpose
    • לסוגי מכונות C4, משתמשים ב-general-purpose-c4
    • לסוגי מכונות C4A, משתמשים ב-general-purpose-c4a
    • לסוגי מכונות C4D, משתמשים ב-general-purpose-c4d
    • בסוגי מכונות N2, משתמשים ב-general-purpose-n2
    • לסוגי מכונות N2D, משתמשים ב-general-purpose-n2d
    • לסוגי מכונות M1, משתמשים ב-memory-optimized
    • לסוגי מכונות M3, משתמשים ב-memory-optimized-m3
    • לסוגי מכונות Z3, משתמשים ב-storage-optimized-z3

  • COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.

  • COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות, ב-MB או ב-GB. לדוגמה, 10GB או 10240MB. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

  • COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי, שצריך לציין ב-GB. לדוגמה, 375GB.

  • COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.

  • COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.

  • YAML_FILE: הנתיב לקובץ ה-YAML שמכיל את ההגדרות של ההזמנות המצורפות.

הזמנות מצורפות

  • RESERVATION_NAME: השם של ההזמנה המצורפת.
  • RESERVATION_ZONE: האזור של ההזמנה המצורפת.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: מציין אם ההזמנה המצורפת היא הזמנה שמכוונת למשאב ספציפי. הערכים האפשריים הם true או false. מידע נוסף על הזמנות שמכוונות באופן ספציפי זמין במאמר איך עובדות הזמנות.
  • NUMBER_OF_RESERVED_VMS: מספר המכונות הווירטואליות שרוצים לשריין בהזמנה המצורפת.
  • RESERVED_MACHINE_TYPE: סוג המכונה שרוצים למכונות הווירטואליות בהזמנה המצורפת.

    • לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
    • לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של סוגי מכונות בהתאמה אישית.

      מחליפים את מה שכתוב בשדות הבאים:

      • MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
      • CPUS: מספר vCPUs.
      • MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, והערך שלו צריך להיות ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדים וירטואליים ו-5 GB של זיכרון, כלומר 5,120 MB, משתמשים ב-n2-custom-4-5120.
  • RESERVED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה המצורפת.

  • RESERVED_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף להזמנה המצורפת.

  • INTERFACE_1 ו-INTERFACE_2: סוג הממשק שרוצים שדיסקים מקומיים של SSD בכל מכונה וירטואלית שמורה ישתמשו בו. האפשרויות התקפות הן: scsi ו-nvme. חוזרים על הפרמטר local_ssd לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים מסוג Local SSD.

  • OWNER_PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנה שצורפה. מציינים את השדה הזה אם רוצים לשתף את ההזמנה המצורפת בין כמה פרויקטים של צרכנים.

  • MINIMUM_CPU_PLATFORM: פלטפורמת ה-CPU המינימלית שרוצים לציין להזמנה המצורפת.

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

  • CONSUMER_PROJECT_ID_1 ו-CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לשתף את ההזמנה הזו, לדוגמה project-1 ו-project-2. אפשר לכלול עד 100 פרויקטים לצרכנים. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. אל תכללו את מזהה הפרויקט שבו אתם יוצרים את ההזמנה הזו, כי לפרויקט הזה יש הרשאה להשתמש בהזמנה הזו כברירת מחדל. אם רוצים ליצור הזמנה לפרויקט מסוים, צריך להשמיט את השדות האלה.

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

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

דוגמאות

בדוגמאות הבאות מוסבר איך לרכוש התחייבות לשימוש ב-GPU, בדיסקים של SSD מקומיים או בשניהם, על ידי יצירת הזמנות חדשות לצירוף להתחייבות הזו.

דוגמה 1: רכישת התחייבות לשימוש במעבדי GPU על ידי צירוף הזמנה חדשה אחת

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות (או במשאבי GPU) באזור us-central1 עם 96 ליבות vCPU,‏ 624 GB של זיכרון ו-4 יחידות GPU של NVIDIA V100. אתם רוצים ליצור הזמנה חדשה reservation-01 בתחום us-central1-a ששומרת 2 n1-standard-32 מכונות וירטואליות (כל מכונה וירטואלית עם 32 ליבות וירטואליות, זיכרון של 120GB ו-2 יחידות GPU של NVIDIA V100) כדי לצרוך את המשאבים האלה שהתחייבתם להם. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור המצורף, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

דוגמה 2: רכישת התחייבות לשימוש ב-GPU בלי לציין vCPU או זיכרון

כדי להתחייב לשימוש ב-GPU ובדיסקים של SSD מקומיים ולשריין אותם בלי להתחייב לשימוש ב-vCPU או בזיכרון, צריך לציין 0 כערך של כמות ה-vCPU והזיכרון. לדוגמה, נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבי GPU באזור us-west2 עם 0 vCPU,‏ 0 GB זיכרון ו-1 NVIDIA P4 GPU. אתם רוצים גם ליצור הזמנה חדשה reservation-01 באזור us-west2-b שבו תתבצע הזמנה של מכונה וירטואלית אחת n1-standard-2 (עם 2 ליבות vCPU, זיכרון של 7.5 GB ו-GPU אחד מסוג NVIDIA P4) כדי לצרף אותה להתחייבות. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור שמשויך אליה, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

דוגמה 3: רכישת התחייבות לשימוש ב-GPU ובדיסקים של SSD מקומי על ידי צירוף של כמה הזמנות חדשות

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות (או במשאבי GPU ו-SSD מקומיים) באזור us-central1. אתם רוצים התחייבות ל-96 ליבות vCPU, ל-624 GB של זיכרון, ל-GPU אחד מסוג NVIDIA V100 ול-750 GB של אחסון ב-SSD מקומי (שמתאים ל-2 דיסקים מקומיים של SSD). בנוסף, רוצים ליצור ולצרף שתי הזמנות בus-central1-aאזור. בהזמנה הראשונה, res-01, רוצים להזמין מכונה וירטואלית אחת (עם 2 vCPU, זיכרון בנפח 7.5GB ו-GPU אחד מסוג NVIDIA V100). זוהי הזמנה ממוקדת.n1-standard-2 בהזמנה השנייה, res-02, רוצים להזמין מכונה וירטואלית אחת (עם 8 ליבות vCPU וזיכרון של 30 GB) ולצרף 2 דיסקים מסוג Local SSD (ממשק SCSI אחד וממשק NVMe אחד).n1-standard-8

כדי לרכוש את ההתחייבות לדוגמה הזו עם ההזמנות המצורפות, קודם יוצרים את קובץ ה-YAML עם המאפיינים של שתי ההזמנות באופן הבא:

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

אחרי שיוצרים את קובץ ה-YAML, מריצים את הפקודה הבאה כדי להשלים את רכישת ההתחייבות עם ההזמנות שצורפו אליה. ערך האחסון של SSD מקומי צריך להיות בגיגה-בייט (לדוגמה, 375GB). ב-CLI של gcloud אפשר לציין את הזיכרון במגה-בייט או בגיגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, ‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל לזיכרון.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

כדי ליצור מקומות שמורים מצורפים בזמן רכישת ההתחייבות, שולחים בקשת POST אל ה-method‏ regionCommitments.insert. בבקשה, כוללים את השדה reservations כדי להגדיר רשימה של כל ההזמנות החדשות שרוצים ליצור ולצרף. אתם יכולים לצרף להתחייבות כמה הזמנות קיימות שתרצו.

  • כדי ליצור את ההזמנה החדשה על ידי ציון ידני של כל המאפיינים של המכונה הווירטואלית, צריך לכלול את השדה instanceProperties ולהשמיט את השדה sourceInstanceTemplate.

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
    
    {
    "name": "COMMITMENT_NAME",
    "plan": "PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
      {
        "amount": "COMMITTED_VCPUS",
        "type": "VCPU"
      },
      {
        "amount": "COMMITTED_MEMORY",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
        "amount": "COMMITTED_ACCELERATOR_COUNT",
        "type": "ACCELERATOR"
      },
      {
        "amount": "COMMITTED_LOCAL_SSD",
        "type": "LOCAL_SSD"
      }
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
    "reservations":
    [
      {
        "name": "RESERVATION_NAME",
        "specificReservation":
        {
          "count": "NUMBER_OF_RESERVED_VMS",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
                "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "RESERVED_INTERFACE_1"
              },
              {
                "diskSizeGb": "375",
                "interface": "RESERVED_INTERFACE_2"
              }
            ],
            "machineType": "RESERVED_MACHINE_TYPE",
            "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
          }
        },
        "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
        "zone": "RESERVED_ZONE",
        "shareSettings":
        {
          "shareType": "SPECIFIC_PROJECTS",
          "projectMap":
          {
            "CONSUMER_PROJECT_ID_1":
            {
              "projectId": "CONSUMER_PROJECT_ID_1"
            },
            "CONSUMER_PROJECT_ID_2":
            {
              "projectId": "CONSUMER_PROJECT_ID_2"
            }
          }
        }
      }
    ]
    }
    
    
  • כדי ליצור הזמנה חדשה באמצעות ציון תבנית של הגדרות מכונה, צריך לכלול את השדה sourceInstanceTemplate ולהחריג את השדה instanceProperties.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
    
    {
    "name": "COMMITMENT_NAME",
    "plan": "PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
      {
        "amount": "COMMITTED_VCPUS",
        "type": "VCPU"
      },
      {
        "amount": "COMMITTED_MEMORY",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
        "amount": "COMMITTED_ACCELERATOR_COUNT",
        "type": "ACCELERATOR"
      },
      {
        "amount": "COMMITTED_LOCAL_SSD",
        "type": "LOCAL_SSD"
      }
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
    "reservations":
    [
      {
        "name": "RESERVATION_NAME",
        "specificReservation":
        {
          "count": "NUMBER_OF_RESERVED_VMS",
          "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
        },
        "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
        "zone": "RESERVED_ZONE",
        "shareSettings":
        {
          "shareType": "SPECIFIC_PROJECTS",
          "projectMap":
          {
            "CONSUMER_PROJECT_ID_1":
            {
              "projectId": "CONSUMER_PROJECT_ID_1"
            },
            "CONSUMER_PROJECT_ID_2":
            {
              "projectId": "CONSUMER_PROJECT_ID_2"
            }
          }
        }
      }
    ]
    }
    
    

מחליפים את הערכים הבאים במאפיינים המתאימים של ההתחייבות ושל ההזמנות המצורפות:

משך המינוי

  • COMMITMENT_NAME: שם ההתחייבות.
  • REGION: האזור שבו נמצאת ההתחייבות.
  • PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
  • PLAN: תוכנית ההתחייבות, שקובעת את שיעור ה-CUD ואת משך התקופה שמוגדר מראש. מציינים TWELVE_MONTH או THIRTY_SIX_MONTH.
  • COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:

    • למכונות מסוג A2, משתמשים ב-ACCELERATOR_OPTIMIZED
    • למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-ACCELERATOR_OPTIMIZED_A3
    • לסוגי מכונות A3 Mega, משתמשים באפשרות ACCELERATOR_OPTIMIZED_A3_MEGA
    • למכונות מקבוצת G2, משתמשים ב-GRAPHICS_OPTIMIZED
    • לסוגי מכונות G4, משתמשים ב-GRAPHICS_OPTIMIZED_G4
    • לסוגי מכונות C2, משתמשים ב-COMPUTE_OPTIMIZED
    • לסוגי מכונות C2D, משתמשים ב-COMPUTE_OPTIMIZED_C2D
    • לסוגי מכונות C3, משתמשים ב-COMPUTE_OPTIMIZED_C3
    • בסוגי מכונות C3D, משתמשים ב-COMPUTE_OPTIMIZED_C3D
    • לסוגי מכונות N1, משתמשים ב-GENERAL_PURPOSE
    • לסוגי מכונות C4, משתמשים ב-GENERAL_PURPOSE_C4
    • לסוגי מכונות C4A, משתמשים ב-GENERAL_PURPOSE_C4A
    • לסוגי מכונות C4D, משתמשים ב-GENERAL_PURPOSE_C4D
    • בסוגי מכונות N2, משתמשים ב-GENERAL_PURPOSE_N2
    • לסוגי מכונות N2D, משתמשים ב-GENERAL_PURPOSE_N2D
    • לסוגי מכונות M1, משתמשים ב-MEMORY_OPTIMIZED
    • לסוגי מכונות M3, משתמשים ב-MEMORY_OPTIMIZED_M3
    • לסוגי מכונות Z3, משתמשים ב-STORAGE_OPTIMIZED_Z3

  • COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.

  • COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

  • COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי שרוצים בהתחייבות, בגיגה-בייט.

  • COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.

  • COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.

  • CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.

  • END_TIME: חצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7), כהפרש מהזמן האוניברסלי המתואם (UTC). מציינים את הערך הזה רק אם הגדרתם תאריך סיום מותאם אישית להתחייבות. מציינים אחד מהערכים הבאים:

    • במהלך שעון הקיץ: 07:00:00
    • בזמנים אחרים: 08:00:00

הזמנות מצורפות

  • RESERVATION_NAME: השם של ההזמנה המצורפת.
  • RESERVATION_ZONE: האזור של ההזמנה המצורפת.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: מציין אם ההזמנה המצורפת היא הזמנה שמכוונת למשאב ספציפי. הערכים האפשריים הם true או false. מידע נוסף על הזמנות שמכוונות באופן ספציפי זמין במאמר איך עובדות הזמנות.
  • NUMBER_OF_RESERVED_VMS: מספר המכונות הווירטואליות שרוצים לשריין בהזמנה המצורפת.
  • RESERVED_MACHINE_TYPE: סוג המכונה שרוצים למכונות הווירטואליות בהזמנה המצורפת.

    • לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
    • לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של סוגי מכונות בהתאמה אישית.

      מחליפים את מה שכתוב בשדות הבאים:

      • MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
      • CPUS: מספר vCPUs.
      • MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, וצריך לציין אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדים וירטואליים וזיכרון בנפח 5 GB, ששווה ל-5,120 MB, משתמשים ב-n2-custom-4-5120.
  • RESERVED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה המצורפת.

  • RESERVED_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף להזמנה המצורפת.

  • INTERFACE_1 ו-INTERFACE_2: סוג הממשק שבו רוצים להשתמש בדיסקים של SSD מקומי לכל מכונה וירטואלית שמורה. האפשרויות התקפות הן: scsi ו-nvme. חוזרים על הפרמטר localSsds לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים מסוג Local SSD.

  • MINIMUM_CPU_PLATFORM: פלטפורמת ה-CPU המינימלית שרוצים לציין להזמנה המצורפת.

  • INSTANCE_TEMPLATE_NAME: השם של תבנית של הגדרות מכונה שרוצים להשתמש בה כדי ליצור את המקום השמור המצורף.

  • SHARE_SETTING: סוג השיתוף של ההזמנה המצורפת. אם רוצים לשתף את ההזמנה המצורפת בין כמה פרויקטים של צרכנים, צריך לציין בשדה הזה את הערך SPECIFIC_PROJECTS. אם רוצים ליצור הזמנה לפרויקט יחיד, צריך להחריג את השדה הזה.

  • CONSUMER_PROJECT_ID_1 ו-CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לחלוק את ההזמנה הזו. לדוגמה, project-1 ו-project-2. אפשר לכלול עד 100 פרויקטים לצרכנים. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. אל תכללו את מזהה הפרויקט שבו אתם יוצרים את ההזמנה הזו, כי לפרויקט הזה יש הרשאה להשתמש בהזמנה הזו כברירת מחדל. אם רוצים ליצור הזמנה לפרויקט יחיד, צריך להחריג את השדות האלה.

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

דוגמאות

בדוגמאות הבאות מוסבר איך לרכוש התחייבות לשימוש ב-GPU, בדיסקים של SSD מקומיים או בשניהם, על ידי יצירת הזמנות חדשות לצירוף להתחייבות הזו.

דוגמה 1: רכישת התחייבות לשימוש במעבדי GPU על ידי צירוף הזמנה חדשה אחת

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות באזור us-central1, שכוללת 96 ליבות vCPU, זיכרון בנפח 624GB (ששווה ל-638,976MB) ו-4 יחידות GPU מסוג NVIDIA V100. אתם רוצים ליצור הזמנה חדשה reservation-01 באזור us-central1-a ששומרת מקום ל-2 מכונות וירטואליות n1-standard-8 (כל מכונה וירטואלית עם 8 ליבות vCPU, זיכרון של 30 GB ו-2 יחידות GPU של NVIDIA V100) כדי לצרף אותן להתחייבות הזו. כדי לרכוש את ההתחייבות לדוגמה הזו עם ההזמנה המצורפת, שולחים את הבקשה הבאה של POST. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

דוגמה 2: רכישת התחייבות לשימוש ב-GPU בלי לציין vCPU או זיכרון

כדי להתחייב לשימוש ב-GPU ובדיסקים של SSD מקומיים ולשריין אותם בלי להתחייב לשימוש ב-vCPU או בזיכרון, צריך לציין 0 כערך של כמות ה-vCPU והזיכרון. לדוגמה, נניח שאתם רוצים לרכוש התחייבות לשנה רק למשאבי GPU באזור us-west2, עם 0 vCPU,‏ 0 MB זיכרון ו-4 יחידות NVIDIA P4 GPU. אתם רוצים גם ליצור הזמנה חדשה reservation-01באזור us-west2-b, שתשמור מקום למכונה וירטואלית אחת מסוג n1-standard-2 (עם 2 ליבות vCPU, זיכרון בנפח 7.5 GB ו-4 יחידות GPU מסוג NVIDIA P4) כדי לצרף אותה להתחייבות. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור שמצורף אליה, שולחים את בקשת POST הבאה. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

דוגמה 3: רכישת התחייבות לשימוש ב-GPU ובדיסקים של SSD מקומי על ידי צירוף של כמה הזמנות חדשות

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות באזור us-central1, עם 96 ליבות vCPU, ‏ 624 GB של זיכרון (ששווים ל-638,976 MB),‏ NVIDIA V100 GPU אחד ו-750 GB של אחסון SSD מקומי. אתם רוצים גם ליצור שתי הזמנות ולצרף אותן לאזור us-central1-a. בהזמנה הראשונה, res-01, רוצים להזמין מכונה וירטואלית אחת n1-standard-2 (עם 2 vCPU, זיכרון של 7.5 GB ו-GPU אחד של NVIDIA V100). זוהי הזמנה ממוקדת. בהזמנה השנייה, res-02, אתם רוצים להזמין מכונה וירטואלית אחת n1-standard-8 (עם 8 ליבות vCPU וזיכרון של 30 GB) ולצרף 2 דיסקים מקומיים של SSD (ממשק SCSI אחד וממשק NVMe אחד). כדי לרכוש את ההתחייבות לדוגמה הזו עם המקומות השמורים המצורפים, שולחים את הבקשה הבאה POST. שימו לב: צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (GB). לגבי זיכרון, צריך לציין את הערך ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, ‏ Compute Engine משתמש ב-GB כיחידת ברירת המחדל לזיכרון.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "750",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

החלפת מקומות שמורים שמצורפים להתחייבויות

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

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

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

שינויים מותרים

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

  • אפשר לשריין מכונות וירטואליות מסוג מכונה אחר. עם זאת, עדיין צריך להזמין מכונות וירטואליות מאותה סדרת מכונות כדי להמשיך לקבל הנחות על שימוש בהתחייבות על המשאבים המוזמנים.
  • אפשר לשנות את מספר המכונות הווירטואליות שרוצים לשריין.
  • אתם יכולים לשנות את הכמות של כרטיסי ה-GPU ודיסקי ה-SSD המקומיים שמצורפים לכל מכונה וירטואלית, כל עוד הכמות הכוללת של כרטיסי ה-GPU ודיסקי ה-SSD המקומיים ששמרתם נשארת זהה.
  • אתם יכולים לציין שההזמנות שהוחלפו יהיו הזמנות לפרויקט יחיד (נקראות גם מקומיות במסוף Google Cloud ) או הזמנות משותפות.

דרישות

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

  • אפשר להחליף רק הזמנה מצורפת אחת בכל פעם בהזמנה מצורפת חדשה אחת בלבד. כדי להחליף הזמנה מצורפת, מסירים בו-זמנית הזמנה מצורפת קיימת על ידי הגדרת מספר המכונות הווירטואליות שלה ל-0, ומגדירים הזמנה מצורפת חדשה שרוצים להחליף אותה.
  • ההזמנה החדשה צריכה להיות באותו פרויקט כמו ההתחייבות.
  • ההזמנה החדשה צריכה להיות באותו אזור שבו נמצאה ההזמנה שהוסרה.
  • הכמות והסוגים של יחידות ה-GPU שצוינו בהזמנה החדשה צריכים להיות זהים לאלה של ההזמנה שהוסרה.
  • המספרים והסוגים של דיסקים מסוג Local SSD שצוינו בהזמנה החדשה צריכים להיות זהים לאלה שצוינו בהזמנה שהוסרה.
  • אפשר לשנות עד 100 מכונות וירטואליות בכל בקשה. כדי לבצע שינוי שכולל יותר מ-100 מכונות וירטואליות, צריך לחלק את השינוי לכמה בקשות קטנות יותר או לפנות אל Google Cloud התמיכה.

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

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

איך מחליפים הזמנה מצורפת

אפשר להחליף את ההזמנות של התחייבות באמצעות Google Cloud CLI או REST.

gcloud

כדי להחליף הזמנות שמצורפות להתחייבויות:

  1. יוצרים קובץ YAML בספרייה הנוכחית עם ההגדרות של ההזמנות הבאות שצורפו:

    • ההזמנה הנוכחית שרוצים להחליף.

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

    • ההזמנה החדשה להחלפה.

    התוכן של קובץ ה-YAML דומה לזה:

    - reservation: CURRENT_RESERVATION_NAME
      reservation_zone: CURRENT_RESERVATION_ZONE
      vm_count: 0
      machine_type: CURRENT_RESERVATION_MACHINE_TYPE
      accelerator:
      - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
        type: CURRENT_RESERVATION_ACCELERATOR_TYPE
      local_ssd:
      - interface: CURRENT_RESERVATION_INTERFACE_1
        size: 375
      - interface: CURRENT_RESERVATION_INTERFACE_2
        size: 375
      project: CURRENT_RESERVATION_PROJECT_ID
      share_setting: CURRENT_RESERVATION_SHARE_SETTING
      share_with:
      - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
      - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
    - reservation: REPLACEMENT_RESERVATION_NAME
      reservation_zone: REPLACEMENT_RESERVATION_ZONE
      vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
      machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
      accelerator:
      - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
        type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
      local_ssd:
      - interface: REPLACEMENT_RESERVATION_INTERFACE_1
        size: 375
      - interface: REPLACEMENT_RESERVATION_INTERFACE_2
        size: 375
      project: REPLACEMENT_RESERVATION_PROJECT_ID
      share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
      share_with:
      - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
      - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
    
    

    מחליפים את הערכים הבאים במאפיינים המתאימים של ההזמנות הנוכחיות וההזמנות החלופיות:

    ההזמנה הנוכחית

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

    • CURRENT_RESERVATION_NAME: השם של ההזמנה הנוכחית שמצורפת.
    • CURRENT_RESERVATION_ZONE: האזור של ההזמנה הנוכחית שמצורפת.
    • CURRENT_RESERVATION_MACHINE_TYPE: סוג המכונה של ההזמנה הנוכחית שמצורפת.
    • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שהוזמנו בהזמנה המצורפת הנוכחית.
    • CURRENT_RESERVATION_ACCELERATOR_TYPE: סוג המאיץ שהוזמן בהזמנה הנוכחית המצורפת.
    • CURRENT_RESERVATION_INTERFACE_1 ו-CURRENT_RESERVATION_INTERFACE_2: סוג הממשק של דיסק ה-SSD המקומי לכל שימוש במכונת VM ששמור בהזמנה המצורפת הנוכחית. האפשרויות התקפות הן: scsi ו-nvme. כל דיסק SSD מקומי הוא בנפח 375GB. חוזרים על הפרמטר local_ssd לכל הדיסקים המקומיים של SSD שהוזמנו.
    • CURRENT_RESERVATION_PROJECT_ID: מזהה הפרויקט הנוכחי שכולל את ההתחייבות ואת ההזמנה שצורפה אליה. מציינים את השדה הזה אם ההזמנה המצורפת הנוכחית משותפת בין כמה פרויקטים של צרכנים.
    • CURRENT_RESERVATION_SHARE_SETTING: סוג השיתוף של ההזמנה הנוכחית. אם ההזמנה המצורפת הנוכחית משותפת בין כמה פרויקטים של צרכנים, צריך לציין בשדה הזה את הערך projects.
    • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 ו-CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שאתם משתפים איתם את ההזמנה הנוכחית שצורפה, למשל project-1 ו-project-2.

    הזמנה חלופית

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

    • REPLACEMENT_RESERVATION_NAME: השם של ההזמנה החדשה להחלפה.
    • REPLACEMENT_RESERVATION_ZONE: האזור של ההזמנה החדשה להחלפה.
    • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: מספר המכונות הווירטואליות שרוצים לשריין בשריין החדש במקום הקיים.
    • REPLACEMENT_RESERVATION_MACHINE_TYPE: סוג המכונה שרוצים להגדיר למכונות הווירטואליות בהזמנה החדשה להחלפה.

      • לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
      • לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של סוגי מכונות בהתאמה אישית.

      מחליפים את מה שכתוב בשדות הבאים:

      • MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
      • CPUS: מספר vCPUs.
      • MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, וצריך לציין אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 vCPU ו-5 GB של זיכרון, שהם 5,120 MB, משתמשים בפקודה n2-custom-4-5120.
    • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה החלופית.

    • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף בהזמנה החלופית.

    • REPLACEMENT_RESERVATION_INTERFACE_1 ו-REPLACEMENT_RESERVATION_INTERFACE_2: סוג הממשק שרוצים שמכונת ה-VM השמורה תשתמש בו עבור דיסקים של SSD מקומי. האפשרויות התקפות הן: scsi ו-nvme. כל דיסק SSD מקומי הוא בנפח 375 GB. חוזרים על הפרמטר local_ssd לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים מסוג Local SSD.

    • REPLACEMENT_RESERVATION_PROJECT_ID: מזהה הפרויקט הנוכחי שכולל את ההתחייבות ואת ההזמנה שצורפה אליה. מציינים את השדה הזה אם רוצים לשתף את ההזמנה החלופית בין כמה פרויקטים של צרכנים.

    • REPLACEMENT_RESERVATION_SHARE_SETTING: סוג השיתוף של ההזמנה החלופית. אם רוצים לשתף את הזמנת ההחלפה בכמה פרויקטים של צרכנים, צריך לציין בשדה הזה את הערך projects.

    • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 ו-REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לשתף את ההזמנה הזו, לדוגמה project-1,project-2. אפשר לכלול עד 100 פרויקטים לצרכן. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. לא כוללים את REPLACEMENT_RESERVATION_PROJECT_ID, שכבר מורשה להשתמש בהזמנה הזו כברירת מחדל.

  2. מריצים את הפקודה gcloud beta compute commitments update-reservations ומציינים את הנתיב לקובץ ה-YAML באמצעות הדגל --reservations-from-file.

    gcloud beta compute commitments update-reservations COMMITMENT_NAME \
        --project= PROJECT_ID \
        --region= REGION \
        --reservations-from-file= YAML_FILE
    

    מחליפים את מה שכתוב בשדות הבאים:

    • COMMITMENT_NAME: השם של ההתחייבות עם ההזמנה המצורפת.
    • PROJECT_ID: מזהה הפרויקט של ההתחייבות עם ההזמנה שצורפה.
    • REGION: האזור שבו נמצאת ההתחייבות.
    • YAML_FILE: הנתיב לקובץ ה-YAML שמכיל את התצורה של המקומות השמורים הנוכחיים והמקומות השמורים שיחליפו אותם.

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

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

דוגמה להתחייבות עם מקום שמור מצורף

לדוגמה, נניח שרוצים לעדכן את ההזמנות שצורפו להתחייבות my-commitment-with-reservations, שנרכשה באמצעות הפקודה הבאה:

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

בדוגמה הזו, נניח שכשהפקודה הזו הופעלה, one-reservation.yaml היה קובץ בספרייה הנוכחית עם התוכן הבא, שמגדיר הזמנה מצורפת בשם res-1.

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

ההתחייבות הזו my-commitment-with-reservations וההזמנה המצורפת res-1 הביאו לשימוש במשאבים הבאים:

סוג המשאב משאבים במינוי
(my-commitment-with-reservations)
משאבים בהזמנה המצורפת הנוכחית
(res-1)
מעבדים וירטואליים וזיכרון ‫16 vCPU ו-60 GB ‫16 vCPU ו-60 GB
(4 מכונות וירטואליות שמורות)n1-standard-4*
יחידות GPU ‫4 יחידות GPU מדגם P100 ‫4 מעבדים גרפיים (GPU) מסוג P100
(מעבד גרפי אחד מסוג P100 לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים של SSD מקומי
(750 GB או 2 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*

* באופן ספציפי, בהזמנה לדוגמה שצורפה, res-1, מוזמנות 4 מכונות וירטואליות, כל אחת עם יחידת GPU‏ P100 אחת ו-2 דיסקים מקומיים מסוג SSD של scsiממשק.n1-standard-4 n1-standard-4 סוג המכונה משתמש ב-4 ליבות וירטואליות וב-15 GB לכל מכונת VM.

החלפת ההזמנה לדוגמה שצורפה

נניח שאתם רוצים להחליף את ההזמנה המצורפת res-1 בחדשה res-2 ולשנות את המשאבים המוזמנים כך:

סוג המשאב משאבים במינוי
(my-commitment-with-reservations)
משאבים בהזמנה המצורפת הנוכחית
(res-1)
משאבים בהזמנה המצורפת להחלפה
(res-2)
מעבדים וירטואליים וזיכרון ‫16 vCPU ו-60 GB ‫16 vCPU ו-60 GB
(4 מכונות וירטואליות שמורות)n1-standard-4*
‫16 מעבדים וירטואליים ו-60 GB
(2 מכונות וירטואליות שמורות ומשותפות)n1-standard-8
יחידות GPU ‫4 יחידות GPU מדגם P100 ‫4 מעבדים גרפיים (GPU) מסוג P100
(מעבד גרפי אחד מסוג P100 לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
‫4 יחידות GPU‏ P100
(2 יחידות GPU‏ P100 לכל מכונה וירטואלית, ל-2 מכונות וירטואליות)
דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים של SSD מקומי
(750 GB או 2 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
‫3,000 GB או 8 דיסקים של SSD מקומי
(1,500 GB או 4 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-2 מכונות וירטואליות)*

* באופן ספציפי, בהזמנה לדוגמה שצורפה, res-1, מוזמנות 4 מכונות וירטואליות, כל אחת עם יחידת GPU‏ P100 אחת ו-2 דיסקים מקומיים מסוג SSD של scsiממשק.n1-standard-4 n1-standard-4 סוג המכונה משתמש ב-4 ליבות וירטואליות וב-15 GB לכל מכונת VM.

בפרט, ההזמנה המצורפת להחלפה מגדירה את res-2, שמזמין 2 מכונות וירטואליות מסוג n1-standard-8, כל אחת עם GPU מסוג P100 ו-4 דיסקים של Local SSD מסוג ממשק scsi. בנוסף, res-2 משותף עם עוד 2 פרויקטים, project-1 ו-project-2, והוא בבעלות הפרויקט הנוכחי, my-project. סוג המכונה n1-standard-8 משתמש ב-8 vCPU וב-30 GB לכל מכונה וירטואלית.

כדי להחליף את ההזמנה המצורפת res-1 ב-res-2 עבור ההתחייבות my-commitment-with-reservations:

  1. יוצרים קובץ בשם two-reservations.yaml בספרייה הנוכחית עם התוכן הבא:

    - reservation: res-1
      reservation_zone: asia-east1-a
      vm_count: 0
      machine_type: n1-standard-4
      accelerator:
      - count: 1
        type: nvidia-tesla-p100
      local_ssd:
      - interface: scsi
        size: 375
      - interface: scsi
        size: 375
    - reservation: res-2
      reservation_zone: asia-east1-a
      vm_count: 2
      machine_type: n1-standard-8
      accelerator:
      - count: 2
        type: nvidia-tesla-p100
      project: my-project
      share_setting: projects
      share_with:
      - project-1
      - project-2
      local_ssd:
      - interface: scsi
        size: 375
      - interface: scsi
        size: 375
      - interface: scsi
        size: 375
      - interface: scsi
        size: 375
    
  2. מריצים את הפקודה הבאה:

    gcloud beta compute commitments update-reservations my-commitment-with-reservations \
        --region=asia-east1 \
        --reservations-from-file=two-reservations.yaml
    

REST

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

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

מחליפים את הערכים הבאים במאפיינים המתאימים של ההתחייבות, של השריון הנוכחי ושל השריון החדש:

משך המינוי

  • COMMITMENT_NAME: השם של ההתחייבות עם ההזמנה המצורפת.
  • PROJECT_ID: מזהה הפרויקט של ההתחייבות עם ההזמנה שצורפה. זה גם מזהה הפרויקט של ההזמנות הנוכחיות והמצורפות.
  • COMMITMENT_ZONE: האזור של ההתחייבות עם ההזמנה שצורפה.

ההזמנה הנוכחית

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

  • CURRENT_RESERVATION_NAME: השם של ההזמנה הנוכחית שמצורפת.
  • CURRENT_RESERVATION_ZONE: האזור של ההזמנה הנוכחית שמצורפת.
  • CURRENT_RESERVATION_MACHINE_TYPE: סוג המכונה של ההזמנה הנוכחית שמצורפת.
  • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שהוזמנו בהזמנה המצורפת הנוכחית.
  • CURRENT_RESERVATION_ACCELERATOR_TYPE: סוג המאיץ שהוזמן בהזמנה הנוכחית המצורפת.
  • CURRENT_RESERVATION_INTERFACE_1 ו-CURRENT_RESERVATION_INTERFACE_2: סוג הממשק שבו דיסקים מסוג SSD מקומי לכל מכונת VM מוזמנת משתמשים בהזמנה המצורפת הנוכחית. האפשרויות התקפות הן: scsi ו-nvme. כל דיסק SSD מקומי הוא בנפח 375 GB. חוזרים על הפרמטר localSsds לכל הדיסקים המקומיים של SSD שהוזמנו.
  • CURRENT_RESERVATION_SHARE_SETTING: סוג השיתוף של ההזמנה הנוכחית. אם ההזמנה המצורפת הנוכחית משותפת בין כמה פרויקטים של צרכנים, צריך לציין את הפרמטר הזה עם הערך projects.
  • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 ו-CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שאתם משתפים איתם את ההזמנה הנוכחית שצורפה, למשל project-1 ו-project-2.

הזמנה חלופית

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

  • REPLACEMENT_RESERVATION_NAME: השם של ההזמנה החדשה במקום ההזמנה הקיימת.
  • REPLACEMENT_RESERVATION_ZONE: האזור של ההזמנה החדשה להחלפה.
  • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: מספר המכונות הווירטואליות שרוצים לשריין בהזמנה החדשה.
  • REPLACEMENT_RESERVATION_MACHINE_TYPE: סוג המכונה שרוצים להגדיר למכונות הווירטואליות בהזמנה החדשה להחלפה.

    • לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
    • לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של סוגי מכונות בהתאמה אישית.

    מחליפים את מה שכתוב בשדות הבאים:

    • MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
    • CPUS: מספר vCPUs.
    • MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, וצריך לציין אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדים וירטואליים ו-5 GB של זיכרון, שהם 5,120 MB, משתמשים ב-n2-custom-4-5120.
  • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה החלופית.

  • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף בהזמנה החלופית.

  • REPLACEMENT_RESERVATION_INTERFACE_1 ו-REPLACEMENT_RESERVATION_INTERFACE_2: סוג הממשק שבו רוצים להשתמש בדיסקים של SSD מקומי לכל מכונת VM שמורה. האפשרויות התקפות הן: scsi ו-nvme. כל דיסק SSD מקומי הוא בנפח 375 GB. חוזרים על הפרמטר localSsds לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים של SSD מקומי.

  • REPLACEMENT_RESERVATION_SHARE_SETTING: סוג השיתוף של ההזמנה החלופית. אם רוצים לשתף את ההזמנה החלופית בכמה פרויקטים של צרכנים, צריך לציין את הפרמטר הזה עם הערך projects.

  • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 ו-REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לשתף את ההזמנה הזו, לדוגמה project-1,project-2. אפשר לכלול עד 100 פרויקטים לצרכן. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. לא כוללים את PROJECT_ID, שכבר מורשה להשתמש בהזמנה הזו כברירת מחדל.

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

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

דוגמה להתחייבות עם מקום שמור מצורף

לדוגמה, נניח שאתם רוצים להחליף את ההזמנה המצורפת res-1 להתחייבות my-commitment-with-reservations, שנרכשה באמצעות שליחת בקשת POST הבאה:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

ההתחייבות הזו my-commitment-with-reservations וההזמנה המצורפת res-1 הביאו לשימוש במשאבים הבאים:

סוג המשאב משאבים במינוי
(my-commitment-with-reservations)
משאבים בהזמנה המצורפת הנוכחית
(res-1)
מעבדים וירטואליים וזיכרון ‫16 vCPU ו-60 GB ‫16 vCPU ו-60 GB
(4 מכונות וירטואליות שמורות)n1-standard-4*
יחידות GPU ‫4 יחידות GPU מדגם P100 ‫4 מעבדים גרפיים (GPU) מסוג P100
(מעבד גרפי אחד מסוג P100 לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים של SSD מקומי
(750 GB או 2 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*

*בפרט, בהזמנה לדוגמה שמצורפת, res-1, מוזמנות 4 מכונות וירטואליות, שלכל אחת מהן יש GPU מסוג P100 ו-2 דיסקים של SSD מקומי מסוג ממשק scsi.n1-standard-4 n1-standard-4 סוג המכונה משתמש ב-4 ליבות וירטואליות וב-15 GB לכל מכונת VM.

החלפת ההזמנה לדוגמה שצורפה

נניח שאתם רוצים להחליף את ההזמנה המצורפת res-1 בחדשה res-2 ולשנות את המשאבים המוזמנים כך:

סוג המשאב משאבים במינוי
(my-commitment-with-reservations)
משאבים בהזמנה המצורפת הנוכחית
(res-1)
משאבים בהזמנה המצורפת להחלפה
(res-2)
מעבדים וירטואליים וזיכרון ‫16 vCPU ו-60 GB ‫16 vCPU ו-60 GB
(4 מכונות וירטואליות שמורות)n1-standard-4*
‫16 מעבדים וירטואליים ו-60 GB
(2 מכונות וירטואליות שמורות ומשותפות)n1-standard-8
יחידות GPU ‫4 יחידות GPU מדגם P100 ‫4 מעבדים גרפיים (GPU) מסוג P100
(מעבד גרפי אחד מסוג P100 לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
‫4 יחידות GPU‏ P100
(2 יחידות GPU‏ P100 לכל מכונה וירטואלית, ל-2 מכונות וירטואליות)
דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים מקומיים מסוג SSD ‫3,000 GB או 8 דיסקים של SSD מקומי
(750 GB או 2 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-4 מכונות וירטואליות)*
‫3,000 GB או 8 דיסקים של SSD מקומי
(1,500 GB או 4 דיסקים של SSD מקומי לכל מכונה וירטואלית, ל-2 מכונות וירטואליות)*

* באופן ספציפי, בהזמנה לדוגמה שצורפה, res-1, מוזמנות 4 מכונות וירטואליות, כל אחת עם יחידת GPU‏ P100 אחת ו-2 דיסקים מקומיים מסוג SSD של scsiממשק.n1-standard-4 n1-standard-4 סוג המכונה משתמש ב-4 ליבות וירטואליות וב-15 GB לכל מכונת VM.

בפרט, ההזמנה המצורפת להחלפה מגדירה את res-2, שמזמין 2 מכונות וירטואליות מסוג n1-standard-8, כל אחת עם GPU מסוג P100 ו-4 דיסקים של Local SSD מסוג ממשק scsi. בנוסף, res-2 משותף עם עוד 2 פרויקטים, project-1 ו-project-2, והוא בבעלות הפרויקט הנוכחי, my-project. סוג המכונה n1-standard-8 משתמש ב-8 יחידות vCPU וב-30 GB לכל מכונה וירטואלית.

כדי להחליף את ההזמנה המצורפת res-1 ב-res-2 במסגרת ההתחייבות my-commitment-with-reservations, שולחים את בקשת POST הבאה באמצעות השיטה regionCommitments.updateReservations:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }

המאמרים הבאים