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

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

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

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

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

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי 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 .

התפקידים הנדרשים

כדי לקבל את ההרשאה שנדרשת לרכישת התחייבויות מבוססות-משאבים, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Compute Admin (roles/compute.admin) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.commitments.create, שנדרשת כדי לרכוש התחייבויות מבוססות-משאבים.

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

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

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

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

אחרי שרוכשים התחייבות, היא הופכת לפעילה ביום שלמחרת בחצות לפי שעון החוף המערבי בארה"ב ובקנדה (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).

המסוף

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

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

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

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

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

  5. בשדה Commitment type, בוחרים את סדרת משפחת המכונות של ההתחייבות. עבור vCPU, זיכרון או שניהם, אפשר לבחור מבין סוגי ההתחייבות הבאים:

    • בסוגי מכונות 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)
    • לסוגי מכונות H3, בוחרים באפשרות Compute-optimized H3
    • למכונות וירטואליות מסוג H4D, בוחרים באפשרות H4D מותאם לצריכת מעבד גבוהה.
    • לסוגי מכונות 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 לשימוש כללי).
    • בסוגי מכונות E2, בוחרים באפשרות General-Purpose E2 (לשימוש כללי E2).
    • בסוגי מכונות N1, בוחרים באפשרות General-Purpose N1 (לשימוש כללי N1).
    • בסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
    • בסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
    • בסוגי מכונות N4, בוחרים באפשרות General-Purpose N4
    • בסוגי מכונות N4D, בוחרים באפשרות General-Purpose N4D (לשימוש כללי N4D).
    • בסוגי מכונות N4A, בוחרים באפשרות General-Purpose N4A
    • לסוגי מכונות Tau T2D, בוחרים באפשרות General-Purpose T2D (‏T2D לשימוש כללי).
    • בסוגי מכונות M1 או M2, בוחרים באפשרות Memory-optimized M1/M2 (מכונות M1/M2 עם אופטימיזציה לזיכרון).
    • בסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3 (מכונה וירטואלית מותאמת לזיכרון M3).
    • בסוגי מכונות M4, בוחרים באפשרות Memory-optimized M4 (מכונה וירטואלית M4 מותאמת לזיכרון).
    • לסוגי מכונות M4 עם זיכרון של 6 TB, בוחרים באפשרות Memory-optimized M4 6TB
    • לסוג המכונה X4 עם זיכרון של 6 TB, בוחרים באפשרות Memory-optimized X4 480 6T
    • לסוג המכונה X4 עם זיכרון של 8 TB, בוחרים באפשרות Memory-optimized X4 480 8T
    • לסוג המכונה X4 עם זיכרון של 12 TB, בוחרים באפשרות Memory-optimized X4 960 12T
    • לסוג המכונה X4 עם 16 TB של זיכרון, בוחרים באפשרות Memory-optimized X4 960 16T
    • לסוג מכונה X4 עם זיכרון של 24 TB, בוחרים באפשרות Memory-optimized X4 1440 24T
    • לסוג המכונה X4 עם 32 TB של זיכרון, בוחרים באפשרות Memory-optimized X4 1920 32T
    • לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3

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

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

    2. כדי לציין את הזיכרון להתחייבות, בשדה Memory (זיכרון), מזינים את כמות הזיכרון ב-GB.

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

  7. כדי לציין דיסקים של SSD מקומיים להתחייבות, מרחיבים את הקטע GPUs and local SSDs (יחידות GPU ו-SSD מקומיים). לאחר מכן, בשדה Local SSDs (כונני SSD מקומיים), מציינים את מספר הדיסקים. אם לא מצורפות הזמנות, אפשר לציין דיסקים מקומיים מסוג SSD רק לסוגי ההתחייבות הבאים:

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

  8. בקטע Term:

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

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

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

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

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

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

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

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

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

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

gcloud

מריצים את הפקודה gcloud compute commitments create ב-CLI של gcloud:

gcloud compute commitments create COMMITMENT_NAME \
    --region REGION \
    --project PROJECT_ID \
    --resources vcpu=NUMBER_VCPUS,memory=MEMORY,local-ssd=LOCAL_SSD \
    --plan PLAN \
    --type COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --auto-renew

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

  • ‫COMMITMENT_NAME: השם שרוצים לתת להתחייבות הזו.
  • ‫REGION: האזור שבו ההתחייבות הזו תקפה. לכל אזור יש מחירים שונים של התחייבות. במחירון תוכלו לעיין ברשימת המחירים העדכניים.
  • ‫PROJECT_ID: מזהה הפרויקט של הפרויקט שרוצים ליצור עבורו את ההתחייבות.
  • ‫NUMBER_VCPUS: מספר המעבדים הווירטואליים שרוצים לרכוש התחייבויות עבורם. מספר יחידות ה-vCPU צריך להיות מספר שלם של 0 או יותר, והוא יכול להיות זוגי או אי-זוגי.
  • ‫MEMORY: כמות הזיכרון, במגה-בייט או בגיגה-בייט, שאתם רוצים לרכוש התחייבויות לשימוש בה. לדוגמה, 1000MB. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, שימו לב שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.
  • ‫LOCAL_SSD: אופציונלי. כמות האחסון ב-Local SSD, שצריך לציין ב-GB. לדוגמה: 375GB. רכישת התחייבויות לדיסקים של SSD מקומיים ללא הזמנות מצורפות נתמכת רק לסוגי ההתחייבויות C4,‏ C4A,‏ C4D,‏ G4,‏ H4D או Z3.
  • ‫PLAN: תוכנית ההתחייבות, שקובעת את שיעור ה-CUD ואת התקופה שנקבעה מראש. מציינים 12-month או 36-month.

  • ‫COMMITMENT_TYPE: אחת מהאפשרויות הבאות:

    • למכונות מסוג 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
    • לסוגי מכונות H3, משתמשים ב-compute-optimized-h3
    • לסוגי מכונות H4D, משתמשים ב-compute-optimized-h4d
    • לסוגי מכונות N1, משתמשים ב-general-purpose
    • לסוגי מכונות C4, משתמשים ב-general-purpose-c4
    • לסוגי מכונות C4A, משתמשים ב-general-purpose-c4a
    • לסוגי מכונות C4D, משתמשים ב-general-purpose-c4d
    • למכונות מסוג E2, משתמשים ב-general-purpose-e2
    • בסוגי מכונות N2, משתמשים ב-general-purpose-n2
    • לסוגי מכונות N2D, משתמשים ב-general-purpose-n2d
    • לסוגי מכונות N4, משתמשים בערך general-purpose-n4
    • לסוגי מכונות N4D, משתמשים ב-general-purpose-n4d
    • לסוגי מכונות N4A, משתמשים ב-general-purpose-n4a
    • לסוגי מכונות Tau T2D, משתמשים ב-general-purpose-t2d
    • לסוגי מכונות M1 או M2, משתמשים ב-memory-optimized
    • לסוגי מכונות M3, משתמשים ב-memory-optimized-m3
    • לסוגי מכונות M4, משתמשים ב-memory-optimized-m4
    • לסוגי מכונות M4 עם זיכרון בנפח 6TB, משתמשים ב-memory-optimized-m4-6tb
    • לסוגי מכונות X4 עם זיכרון בנפח 6 TB, משתמשים ב-memory-optimized-x4-6t
    • בסוגי מכונות X4 עם זיכרון בנפח 8 TB, משתמשים ב-memory-optimized-x4-8t
    • לסוגי מכונות X4 עם 12 TB של זיכרון, משתמשים ב-memory-optimized-x4-12t
    • לסוגי מכונות X4 עם 16 TB של זיכרון, משתמשים ב-memory-optimized-x4-960-16t
    • לסוגי מכונות X4 עם זיכרון בנפח 24 TB, משתמשים בערך memory-optimized-x4-1440-24t
    • לסוגי מכונות X4 עם זיכרון של ‎32 TB, משתמשים ב-memory-optimized-x4-1920-32t
    • לסוגי מכונות Z3, משתמשים ב-storage-optimized-z3

  • ‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD.

  • ‫--auto-renew: אופציונלי. ההתחייבות מתחדשת אוטומטית בסוף התקופה.

דוגמאות

בדוגמאות הבאות מוצגות התחייבויות לרכישה בפרויקט myproject ובאזור us-central1.

דוגמה 1: רכישת התחייבות לשימוש במשאבים למטרות כלליות מסוג N1

כדי לרכוש התחייבות לשנה אחת לשימוש במשאבי N1 למטרות כלליות עם 5 ליבות וירטואליות ו-32.5 GB של זיכרון (שווה ל-33,280 MB), מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST,‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל:

    gcloud compute commitments create example-commitment --region us-central1 \
        --resources vcpu=5,memory=33280MB --plan 12-month \
        --type general-purpose --project=myproject

דוגמה 2: רכישת התחייבות לשימוש במשאבים מסוג C2 מותאם לצריכת מעבד גבוהה (compute-optimized)

כדי לרכוש התחייבות לשנה לשימוש במשאבים מסוג C2 מותאמת לצריכת מעבד גבוהה (compute-optimized) עם 16 ליבות vCPU ו-64 GB של זיכרון, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, ‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל:

    gcloud compute commitments create example-compute-optimized-commitment \
        --region us-central1 --resources vcpu=16,memory=64GB --plan 12-month \
        --type compute-optimized --project=myproject

דוגמה 3: רכישת התחייבות לשימוש במשאבים מסוג M1 או M2 מותאמת לצריכת זיכרון גבוהה

כדי לרכוש התחייבות לשימוש לשנה במשאבי M1 או M2 מותאמים לצריכת זיכרון גבוהה (memory-optimized) עם 96 vCPU ו-1,433.6 GB של זיכרון, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, ‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל:

    gcloud compute commitments create example-memory-optimized-commitment \
        --region us-central1 --resources vcpu=96,memory=1433.6GB \
        --plan 12-month --type memory-optimized \
        --project=myproject

דוגמה 4: רכישת התחייבות למשאבי C4 למטרות כלליות עם דיסק SSD מקומי

כדי לרכוש התחייבות לשנה לדיסקים של Local SSD שלא נדרשות להם הזמנות מצורפות (נתמך רק לסוגי ההתחייבויות C4,‏ C4A,‏ C4D,‏ G4,‏ H4D או Z3), צריך לכלול את local-ssd בדגל --resources. כל דיסק SSD נדיף (scratch disk) מקומי הוא בנפח 375GB. לדוגמה, כדי לרכוש התחייבות לשנה לשימוש במשאבי C4 למטרות כלליות עם 8 ליבות vCPU, זיכרון של 32 GB ודיסק SSD מקומי אחד (375 GB), מריצים את הפקודה הבאה. צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (לדוגמה, 375GB). ב-CLI של gcloud אפשר לציין את הזיכרון במגה-בייט או בגיגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, ‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל לזיכרון.

    gcloud compute commitments create example-local-ssd-commitment \
        --region us-central1 --resources vcpu=8,memory=32GB,local-ssd=375GB \
        --plan 12-month --type general-purpose-c4 --project=myproject

REST

ב-API, שולחים בקשת POST אל ה-method‏ regionCommitments.insert, עם גוף בקשה שמכיל מידע על ההתחייבות.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments?requestId=OPTIONAL_UNIQUE_ID

{
    "name": "COMMITMENT_NAME",
    "plan": "PLAN",
    "type": "COMMITMENT_TYPE",
    "resources": [
        {
            "type": "VCPU",
            "amount": "COMMITTED_VCPUS"
        },
        {
            "type": "MEMORY",
            "amount": "COMMITTED_MEMORY"
        },
        {
            "type": "LOCAL_SSD",
            "amount": "COMMITTED_LOCAL_SSD"
        }
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
    "autoRenew": AUTO_RENEW_BOOLEAN
}

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות.
  • ‫REGION: האזור שבו רוצים לרכוש את ההתחייבות.
  • ‫OPTIONAL_UNIQUE_ID: אופציונלי. מזהה בקשה ייחודי כדי למנוע בקשות כפולות לא מכוונות.
  • ‫COMMITMENT_NAME: השם של ההתחייבות.
  • ‫PLAN: תוכנית ההתחייבות, TWELVE_MONTH או THIRTY_SIX_MONTH.

  • ‫COMMITMENT_TYPE: סוג ההתחייבות, אחת מהאפשרויות הבאות:

    • למכונות מסוג 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
    • לסוגי מכונות H3, משתמשים ב-COMPUTE_OPTIMIZED_H3
    • לסוגי מכונות H4D, משתמשים ב-COMPUTE_OPTIMIZED_H4D
    • לסוגי מכונות N1, משתמשים ב-GENERAL_PURPOSE
    • לסוגי מכונות C4, משתמשים ב-GENERAL_PURPOSE_C4
    • לסוגי מכונות C4A, משתמשים ב-GENERAL_PURPOSE_C4A
    • לסוגי מכונות C4D, משתמשים ב-GENERAL_PURPOSE_C4D
    • למכונות מסוג E2, משתמשים ב-GENERAL_PURPOSE_E2
    • בסוגי מכונות N2, משתמשים ב-GENERAL_PURPOSE_N2
    • לסוגי מכונות N2D, משתמשים ב-GENERAL_PURPOSE_N2D
    • לסוגי מכונות N4, משתמשים בערך GENERAL_PURPOSE_N4
    • לסוגי מכונות N4D, משתמשים ב-GENERAL_PURPOSE_N4D
    • לסוגי מכונות N4A, משתמשים ב-GENERAL_PURPOSE_N4A
    • לסוגי מכונות Tau T2D, משתמשים ב-GENERAL_PURPOSE_T2D
    • לסוגי מכונות M1 או M2, משתמשים ב-MEMORY_OPTIMIZED
    • לסוגי מכונות M3, משתמשים ב-MEMORY_OPTIMIZED_M3
    • לסוגי מכונות M4, משתמשים ב-MEMORY_OPTIMIZED_M4
    • לסוגי מכונות M4 עם זיכרון בנפח 6TB, משתמשים ב-MEMORY_OPTIMIZED_M4_6TB
    • לסוגי מכונות X4 עם זיכרון בנפח 6 TB, משתמשים ב-MEMORY_OPTIMIZED_X4_480_6T
    • בסוגי מכונות X4 עם זיכרון בנפח 8 TB, משתמשים ב-MEMORY_OPTIMIZED_X4_480_8T
    • לסוגי מכונות X4 עם 12 TB של זיכרון, משתמשים ב-MEMORY_OPTIMIZED_X4_960_12T
    • לסוגי מכונות X4 עם 16 TB של זיכרון, משתמשים ב-MEMORY_OPTIMIZED_X4_960_16T
    • לסוגי מכונות X4 עם זיכרון בנפח 24 TB, משתמשים בערך MEMORY_OPTIMIZED_X4_1440_24T
    • לסוגי מכונות X4 עם זיכרון של ‎32 TB, משתמשים ב-MEMORY_OPTIMIZED_X4_1920_32T
    • לסוגי מכונות Z3, משתמשים ב-STORAGE_OPTIMIZED_Z3

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

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

  • ‫COMMITTED_LOCAL_SSD: אופציונלי. כמות האחסון ב-SSD מקומי, שצריך לציין ב-GB. לדוגמה: 375GB. רכישת התחייבויות לדיסקים מקומיים מסוג SSD ללא הזמנות מצורפות נתמכת רק לסוגי ההתחייבויות C4,‏ C4A,‏ C4D,‏ G4,‏ H4D או Z3.

  • ‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית להתחייבות, בפורמט YYYY-MM-DD.

  • ‫END_TIME: חצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7). מציינים 07:00:00 בשעון קיץ, או 08:00:00 בשאר הזמנים.

  • ‫AUTO_RENEW_BOOLEAN: אופציונלי. הגדרה ל-true תגרום לחידוש אוטומטי של ההתחייבות בסוף התקופה.

דוגמאות

בדוגמאות הבאות מוצגות התחייבויות לרכישה בפרויקט myproject ובאזור us-central1.

דוגמה 1: רכישת התחייבות לשימוש במשאבים למטרות כלליות מסוג N1

כדי לרכוש התחייבות לשנה לשימוש במשאבי N1 למטרות כלליות עם 5 ליבות vCPU ו-18.75 GB של זיכרון (שווה ל-19,200 MB), שולחים את בקשת ה-POST הבאה. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

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

{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources": [
        {
            "amount": "5",
            "type": "VCPU"
        },
        {
            "amount": "19200",
            "type": "MEMORY"
        }
    ]
}

דוגמה 2: רכישת התחייבות לשימוש במשאבים מסוג M1 או M2 מותאמים לצריכת זיכרון גבוהה

כדי לרכוש התחייבות לשימוש לשנה למשאבי M1 או M2 מותאמת לצריכת זיכרון גבוהה (memory-optimized) עם 96 vCPU ו-1,433.6 GB של זיכרון (שווה ל-1,468,006 MB), שולחים את בקשת ה-POST הבאה. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

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

{
    "name": "example-memory-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "MEMORY_OPTIMIZED",
    "resources": [
        {
            "amount": "96",
            "type": "VCPU"
        },
        {
            "amount": "1468006",
            "type": "MEMORY"
        }
    ]
}

דוגמה 3: רכישת התחייבות לשימוש במשאבים מסוג C2 מותאם לצריכת מעבד גבוהה

כדי לרכוש התחייבות לשימוש לשנה אחת למשאבי C2 מותאמת לצריכת מעבד גבוהה (compute-optimized) עם 16 vCPU ו-64 GB של זיכרון (שווה ל-65536 MB), שולחים את בקשת ה-POST הבאה. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

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

{
    "name": "example-compute-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "COMPUTE_OPTIMIZED",
    "resources": [
        {
            "amount": "16",
            "type": "VCPU"
        },
        {
            "amount": "65536",
            "type": "MEMORY"
        }
    ]
}

דוגמה 4: רכישת התחייבות למשאבי C4 למטרות כלליות עם דיסק SSD מקומי

כדי לרכוש התחייבות לשנה לשימוש במשאבי C4 למטרות כלליות ובדיסק SSD מקומי ללא הזמנות מצורפות (האפשרות הזו נתמכת רק בסוגי ההתחייבויות C4,‏ C4A,‏ C4D,‏ G4,‏ H4D או Z3) עם 8 ליבות וירטואליות, זיכרון בנפח 32 GB ודיסק SSD מקומי אחד (בנפח 375 GB), שולחים את בקשת ה-POST הבאה. שימו לב: צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (GB). לגבי זיכרון, צריך לציין את הערך ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, ‏ Compute Engine משתמש ב-GB כיחידת ברירת המחדל לזיכרון.

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

{
    "name": "example-local-ssd-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE_C4",
    "resources": [
        {
            "amount": "8",
            "type": "VCPU"
        },
        {
            "amount": "32768",
            "type": "MEMORY"
        },
        {
            "amount": "375",
            "type": "LOCAL_SSD"
        }
    ]
}