איך יוצרים בקשות למקומות שמורים לעתיד לפרויקט יחיד

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

כשיוצרים בקשה למקומות שמורים לעתיד, מבקשים Google Cloud לשמור vCPU, זיכרון, יחידות GPU ודיסקים מקומיים של SSD כדי ליצור מכונות וירטואליות (VM) לתאריך ולשעה עתידיים. אם הבקשה תאושר על ידי Google Cloud , המשאבים שביקשתם יישמרו ב-Compute Engine בתאריך ובשעה שציינתם. בקשה שאושרה למקום שמור לעתיד מעניקה את היתרונות הבאים:

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

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

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

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

  • לפני ששולחים בקשה למקום שמור לעתיד של מכונות וירטואליות עם GPU,‏ H4D או Z4M, צריך לפנות לצוות ניהול החשבון או לצוות המכירות כדי לדון בבקשה. אחרת,יכול להיות שהבקשה שלכם תידחה על ידי Google Cloud .
  • אתם צריכים לוודא שיש לכם מספיק מכסה למשאבים שאתם רוצים להקצות. אם המכסה לא מספיקה, סביר להניח ש- Google Cloud ידחה את הבקשה למקום שמור לעתיד. לחלופין, אם הבקשה תאושר אבל לא תהיה לכם מכסה פנויה בשעת ההתחלה של הבקשה, Compute Engine יספק רק חלק מהמשאבים השמורים, או לא יספק אותם בכלל. מידע נוסף על הסוגים השונים של מכסות ב-Compute Engine זמין במאמר בנושא מכסות הקצאה.
  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא התהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי 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 (roles/compute.futureReservationUser) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

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

  • כדי ליצור בקשה למקום שמור לעתיד: compute.futureReservations.create בפרויקט
  • כדי לאפשר ל-Compute Engine ליצור אוטומטית בקשות לשמירת מקום: compute.reservations.create בפרויקט
  • כדי לציין תבנית של הגדרות מכונה: compute.instanceTemplates.useReadOnly בתבנית של הגדרות המכונה

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

יצירת טיוטה של בקשה

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

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

  • מומלץ: הגדרת תבנית של הגדרות מכונה

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

  • ציון מכונה וירטואלית קיימת

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

  • ציון מאפיינים באופן ישיר

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

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

ציון תבנית של הגדרות מכונה

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

  • אתם צריכים ליצור את הבקשה למקום שמור לעתיד באותו אזור ובאותו תחום (zone) שבהם נמצאים המשאבים בתבנית של הגדרות המכונה. כל משאב אזורי או משאב של תחום מוגדר שצוין בתבנית של הגדרות המכונה, כמו סוג מכונה או Persistent Disk, מגביל את השימוש בתבנית למיקומים שבהם המשאבים האלה נמצאים. לדוגמה, אם בתבנית של הגדרות המכונה ציינתם דיסק קיים מסוג Persistent Disk באזור us-central1-a, אתם צריכים ליצור את הבקשה למקום שמור לעתיד באותו אזור. אחרת, הבקשה למקום שמור לעתיד תיכשל.

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

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

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

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

המסוף

  1. פותחים את הדף Reservations במסוף Google Cloud .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations (הזמנות עתידיות).

  3. לוחצים על ‎ יצירת מקום שמור לעתיד. ייפתח הדף Create a future reservation.

  4. בקטע Configurations, מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Use instance template.

    2. בוחרים את תבנית המכונה ברשימה Instance template. אם בוחרים תבנית של הגדרות מכונה אזורית, אפשר לשריין משאבים רק באזור הזה.

  5. בקטע Location, ברשימות Region ו-Zone, בוחרים את האזור והתחום שבהם רוצים לשריין את המשאבים.

  6. בקטע Capacity details, בשדה Total capacity needed, כותבים כמה מכונות וירטואליות רוצים לשריין.

  7. בקטע Reservation period:

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

    2. בשדה End time, מציינים מה שעת הסיום של שמירת המקום. בקטע Duration summary אתם יכולים לראות את משך שמירת המקום. כדי להגדיל את הסיכוי ש-Google Cloud תאשר את הבקשה למקום שמור לעתיד לאחר שתגיש אותה, מומלץ להגדיר תקופה של 365 ימים לפחות.

  8. לוחצים על הבא.

  9. בקטע Auto-delete, מבצעים אחת מהפעולות הבאות:

    • כדי לאפשר ל-Compute Engine למחוק את שאר הבקשות שנוצרו אוטומטית מבקשה למקום שמור לעתיד:

      1. מסמנים את התיבה Enable auto-delete.

      2. אם רוצים: בשדה Auto-delete time, בוחרים את התאריך והשעה שבהם יימחקו הבקשות שנוצרו אוטומטית. התאריך והשעה צריכים להיות אחרי מועד הסיום של שמירת המקום. אם תשאירו את השדה ריק, הבקשות שנוצרו אוטומטית ב-Compute Engine יימחקו תוך שעתיים מסיום שמירת המקום.

    • כדי להשבית את המחיקה האוטומטית, מבטלים את הסימון בתיבה Enable auto-delete.

  10. בקטע Use with VM instance, בוחרים באחת מהאפשרויות הבאות:

    • כדי להשתמש אוטומטית במכונות וירטואליות שמתאימות לפרטי הבקשה, מסמנים את האפשרות Use reservation automatically.

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

  11. לוחצים על הבא.

  12. נותנים לבקשה שם בשדה Future reservation name.

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

  14. כדי לסיים ליצור טיוטה של בקשת מקום שמור לעתיד, לוחצים על Save a draft. יופיע הדף Reservations. יצירת הבקשה למקומות שמורים לעתיד עשויה להימשך עד דקה. כדי לראות מתי הבקשה תיווצר ב-Compute Engine, אתם יכולים לפתוח את רשימת הבקשות למקום שמור לעתיד.

gcloud

כדי ליצור בקשה למקום שמור לעתיד בפרויקט יחיד על ידי ציון תבנית של הגדרות מכונה, משתמשים בפקודה gcloud compute future-reservations create.

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

gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=INSTANCE_TEMPLATE_URL \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

  • ‫FUTURE_RESERVATION_NAME: השם של הבקשה למקום שמור לעתיד.
  • ‫INSTANCE_TEMPLATE_URL: כתובת ה-URL של תבנית קיימת של הגדרות מכונה. מציינים את אחד מהערכים הבאים:

    • לתבנית של הגדרות מכונה אזורית: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

    • לתבנית גלובלית של הגדרות מכונה: INSTANCE_TEMPLATE_NAME

  • ‫START_TIME: שעת ההתחלה של תקופת ההזמנה כחותמת זמן בפורמט RFC 3339, שצריכה להיות בפורמט הבא:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

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

    • ‫YYYY-MM-DD: נתונים בפורמט של שנה בת 4 ספרות, חודש בן 2 ספרות ויום בחודש בן 2 ספרות, מופרדים במקפים (-).

    • ‫HH:MM:SS: שעה בפורמט של 2 ספרות בפורמט של 24 שעות, דקות בפורמט של 2 ספרות ושניות בפורמט של 2 ספרות, מופרדות בנקודתיים (:).

    • ‫OFFSET: אזור הזמן בפורמט של היסט מזמן אוניברסלי מתואם (UTC). לדוגמה, כדי להשתמש בשעון החוף המערבי (PST), מציינים -08:00. לחלופין, כדי לא להשתמש בהזחה, מציינים Z.

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

  • ‫END_TIME: שעת הסיום של תקופת ההזמנה בפורמט של חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , מומלץ לבקש לשמור מקום לתקופה של 365 ימים לפחות. כדי לציין משך זמן במקום שעת סיום, מחליפים את הדגל --end-time בדגל --duration=END_DURATION. מחליפים את END_DURATION במשך הזמן בשניות. לדוגמה, מציינים 31536000 ל-31,536,000 שניות (365 ימים).

  • ‫TOTAL_COUNT: המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

  • ‫ZONE: האזור שבו רוצים לשמור את המשאבים.

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם fr-01 באזור us-central1-a עם המאפיינים הבאים:

  • תקופת הזמנה שמתחילה בחצות ב-10 בנובמבר 2024 לפי שעון UTC, ומסתיימת בחצות ב-10 בדצמבר 2024 לפי שעון UTC.

  • סך הכול 80 מכונות וירטואליות.

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

כדי ליצור את fr-01, מריצים את הפקודה הבאה:

gcloud compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

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

  • כדי לציין קידומת לשם של בקשות שנוצרו אוטומטית, צריך לכלול את הדגל --name-prefix.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --name-prefix=NAME_PREFIX \
        --source-instance-template=INSTANCE_TEMPLATE_URL \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    מחליפים את NAME_PREFIX בקידומת השם של כל בקשה שנוצרה אוטומטית. כדי שתוכלו לזהות את הבקשות שנוצרו אוטומטית מאותה בקשה למקום שמור לעתיד,מומלץ לציין קידומת ייחודית לשם ב- Google Cloud .

  • כדי לאפשר רק למכונות וירטואליות שמיועדות ספציפית להזמנות שנוצרו אוטומטית (לפי שם) להשתמש בהן, צריך לכלול את הדגל --require-specific-reservation.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --source-instance-template=INSTANCE_TEMPLATE_URL \
        --require-specific-reservation \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    
  • כדי למחוק את הבקשות שנוצרו אוטומטית אחרי שעת הסיום של תקופת שמירת המקום, בוחרים אחת מהשיטות הבאות:

    • כדי למחוק את הבקשות שנוצרו אוטומטית בתאריך ובשעה ספציפיים אחרי שעת הסיום של שמירת המקום, מוסיפים את הדגל --auto-created-reservations-delete-time.

      gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --source-instance-template=INSTANCE_TEMPLATE_URL \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      מחליפים את AUTO_CREATED_RESERVATIONS_DELETE_TIME בתאריך ובשעה בפורמט של חותמת זמן RFC 3339.

    • כדי למחוק את הבקשות שנוצרו אוטומטית אחרי פרק זמן מסוים מסיום שמירת המקום, צריך לכלול את הדגל --auto-created-reservations-duration.

      gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --source-instance-template=INSTANCE_TEMPLATE_URL \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      מחליפים את DURATION_BEFORE_DELETE במשך זמן בימים, בשעות, בדקות או בשניות. לדוגמה, מציינים 30m ל-30 דקות, או 1d2h3m4s ליום אחד, שעתיים, שלוש דקות וארבע שניות.

  • כדי להשבית את אפשרות המחיקה האוטומטית של הבקשות שנוצרו אוטומטית, מחליפים את הדגל --auto-delete-auto-created-reservations בדגל --no-auto-delete-auto-created-reservations.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --source-instance-template=INSTANCE_TEMPLATE_URL \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

REST

כדי ליצור בקשה למקום שמור לעתיד לפרויקט יחיד על ידי ציון תבנית של הגדרות מכונה, שולחים בקשת POST אל ה-method‏ futureReservations.insert.

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
    "totalCount": TOTAL_COUNT
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים לשמור משאבים, ושבו נמצאת התבנית של הגדרות המכונה.

  • ‫ZONE: האזור שבו רוצים לשריין משאבים.

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

  • ‫INSTANCE_TEMPLATE_URL: כתובת ה-URL של תבנית קיימת של הגדרות מכונה. מציינים אחד מהערכים הבאים:

    • לתבנית של הגדרות מכונה אזורית: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

    • לתבנית גלובלית של הגדרות מכונה: INSTANCE_TEMPLATE_NAME

  • ‫TOTAL_COUNT: המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

  • ‫RESERVATION_AFFINITY: האם מכונות וירטואליות צריכות לטרגט את ההזמנות שנוצרו אוטומטית כדי להשתמש בהן (true), או שכל מכונה וירטואלית תואמת יכולה להשתמש בהן באופן אוטומטי (false).

  • ‫START_TIME: שעת ההתחלה של תקופת ההזמנה, כחותמת זמן של RFC 3339, שצריכה להיות בפורמט הבא:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

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

    • ‫YYYY-MM-DD: נתונים בפורמט של שנה בת 4 ספרות, חודש בן 2 ספרות ויום בחודש בן 2 ספרות, מופרדים במקפים (-).

    • ‫HH:MM:SS: שעה בפורמט של שעה בת 2 ספרות בשיטת 24 שעות, דקות בנות 2 ספרות ושניות בנות 2 ספרות, מופרדות בנקודתיים (:).

    • ‫OFFSET: אזור הזמן בפורמט של היסט מהזמן האוניברסלי המתואם (UTC). לדוגמה, כדי להשתמש בשעון החוף המערבי (PST), מציינים -08:00. לחלופין, כדי לא להשתמש בהזחה, מציינים Z.

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

  • ‫END_TIME: שעת הסיום של תקופת ההזמנה, בפורמט של חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , כדאי להשתמש בתקופה של לפחות 365 ימים לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, אפשר להחליף את השדה endTime בשדה duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    מחליפים את END_DURATION במשך זמן בשניות. לדוגמה, מציינים 31536000 בשביל 31,536,000 שניות (365 ימים).

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם fr-01 באזור us-central1-a עם המאפיינים הבאים:

  • תקופת הזמנה שמתחילה בחצות ב-10 בנובמבר 2024 לפי שעון UTC, ומסתיימת בחצות ב-10 בדצמבר 2024 לפי שעון UTC.

  • סך הכול 80 מכונות וירטואליות.

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

כדי ליצור את fr-01, שולחים בקשת POST באופן הבא:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

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

  • כדי לציין קידומת לשם של הבקשות שנוצרו אוטומטית, מוסיפים את השדה namePrefix.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "namePrefix": "NAME_PREFIX",
      "specificSkuProperties": { 
        "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

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

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
          "totalCount": TOTAL_COUNT
        },
        "specificReservationRequired": RESERVATION_AFFINITY,
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

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

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

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
          "totalCount": TOTAL_COUNT
        },
        "specificReservationRequired": RESERVATION_AFFINITY,
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      מחליפים את DURATION_BEFORE_DELETE במשך הזמן בשניות. לדוגמה, מציינים 604800 עבור 604,800 שניות (7 ימים).

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

בחירת מכונה וירטואלית קיימת

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

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

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

  1. פותחים את הדף Reservations במסוף Google Cloud .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations.

  3. לוחצים על ‎ יצירת מקום שמור לעתיד. ייפתח הדף Create a future reservation.

  4. בקטע Configurations, מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Use existing VM.

    2. ברשימה Existing VM, בוחרים את ה-VM שאת המאפיינים שלו רוצים להשתמש כדי ליצור את ההזמנה.

  5. בקטע Location, ברשימות Region ו-Zone, בוחרים את האזור והתחום שבהם רוצים לשריין את המשאבים.

  6. בקטע Capacity details, בשדה Total capacity needed, כותבים כמה מכונות וירטואליות רוצים לשריין.

  7. בקטע Reservation period:

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

    2. בשדה End time, מציינים מה שעת הסיום של שמירת המקום. בקטע Duration summary אתם יכולים לראות את משך שמירת המקום. כדי להגדיל את הסיכוי ש-Google Cloud תאשר את הבקשה למקום שמור לעתיד לאחר שתגישו אותה, מומלץ להגדיר תקופה של לפחות 365 ימים למקום השמור.

  8. לוחצים על הבא.

  9. בקטע Auto-delete, מבצעים אחת מהפעולות הבאות:

    • כדי לאפשר ל-Compute Engine למחוק את שאר הבקשות שנוצרו אוטומטית מבקשה למקום שמור לעתיד:

      1. מסמנים את התיבה Enable auto-delete.

      2. אם רוצים: בשדה Auto-delete time, בוחרים את התאריך והשעה שבהם יימחקו הבקשות שנוצרו אוטומטית. התאריך והשעה צריכים להיות אחרי מועד הסיום של שמירת המקום. אם תשאירו את השדה ריק, הבקשות שנוצרו אוטומטית ב-Compute Engine יימחקו תוך שעתיים מסיום שמירת המקום.

    • כדי להשבית את המחיקה האוטומטית, מבטלים את הסימון בתיבה Enable auto-delete.

  10. בקטע Use with VM instance, בוחרים באחת מהאפשרויות הבאות:

    • כדי להשתמש אוטומטית במכונות וירטואליות שמתאימות לפרטי הבקשה, מסמנים את האפשרות Use reservation automatically.

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

  11. לוחצים על הבא.

  12. נותנים לבקשה שם בשדה Future reservation name.

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

  14. כדי לסיים ליצור טיוטה של בקשת מקום שמור לעתיד, לוחצים על Save a draft. יופיע הדף Reservations. הבקשה תיווצר בתוך כדקה. כדי לוודא מתי Compute Engine מסיים ליצור אותה, הצג את הבקשות שלך למקום שמור לעתיד.

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

ציון מאפיינים באופן ישיר

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

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

המסוף

  1. פותחים את הדף Reservations במסוף Google Cloud .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations (הזמנות עתידיות).

  3. לוחצים על ‎ יצירת מקום שמור לעתיד. ייפתח הדף Create a future reservation.

  4. בקטע Configurations, מבצעים את הפעולות הבאות:

    1. בוחרים באפשרות Specify machine type.

    2. מציינים את משפחת המכונות, הסדרה והסוג של מכונות ה-VM המוזמנות.

  5. בקטע Location, ברשימות Region ו-Zone, בוחרים את האזור והתחום שבהם רוצים לשריין את המשאבים.

  6. בקטע Capacity details, בשדה Total capacity needed, כותבים כמה מכונות וירטואליות רוצים לשריין.

  7. בקטע Reservation period:

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

    2. בשדה End time, מציינים מה שעת הסיום של שמירת המקום. בקטע Duration summary אתם יכולים לראות את משך שמירת המקום. כדי להגדיל את הסיכוי ש-Google Cloud תאשר את הבקשה למקום שמור לעתיד לאחר שתגישו אותה, מומלץ להגדיר תקופה של לפחות 365 ימים למקום השמור.

  8. לוחצים על הבא.

  9. בקטע Auto-delete, מבצעים אחת מהפעולות הבאות:

    • כדי לאפשר ל-Compute Engine למחוק את שאר הבקשות שנוצרו אוטומטית מבקשה למקום שמור לעתיד:

      1. מסמנים את התיבה Enable auto-delete.

      2. אם רוצים: בשדה Auto-delete time, בוחרים את התאריך והשעה שבהם יימחקו הבקשות שנוצרו אוטומטית. התאריך והשעה צריכים להיות אחרי מועד הסיום של שמירת המקום. אם תשאירו את השדה ריק, הבקשות שנוצרו אוטומטית ב-Compute Engine יימחקו תוך שעתיים מסיום שמירת המקום.

    • כדי להשבית את המחיקה האוטומטית, מבטלים את הסימון בתיבה Enable auto-delete.

  10. בקטע Use with VM instance, בוחרים באחת מהאפשרויות הבאות:

    • כדי להשתמש אוטומטית במכונות וירטואליות שמתאימות לפרטי הבקשה, מסמנים את האפשרות Use reservation automatically.

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

  11. לוחצים על הבא.

  12. נותנים לבקשה שם בשדה Future reservation name.

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

  14. כדי לסיים ליצור טיוטה של בקשת מקום שמור לעתיד, לוחצים על Save a draft. הדף Reservations ייפתח. יצירת הבקשה למקומות שמורים לעתיד עשויה להימשך עד דקה. כדי לוודא מתי Compute Engine מסיים ליצור אותה, הצג את הבקשות שלך למקום שמור לעתיד.

gcloud

כדי ליצור בקשה למקומות שמורים לעתיד לפרויקט יחיד על ידי ציון מאפיינים ישירות, משתמשים בפקודה gcloud compute future-reservations create.

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

gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

  • ‫FUTURE_RESERVATION_NAME: השם של בקשת ההזמנה העתידית.
  • ‫MACHINE_TYPE: סוג המכונה שבה משתמשים לכל מכונה וירטואלית שמורה.
  • ‫START_TIME: שעת ההתחלה של תקופת ההזמנה, כחותמת זמן של RFC 3339, שצריכה להיות בפורמט הבא:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

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

    • ‫YYYY-MM-DD: נתונים בפורמט של שנה בת 4 ספרות, חודש בן 2 ספרות ויום בחודש בן 2 ספרות, מופרדים במקפים (-).

    • ‫HH:MM:SS: שעה בפורמט של 2 ספרות בפורמט של 24 שעות, דקות בפורמט של 2 ספרות ושניות בפורמט של 2 ספרות, מופרדות בנקודתיים (:).

    • ‫OFFSET: אזור הזמן בפורמט של היסט מזמן אוניברסלי מתואם (UTC). לדוגמה, כדי להשתמש בשעון החוף המערבי (PST), מציינים -08:00. לחלופין, כדי לא להשתמש בהיסט, מציינים Z.

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

  • ‫END_TIME: שעת הסיום של תקופת ההזמנה בפורמט של חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , מומלץ לבקש לשמור מקום לתקופה של 365 ימים לפחות. כדי לציין משך זמן במקום שעת סיום, מחליפים את הדגל --end-time בדגל --duration=END_DURATION. מחליפים את END_DURATION במשך הזמן בשניות. לדוגמה, מציינים 31536000 ל-31,536,000 שניות (365 ימים).

  • ‫TOTAL_COUNT: המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

  • ‫ZONE: האזור שבו רוצים לשריין משאבים.

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם fr-01 באזור us-central1-a עם המאפיינים הבאים:

  • תקופת הזמנה שמתחילה בחצות ב-10 בנובמבר 2024 לפי שעון UTC, ומסתיימת בחצות ב-10 בדצמבר 2024 לפי שעון UTC.

  • 80 מכונות וירטואליות בסך הכול.

  • מכונה עם קונפיגורציה מוגדרת (predefined) מסוג N2 עם 4 יחידות vCPU.
  • אפשרות המחיקה האוטומטית מופעלת. הבקשות שנוצרו אוטומטית נמחקות בסיום תקופת שמירת המקום.

כדי ליצור את fr-01, מריצים את הפקודה הבאה:

gcloud compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

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

  • כדי לציין קידומת לשם של בקשות שנוצרו אוטומטית, צריך לכלול את הדגל --name-prefix.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --name-prefix=NAME_PREFIX \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    מחליפים את NAME_PREFIX בקידומת השם של כל הזמנה שנוצרה אוטומטית. כדי שתוכלו לזהות את הבקשות שנוצרו אוטומטית מאותה בקשה למקום שמור לעתיד,מומלץ לציין קידומת ייחודית לשם ב- Google Cloud .

  • כדי לאפשר רק למכונות וירטואליות שמטרגטות ספציפית את ההזמנות שנוצרו אוטומטית לפי שם להשתמש בהן, צריך לכלול את הדגל --require-specific-reservation.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --require-specific-reservation \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    
  • כדי למחוק את הבקשות שנוצרו אוטומטית אחרי שעת הסיום של תקופת שמירת המקום, בוחרים אחת מהשיטות הבאות:

    • כדי למחוק את הבקשות שנוצרו אוטומטית בתאריך ובשעה ספציפיים אחרי שעת הסיום של שמירת המקום, מוסיפים את הדגל --auto-created-reservations-delete-time.

      gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --machine-type=MACHINE_TYPE \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      מחליפים את AUTO_CREATED_RESERVATIONS_DELETE_TIME בתאריך ובשעה בפורמט של חותמת זמן RFC 3339.

    • כדי למחוק את הבקשות שנוצרו אוטומטית אחרי פרק זמן מסוים מסיום שמירת המקום, צריך לכלול את הדגל --auto-created-reservations-duration.

      gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --machine-type=MACHINE_TYPE \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      מחליפים את DURATION_BEFORE_DELETE במשך זמן בימים, בשעות, בדקות או בשניות. לדוגמה, מציינים 30m ל-30 דקות, או 1d2h3m4s ליום אחד, שעתיים, שלוש דקות וארבע שניות.

  • כדי להשבית את אפשרות המחיקה האוטומטית של הבקשות שנוצרו אוטומטית, מחליפים את הדגל --auto-delete-auto-created-reservations בדגל --no-auto-delete-auto-created-reservations.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    
  • כדי שהמכונות הווירטואליות השמורות ישתמשו בפלטפורמת CPU מינימלית ספציפית במקום בפלטפורמת ברירת המחדל של ה-CPU באזור, צריך לכלול את הדגל --min-cpu-platform.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --min-cpu-platform="MIN_CPU_PLATFORM" \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

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

  • כדי לצרף יחידות GPU למכונות וירטואליות מסוג N1 שהוזמנו, צריך לכלול את הדגל --accelerator.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

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

    • ‫NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף לכל מכונה וירטואלית שמורה.

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

  • כדי לצרף דיסקים מסוג Local SSD לסוג מכונה שלא כולל דיסקים מסוג Local SSD כברירת מחדל, צריך לכלול את הדגל --local-ssd. אפשר לצרף רק דיסק SSD מקומי בנפח 375GB.

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

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

    • ‫NUMBER_OF_LOCAL_SSD_DISKS: מספר כונני ה-SSD המקומיים שרוצים לצרף.

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

      • לממשק הדיסק NVME: ‏nvme

      • לממשק הדיסק SCSI: ‏scsi

REST

כדי ליצור בקשה למקום שמור לעתיד לפרויקט יחיד על ידי ציון מאפיינים ישירות, שולחים בקשת POST אל ה-method‏ futureReservations.insert.

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים לשמור משאבים.

  • ‫ZONE: האזור שבו רוצים לשמור את המשאבים.

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

  • ‫TOTAL_COUNT: המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

  • ‫RESERVATION_AFFINITY: אם המכונות הווירטואליות צריכות לטרגט את ההזמנות שנוצרו באופן אוטומטי כדי להשתמש בהן (true), או אם כל מכונה וירטואלית מתאימה יכולה להשתמש בהן באופן אוטומטי (false).

  • ‫START_TIME: שעת ההתחלה של תקופת ההזמנה, כחותמת זמן של RFC 3339, שצריכה להיות בפורמט הבא:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

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

    • ‫YYYY-MM-DD: נתונים בפורמט של שנה בת 4 ספרות, חודש בן 2 ספרות ויום בחודש בן 2 ספרות, מופרדים במקפים (-).

    • ‫HH:MM:SS: שעה בפורמט של 2 ספרות בפורמט של 24 שעות, דקות בפורמט של 2 ספרות ושניות בפורמט של 2 ספרות, מופרדות בנקודתיים (:).

    • ‫OFFSET: אזור הזמן בפורמט של היסט מהזמן האוניברסלי המתואם (UTC). לדוגמה, כדי להשתמש בשעון החוף המערבי (PST), מציינים -08:00. לחלופין, כדי לא להשתמש בהיסט, מציינים Z.

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

  • ‫END_TIME: שעת הסיום של תקופת ההזמנה בפורמט של חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , כדאי להשתמש בתקופה של לפחות 365 ימים לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, אפשר להחליף את השדה endTime בשדה duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    מחליפים את END_DURATION במשך זמן בשניות. לדוגמה, מציינים 31536000 בשביל 31,536,000 שניות (365 ימים).

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם fr-01 בתחום (zone) us-central1-a עם המאפיינים הבאים:

  • תקופת הזמנה שמתחילה בחצות ב-10 בנובמבר 2024 לפי שעון UTC, ומסתיימת בחצות ב-10 בדצמבר 2024 לפי שעון UTC.

  • 80 מכונות וירטואליות בסך הכול.

  • מכונה עם קונפיגורציה מוגדרת (predefined) מסוג N2 עם 4 יחידות vCPU.
  • אפשרות המחיקה האוטומטית מופעלת. הבקשות שנוצרו אוטומטית נמחקות בסיום תקופת שמירת המקום.

כדי ליצור את fr-01, שולחים בקשת POST באופן הבא:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

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

  • כדי לציין קידומת לשם של הבקשות שנוצרו אוטומטית, מוסיפים את השדה namePrefix.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "namePrefix": "NAME_PREFIX",
      "specificSkuProperties": { 
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

  • כדי לצרף יחידות GPU למכונות הווירטואליות השמורות מסוג N1, צריך לכלול את השדה guestAccelerators.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "guestAccelerators": [
            {
              "acceleratorCount": NUMBER_OF_ACCELERATORS,
              "acceleratorType": "ACCELERATOR_TYPE"
            }
          ],
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

    • ‫NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף לכל מכונה וירטואלית (VM) מוזמנת.

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

  • כדי לצרף דיסקים של SSD מקומי לסוג מכונה שלא כולל דיסקים של SSD מקומי כברירת מחדל, צריך לכלול את השדה localSsds בגוף הבקשה. אפשר לצרף רק דיסקים מסוג Local SSD בנפח 375GB.

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_TYPE"
            },
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_TYPE"
            }
          ],
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

    • לממשק הדיסק NVME: ‏ NVME

    • לממשק דיסק SCSI: ‏ SCSI

  • כדי שהמכונות הווירטואליות השמורות ישתמשו בפלטפורמת CPU מינימלית ספציפית במקום בפלטפורמת ברירת המחדל של ה-CPU באזור, צריך לכלול את minCpuPlatform.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

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

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "instanceProperties": {
            "machineType": "MACHINE_TYPE"
          },
          "totalCount": TOTAL_COUNT
        },
        "specificReservationRequired": RESERVATION_AFFINITY,
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

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

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

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "instanceProperties": {
            "machineType": "MACHINE_TYPE"
          },
          "totalCount": TOTAL_COUNT
        },
        "specificReservationRequired": RESERVATION_AFFINITY,
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      מחליפים את DURATION_BEFORE_DELETE במשך הזמן בשניות. לדוגמה, מציינים 604800 עבור 604,800 שניות (7 ימים).

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

שליחת טיוטת בקשה

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

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

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

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

כדי לשלוח טיוטה של בקשה למקום שמור לעתיד לבדיקה של Google Cloud , בוחרים אחת מהאפשרויות הבאות:

המסוף

  1. פותחים את הדף Reservations במסוף Google Cloud .

    כניסה לדף Reservations

  2. לוחצים על הכרטיסייה Future reservations.

  3. בעמודה Name, לוחצים על השם של בקשת מקום שמור לעתיד עם סטטוס הרכש Drafting. ייפתח הדף Future reservations עם הפרטים של הבקשה למקום שמור לעתיד.

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

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

gcloud

כדי לשלוח לבדיקה טיוטה של בקשה למקום שמור לעתיד, משתמשים בפקודה gcloud compute future-reservations update עם הדגל --planning-status שמוגדר ל-SUBMITTED.

gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

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

  • ‫FUTURE_RESERVATION_NAME: השם של בקשה קיימת למקום שמור לעתיד שנמצאת בשלב הטיוטה.

  • ‫ZONE: האזור שבו נמצאת הבקשה למקום שמור לעתיד.

REST

כדי לשלוח טיוטה של בקשה למקום שמור לעתיד לבדיקה, שולחים בקשת PATCH ל-method‏ futureReservations.update. בכתובת ה-URL של הבקשה, מוסיפים את הפרמטר updateMask של השאילתה, מוגדר ל-planningStatus.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

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

  • ‫PROJECT_ID: מזהה הפרויקט שבו נמצאת הבקשה למקום שמור לעתיד.

  • ‫ZONE: האזור שבו נמצאת הבקשה למקום שמור לעתיד.

  • ‫FUTURE_RESERVATION_NAME: השם של טיוטה קיימת של בקשה למקום שמור לעתיד.

אחרי ששולחים לבדיקה טיוטה של בקשה למקום שמור לעתיד, אפשר:

פתרון בעיות

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

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

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