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

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

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

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

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

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

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

  • מומלץ: בחירת תבנית מכונה

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

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

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

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

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

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

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

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

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

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

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

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

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

המסוף

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

    כניסה לדף Reservations

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

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

  4. בקטע Machine configuration:

    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 , השתמשו בתקופה המומלצת לשמירת מקום.

  8. לוחצים על Next.

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

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

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

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

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

  10. לוחצים על Next.

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

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

  13. כדי לשמור טיוטה של הבקשה, לוחצים על 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 , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, מחליפים את הדגל --end-time בדגל --duration=END_DURATION. מחליפים את END_DURATION במשך זמן בשניות. לדוגמה, אפשר לציין 1209600 ל-1,209,600 שניות (14 ימים).

    כדי להגדיל את הסיכוי שהבקשה למקום שמור לעתיד תאושר ב- Google Cloud , כדאי להשתמש במשך הזמן המינימלי המומלץ.

  • 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

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

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

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

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
  },
  "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: המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

  • 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 , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, אפשר להחליף את השדה endTime בשדה duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    מחליפים את END_DURATION במשך הזמן בשניות. לדוגמה, מציינים 1209600 ל-1,209,600 שניות (14 ימים).

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם 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
  },
  "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
      },
      "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
        },
        "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
        },
        "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 future reservation‎. ייפתח הדף Create a future reservation.

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

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

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

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

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

  7. בקטע Reservation period:

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

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

  8. לוחצים על Next.

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

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

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

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

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

  10. לוחצים על Next.

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

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

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

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

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

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

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

המסוף

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

    כניסה לדף Reservations

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

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

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

    1. בוחרים באפשרות Specify machine type (ציון סוג המכונה) אם היא לא מסומנת.

    2. מציינים את סוג המכונה שבה רוצים להשתמש במכונות הווירטואליות שהוזמנו.

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

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

  7. בקטע Reservation period:

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

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

  8. לוחצים על Next.

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

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

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

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

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

  10. לוחצים על Next.

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

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

  13. כדי לשמור טיוטה של הבקשה, לוחצים על 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 , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, מחליפים את הדגל --end-time בדגל --duration=END_DURATION. מחליפים את END_DURATION במשך זמן בשניות. לדוגמה, אפשר לציין 1209600 ל-1,209,600 שניות (14 ימים).

    כדי להגדיל את הסיכוי שהבקשה למקום שמור לעתיד תאושר ב- Google Cloud , כדאי להשתמש במשך הזמן המינימלי המומלץ.

  • 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

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

  • כדי לצרף יחידות 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 שרוצים להוסיף לכל מכונה וירטואלית (VM) מוזמנת.

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

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

    • כדי למחוק את הבקשות שנוצרו אוטומטית בתאריך ובשעה ספציפיים אחרי שעת הסיום של שמירת המקום, צריך לכלול את האפשרות --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
    
  • כדי לצרף דיסקים של SSD מקומיים לסוג מכונה שלא כולל דיסקים של 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

  • כדי שמכונות ה-VM השמורות ישתמשו בפלטפורמת 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 זמינה באזור שבו אתם מזמינים משאבים, אפשר לראות את פלטפורמות ה-CPU הזמינות לפי אזור.

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

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
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

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

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

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

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

  • 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 , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, אפשר להחליף את השדה endTime בשדה duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    מחליפים את END_DURATION במשך הזמן בשניות. לדוגמה, מציינים 1209600 ל-1,209,600 שניות (14 ימים).

לדוגמה, נניח שאתם רוצים ליצור טיוטה של בקשה למקום שמור לעתיד בשם fr-01 באזור 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
  },
  "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
      },
      "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
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

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

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

    לדוגמה, כדי לציין שני דיסקים של 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
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

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

  • כדי שמכונות ה-VM השמורות ישתמשו בפלטפורמת 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
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

    • כדי למחוק את הבקשות שנוצרו אוטומטית אחרי פרק זמן מסוים מסיום שמירת המקום, מגדירים את 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
        },
        "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
        },
        "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: השם של בקשה קיימת למקום שמור לעתיד שנמצאת בשלב הטיוטה.

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

פתרון בעיות

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

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

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