‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שינוי בקשות למקום שמור לעתיד

במאמר הזה מוסבר איך לשנות בקשות למקום שמור לעתיד.

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

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

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

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

כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים Google Cloud ולממשקי ה-API, לא צריך להגדיר אימות.
gcloud
1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
  gcloud init
  אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
  
  הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.
הגדרת אזור ותחום כברירת מחדל

REST

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

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

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

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

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

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

התפקיד המוגדר מראש הזה כולל את ההרשאה compute.futureReservations.update, שנדרשת כדי לשנות בקשות להזמנות עתידיות.

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

מאפיינים שאפשר לשנות

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

אחרי היצירה

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

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

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

לפני השליחה

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

אפשרות מחיקה אוטומטית
תיאור
מעבדי GPU וסוג ה-GPU
דיסקים מקומיים מסוג SSD וסוג הממשק של הדיסקים
סדרת המכונות וסוג המכונה
פלטפורמת CPU מינימלית
תחילית שם
שיתוף ההגדרות
שעת ההתחלה ושעת הסיום של תקופת ההזמנה
מספר כולל (מספר המכונות הווירטואליות)

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

אחרי האישור

אחרי ש- Google Cloud מאשר הזמנה לעתיד, אפשר לשנות אותה לפני שהסטטוס שלה משתנה ל'הקצאת משאבים' (PROVISIONING). באופן ספציפי, אפשר לשנות את המאפיינים הבאים:

שינוי המקום השמור לעתיד בכל שלב:
- אפשרות המחיקה האוטומטית
- תיאור
- תחילית שם
שולחים בקשה לשינוילא לפני 72 שעות לפני שעת ההתחלה:
- מעבדים גרפיים וסוג המעבד הגרפי^*
- דיסקים של SSD מקומי וסוג הממשק של הדיסקים^*
- סדרת מכונות וסוג מכונה^*
- פלטפורמת CPU מינימלית^*
- שיתוף ההגדרות
- שעת ההתחלה ושעת הסיום של שמירת המקום
- הספירה הכוללת (מספר המכונות הווירטואליות)^*

‫^* אם תבקשו לשנות מאפיינים של מכונות וירטואליות, או להגדיל או להקטין באופן משמעותי את המספר הכולל, בטווח של 14 ימים משעת ההתחלה של המקום השמור לעתיד, סביר להניח ש- Google Cloud תדחה את בקשת השינוי.

שינוי בקשות למקומות שמורים לעתיד

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

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

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

המסוף

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

כניסה לדף Reservations
לוחצים על הכרטיסייה Future reservations (הזמנות עתידיות).
בעמודה Name, לוחצים על השם של בקשת מקום שמור לעתיד שרוצים לשנות.

ייפתח דף הפרטים של הבקשה למקום שמור לעתיד שנבחרה.
אם רוצים לשנות את אפשרות המחיקה האוטומטית, התיאור או הקידומת של השם של מקום שמור מאושר לעתיד, אפשר לבצע אחת או יותר מהפעולות הבאות:
- כדי לשנות את אפשרות המחיקה האוטומטית, בשורה Auto-created reservations auto-delete time לוחצים על Edit ומבצעים את הפעולות הבאות:
  1. כדי להפעיל, להשבית או לשנות את אפשרות המחיקה האוטומטית, מבצעים אחת מהפעולות הבאות:
    - כדי להפעיל את אפשרות המחיקה האוטומטית או לשנות את השעה שבה Compute Engine מוחק אוטומטית את המקומות השמורים שנוצרו אוטומטית:
      1. לוחצים על המתג הפעלת מחיקה אוטומטית כדי להפעיל אותו.
      2. אם רוצים, מזינים בשדה Auto-delete time את התאריך והשעה החדשים למחיקת הבקשות שנוצרו אוטומטית. התאריך והשעה צריכים להיות אחרי מועד הסיום של שמירת המקום. אם תשאירו את השדה ריק, הבקשות שנוצרו אוטומטית יימחקו תוך שעתיים מסיום שמירת המקום.
    - אם לא רוצים שהבקשות יימחקו אוטומטית, לוחצים על המתג Enable auto-delete כדי להשבית אותו.
  2. לוחצים על שליחה.
- כדי לשנות את הקידומת לשם, בשורה Prefix לוחצים על Edit, ואז מבצעים את הפעולות הבאות:
  1. מזינים קידומת חדשה לשם בשדה Prefix.
  2. לוחצים על שליחה.
- כדי לשנות את התיאור, בשורה Description לוחצים על Edit ופועלים לפי השלבים הבאים:
  1. בשדה Description, מזינים תיאור חדש.
  2. לוחצים על שליחה.
לוחצים על עריכה או על עריכת הטיוטה.

ייפתח הדף לעריכת בקשת מקום שמור לעתיד שנבחרה.
כדי לשנות בקשה למקום שמור לעתיד ולשלוח אותה ל-Google Cloud לבדיקה, או כדי לשמור את הטיוטה של הבקשה, מבצעים אחת או יותר מהפעולות הבאות:
- בשדה Prefix, מזינים קידומת חדשה לשם של המקומות השמורים שנוצרו אוטומטית והוקצו לבקשה הזו למקום שמור לעתיד.
- בקטע תיאור, מזינים תיאור חדש.
- משנים את שעת ההתחלה או את שעת הסיום של הבקשה למקום שמור לעתיד. חשוב לוודא את הדברים הבאים:
  - שעת ההתחלה של בקשת מקום שמור לעתיד יכולה להיות עד שנה קדימה.
  - כדי שיהיה לכם מספיק זמן לפני שהבקשה לשמירת מקום לעתיד ננעלת, כדאי לציין שעת התחלה מומלצת.
  - כדי להגדיל את הסיכוי שהבקשה תאושר ב- Google Cloud , כדאי להשתמש בתקופה המומלצת לשמירת מקום.
- בקטע Share type, בוחרים באפשרות Local או Shared. אם בוחרים באפשרות Shared, אפשר להוסיף או להסיר פרויקטים שאיתם רוצים לשתף את מקום שמור לעתיד. אפשר לכלול עד 100 פרויקטים.
- בשדה Number of VM instances, מציינים את המספר הכולל של המכונות הווירטואליות שרוצים לשריין.
  
  שימו לב: אם אתם רוצים להגדיל את מספר מכונות ה-VM שאתם מבקשים לשריין, אתם צריכים לוודא שיש לכם מספיק מכסה למשאבים הנוספים שאתם מבקשים לשריין. אחרת, Google Cloud בקשת השינוי תידחה.
- אם אתם משנים מקום שמור לעתיד שלא נוצר באמצעות תבנית של הגדרות מכונה, בקטע Machine configuration תוכלו לשנות את הפרטים הבאים:
  - סדרת המכונות וסוג המכונה שבהם משתמשים במכונות הווירטואליות השמורות.
  - מעבדי ה-GPU שצריך לצרף למכונות הווירטואליות השמורות.
  - דיסקי ה-SSD המקומיים וסוג ממשק הדיסק של מכונות ה-VM השמורות.
- בקטע Auto-generated reservations auto-delete, אפשר להפעיל או להשבית את המחיקה האוטומטית של מקומות שמורים שנוצרו אוטומטית עבור מקום שמור לעתיד.
בהתאם לסטטוס הרכש של הבקשה למקום שמור לעתיד שאתם משנים, מבצעים אחת מהפעולות הבאות:
- אם משנים טיוטה של בקשה למקום שמור לעתיד, מבצעים אחת מהפעולות הבאות:
  - כדי לשמור את השינויים, לוחצים על שמירת טיוטה.
  - כדי לשלוח את טיוטת הבקשה למקום שמור לעתיד לבדיקה שלGoogle Cloud , לוחצים על Submit.
- אם לא, לוחצים על שליחה.

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

gcloud

כדי לשנות בקשה למקום שמור לעתיד, משתמשים בפקודה gcloud compute future-reservations update.

gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

‫FUTURE_RESERVATION_NAME: השם של בקשת ההזמנה העתידית.
‫PLANNING_STATUS: סטטוס התכנון של הבקשה למקום שמור לעתיד. מציינים אחד מהערכים הבאים:
- כדי לשנות טיוטה של בקשה למקום שמור לעתיד בלי לשלוח אותה לבדיקה: DRAFT.
- כדי לשלוח את הבקשה למקום שמור לעתיד לבדיקה: SUBMITTED.
‫ZONE: האזור שבו נמצאת הבקשה למקום שמור לעתיד.

מחליפים את אחד או יותר מה-placeholder הבאים, או מסירים אותם יחד עם הדגלים התואמים שלהם:

כדי לאפשר ל-Compute Engine למחוק את שאר הבקשות שנוצרו אוטומטית אחרי סיום שמירת המקום, מבצעים אחת מהפעולות הבאות:
- כדי למחוק את שמירת המקום תוך שעתיים אחרי שעת הסיום (ברירת מחדל), צריך לכלול את הדגל --auto-delete-auto-created-reservations.
```
gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
- כדי למחוק את הבקשות שנוצרו אוטומטית בשעה מסוימת אחרי סיום שמירת המקום, מוסיפים את הדגלים --auto-delete-auto-created-reservations ו---auto-created-reservations-delete-time.
```
gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  מחליפים את AUTO_CREATED_RESERVATIONS_DELETE_TIME בתאריך ובשעה בפורמט של חותמת זמן RFC 3339.
- כדי למחוק את הבקשות שנוצרו אוטומטית אחרי פרק זמן מסוים מסיום שמירת המקום, כוללים את הדגלים --auto-delete-auto-created-reservations ו---auto-created-reservations-duration.
```
gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  מחליפים את DURATION_BEFORE_DELETE במשך זמן בימים, בשעות, בדקות או בשניות. לדוגמה, מציינים 30m ל-30 דקות, או 1d2h3m4s ליום אחד, שעתיים, 3 דקות ו-4 שניות.
כדי להשבית את המחיקה האוטומטית של המקומות השמורים שנוצרו אוטומטית ב-Compute Engine עבור בקשה זו למקום שמור לעתיד, צריך להוסיף את הדגל --no-auto-delete-auto-created-reservations.
```
gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
כדי להוסיף או להסיר יחידות GPU שמצורפות למכונות וירטואליות מסוג N1 שהוזמנו, או לעדכן את סוג ה-GPU, מבצעים אחת מהפעולות הבאות:
- כדי לשנות את מספר ה-GPU ואת הסוג שלהם, מחליפים את הערכים הבאים:
  - ‫NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף לכל מכונה וירטואלית מוזמנת.
  - ‫ACCELERATOR_TYPE: סוג ה-GPU שרוצים להוסיף למכונות הווירטואליות שהוזמנו. מוודאים שה-GPU זמין בתחום שבו נמצאת הבקשה למקום שמור לעתיד. אחרת, שינוי הבקשה ייכשל.
- כדי להסיר את כל יחידות ה-GPU שמחוברות למכונות וירטואליות מסוג N1 ששמורות, מחליפים את הדגל --accelerator בדגל --clear-accelerator.
‫DESCRIPTION: תיאור חדש של בקשת ההזמנה העתידית.
כדי להוסיף או להסיר דיסקים מסוג Local SSD מהמכונות הווירטואליות השמורות, או כדי לערוך את סוג הממשק של הדיסק מסוג Local SSD, מבצעים אחת מהפעולות הבאות:
- כדי להוסיף דיסקים מסוג Local SSD או לערוך את סוג ממשק הדיסק, מחליפים את INTERFACE באחד מהערכים הבאים:
  - אם קובץ האימג' של דיסק האתחול כולל מנהלי התקנים של NVMe שעברו אופטימיזציה: nvme.
  - אחרת: scsi.
  כוללים את הדגל --local-ssd לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים של Local SSD.
- כדי להסיר את כל דיסקי ה-SSD המקומיים שמחוברים למכונות הווירטואליות השמורות, מסירים את כל הדגלים של --local-ssd וכוללים את הדגל --clear-local-ssd.
‫MACHINE_TYPE: סוג המכונה החדש שבו רוצים להשתמש בכל מכונה וירטואלית שמורה. אם משנים את סוג המכונה, צריך לציין גם תקופת הזמנה מינימלית מומלצת לסדרת המכונות החדשה. אחרת,סביר להניח ש- Google Cloud תדחה את בקשת השינוי.
‫MINIMUM_CPU_PLATFORM: פלטפורמת CPU מינימלית חדשה לשימוש בכל מכונה וירטואלית שמורה.
‫NAME_PREFIX: קידומת חדשה לשם של המקומות השמורים שנוצרו אוטומטית והוקצו לבקשת המקום השמור לעתיד.
‫SHARE_SETTING: סוג השיתוף החדש לבקשת ההזמנה העתידית. מציינים אחד מהערכים הבאים:
- לבקשה למקום שמור לעתיד לפרויקט יחיד: local. כדי למנוע שגיאות, צריך גם להחליף את הדגל --share-with בדגל --clear-share-settings.
- לגבי בקשה משותפת למקום שמור לעתיד: projects. כדי למנוע שגיאות, צריך לציין גם לפחות פרויקט צרכן אחד בדגל --share-with.
‫CONSUMER_PROJECT_IDS: רשימה מופרדת בפסיקים של מזהי הפרויקטים שרוצים לשתף איתם את בקשת ההזמנה העתידית. לדוגמה: project-1,project-2. אפשר לציין עד 100 פרויקטים לצרכן.
‫START_TIME: שעת ההתחלה החדשה של תקופת ההזמנה בפורמט של חותמת זמן RFC 3339. שעת ההתחלה של בקשת שינוי יכולה להיות עד שנה קדימה. כדי שיהיה לכם מספיק זמן לבטל, למחוק או לשנות את הבקשה למקום שמור לעתיד אחרי שהיא אושרה ולפני שהיא ננעלת, כדאי לציין שעת התחלה מומלצת.
‫END_TIME: שעת הסיום החדשה של תקופת ההזמנה, בפורמט חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , כדאי להשתמש בתקופה המומלצת לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, מחליפים את הדגל --end-time בדגל --duration=END_DURATION. מחליפים את END_DURATION במשך תקופת ההזמנה בשניות. לדוגמה, מציינים 1209600 ל-1,209,600 שניות (14 ימים).

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

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

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

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

gcloud compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

כדי לשנות בקשה למקום שמור לעתיד, שולחים בקשת PATCH ל-method‏ futureReservations.update.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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

‫PROJECT_ID: מזהה הפרויקט שבו נמצאת הבקשה למקום שמור לעתיד.
‫ZONE: האזור שבו נמצאת הבקשה למקום שמור לעתיד.
‫FUTURE_RESERVATION_NAME: השם של בקשת ההזמנה העתידית.
‫UPDATE_FIELDS: רשימה מופרדת בפסיקים של שדות לעדכון בגוף הבקשה. צריך לקודד כל פסיק כ-%2C. אם מציינים שדה בפרמטר השאילתה updateMask ובגוף הבקשה, הערך של השדה מתעדכן. אחרת, אם מציינים את השדה רק בפרמטר השאילתה updateMask, השדה יימחק.

לדוגמה, כדי לעדכן את השדות autoDeleteAutoCreatedReservations, totalCount ו-endTime בבקשה למקום שמור לעתיד, צריך לציין את הפרטים הבאים:
```
autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
```
‫PLANNING_STATUS: סטטוס התכנון של הבקשה למקום שמור לעתיד. מציינים אחד מהערכים הבאים:
- כדי לשנות טיוטה של בקשה למקום שמור לעתיד בלי לשלוח אותה לבדיקה: DRAFT.
- כדי לשלוח את הבקשה לשינוי לבדיקה: SUBMITTED.

מחליפים אחד או יותר מה-placeholder הבאים, או מסירים אותם יחד עם השדות התואמים:

‫AUTO_DELETE_AUTO_CREATED_RESERVATIONS: אם מגדירים את השדה הזה לערך true, מערכת Compute Engine מוחקת אוטומטית את המקומות השמורים שנוצרו אוטומטית שהוקצו לבקשה למקום שמור לעתיד. כברירת מחדל, המחיקה מתבצעת תוך שעתיים מסיום שמירת המקום. כדי לשנות את זה, מבצעים אחת מהפעולות הבאות:
- כדי למחוק את הבקשות שנוצרו אוטומטית בשעה מסוימת אחרי שעת הסיום של תקופת שמירת המקום, מגדירים את autoDeleteAutoCreatedReservations לערך true ומציינים את השעה בשדה autoCreatedReservationsDeleteTime.
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  מחליפים את DELETE_TIME בתאריך ובשעה שבהם Compute Engine ימחק את ההזמנות. התאריך והשעה צריכים להיות בפורמט של חותמת זמן לפי RFC 3339.
- כדי למחוק את הבקשות שנוצרו אוטומטית אחרי משך זמן מסוים משעת ההתחלה של שמירת המקום, מגדירים את autoDeleteAutoCreatedReservations ל-true ומציינים את השדה autoCreatedReservationsDuration.
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  מחליפים את DURATION_BEFORE_DELETE במשך זמן בשניות. לדוגמה, מציינים 604800 ל-604,800 שניות (7 ימים).
‫DESCRIPTION: תיאור חדש של בקשת ההזמנה העתידית.
‫NAME_PREFIX: תחילית חדשה לשם של המקומות השמורים שנוצרו אוטומטית והוקצו לבקשה שלכם למקום שמור לעתיד.
‫CONSUMER_PROJECT_ID_1 ו-CONSUMER_PROJECT_ID_2: המזהים של הפרויקטים שרוצים לשתף איתם את הבקשה למקומות שמורים לעתיד. הפרויקטים צריכים להיות באותו ארגון כמו פרויקט הבעלים. אפשר לציין עד 100 פרויקטים לצרכן.
‫SHARE_TYPE: סוג השיתוף החדש לבקשת ההזמנה העתידית. מבצעים אחת מהפעולות הבאות:
- כדי לציין בקשה למקום שמור לעתיד לפרויקט מסוים:
  - מציינים LOCAL.
  - מסירים את השדה shareSettings.projects.
- כדי לציין בקשה לשמירת מקום משותפת לעתיד:
  - מציינים את SPECIFIC_PROJECTS.
  - צריך לציין לפחות פרויקט צרכן אחד בשדה shareSettings.projects. פרויקטים של צרכנים צריכים להיות באותו ארגון כמו פרויקט הבעלים. אפשר לציין עד 100 פרויקטים של צרכנים.
כדי לשנות את המספר והסוג של יחידות ה-GPU שיוצמדו למכונות הווירטואליות מסוג N1 שהוזמנו, צריך להחליף את הערכים הבאים:
- ‫NUMBER_OF_ACCELERATORS: מספר יחידות ה-GPU שרוצים להוסיף לכל מכונה וירטואלית (VM) שהוזמנה.
- ‫ACCELERATOR_TYPE: סוג ה-GPU שרוצים להוסיף למכונות הווירטואליות שהוזמנו. מוודאים שה-GPU זמין בתחום שבו נמצאת הבקשה למקום שמור לעתיד. אחרת, שינוי הבקשה ייכשל.
‫INTERFACE_1 ו-INTERFACE_2: סוג הממשק של דיסקי ה-SSD המקומיים שמחוברים לכל מכונה וירטואלית שמורה. מציינים את אחד מהערכים הבאים:
- אם קובץ האימג' של דיסק האתחול כולל מנהלי התקנים של NVMe שעברו אופטימיזציה: NVME.
- אחרת: SCSI.
  
  אפשר לציין עד 24 דיסקים של Local SSD.
‫MACHINE_TYPE: סוג המכונה החדש שבו רוצים להשתמש בכל מכונה וירטואלית שמורה. אם משנים את סוג המכונה, צריך לציין גם תקופת הזמנה מינימלית מומלצת לסדרת המכונות החדשה. אחרת,יש סיכוי נמוך יותר ש- Google Cloud יאשר את הבקשה לשינוי.
‫MINIMUM_CPU_PLATFORM: פלטפורמת CPU מינימלית חדשה לשימוש בכל מכונה וירטואלית שמורה.
‫TOTAL_COUNT: המספר הכולל החדש של המכונות הווירטואליות שרוצים לשריין לאותה תקופה, לפי ההגדרות והפרויקטים שצוינו בבקשה למקום שמור לעתיד. אם רוצים להגדיל את המספר הכולל, צריך לוודא שיש לכם מכסה מספקת למשאבים שאתם מזמינים. אחרת, Google Cloud תדחה את בקשת השינוי.
‫START_TIME: שעת ההתחלה החדשה של תקופת ההזמנה בפורמט של חותמת זמן RFC 3339. שעת ההתחלה של בקשת שינוי יכולה להיות עד שנה קדימה. כדי שיהיה לכם מספיק זמן לבטל, למחוק או לשנות את הבקשה למקום שמור לעתיד אחרי שהיא אושרה ולפני שהיא ננעלת, כדאי לציין שעת התחלה מומלצת.
‫END_TIME: שעת הסיום החדשה של תקופת ההזמנה, בפורמט חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Google Cloud , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, מחליפים את השדה endTime בשדה duration:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS",
  "timeWindow": {
    "duration": {
      "seconds": "END_DURATION"
    }
  }
}
```
מחליפים את END_DURATION במשך הזמן בשניות. לדוגמה, מציינים 1209600 ל-1,209,600 שניות (14 ימים).

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

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

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

כדי לשנות את fr-03, שולחים בקשת PATCH באופן הבא:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

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

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

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

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

פתרון בעיות

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

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

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

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

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

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

המסוף

gcloud

REST

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

מאפיינים שאפשר לשנות

אחרי היצירה

לפני השליחה

אחרי האישור

שינוי בקשות למקומות שמורים לעתיד

המסוף

gcloud

REST

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

פתרון בעיות

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

שינוי בקשות למקום שמור לעתיד