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

המסוף

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

   כניסה לדף Reservations

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

3. בעמודה Name, לוחצים על השם של בקשת מקום שמור לעתיד שרוצים לשנות.

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

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

   • כדי לשנות את אפשרות המחיקה האוטומטית, בשורה Auto-created reservations auto-delete time, לוחצים על edit Edit ומבצעים את הפעולות הבאות:

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

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

          1. לוחצים על המתג הפעלת מחיקה אוטומטית כדי להפעיל אותו.

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

        • אם לא רוצים שהבקשות יימחקו אוטומטית, לוחצים על המתג Enable auto-delete כדי להשבית אותו.

     2. לוחצים על שליחה.

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

     1. מזינים קידומת חדשה לשם בשדה Prefix.

     2. לוחצים על שליחה.

   • כדי לשנות את התיאור, בשורה Description, לוחצים על edit Edit ופועלים לפי השלבים הבאים:

     1. בקטע תיאור, מזינים תיאור חדש.

     2. לוחצים על שליחה.

5. לוחצים על edit עריכה או על edit עריכת הטיוטה.

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

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

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

   • בקטע תיאור, מזינים תיאור חדש.

   • משנים את שעת ההתחלה או את שעת הסיום של הבקשה למקום שמור לעתיד. חשוב לוודא את הדברים הבאים:

     • שעת ההתחלה של בקשת מקום שמור לעתיד יכולה להיות עד שנה קדימה.

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

     • כדי להגדיל את הסיכוי שהבקשה תאושר ב- Cloud de Confiance , כדאי להשתמש בתקופה המומלצת לשמירת מקום.

   • בקטע Share type, בוחרים באפשרות Local או Shared. אם בוחרים באפשרות משותף, אפשר להוסיף או להסיר פרויקטים כדי לשתף איתם את מקום שמור לעתיד. אפשר לכלול עד 100 פרויקטים.

   • בשדה Number of VM instances, מציינים את המספר הכולל של המכונות הווירטואליות שרוצים לשריין.

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

     • סדרת המכונות וסוג המכונה שמשמשים במכונות הווירטואליות השמורות.

     • יחידות ה-GPU לצירוף למכונות הווירטואליות השמורות.

     • דיסקים של SSD מקומיים וסוג ממשק הדיסק של מכונות וירטואליות מוזמנות.

   • בקטע Auto-generated reservations auto-delete, אפשר להפעיל או להשבית את המחיקה האוטומטית של מקומות שמורים שנוצרו אוטומטית עבור מקום שמור לעתיד.

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

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

     • כדי לשמור את השינויים, לוחצים על שמירת טיוטה.

     • כדי לשלוח את הטיוטה של הבקשה למקום שמור לעתיד ל-Cloud de Confiance לבדיקה, לוחצים על 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, מבצעים אחת מהפעולות הבאות:

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

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

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

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

• ‫DESCRIPTION: תיאור חדש של בקשת ההזמנה העתידית.

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

  • כדי להוסיף דיסקים מסוג Local SSD או לערוך את סוג ממשק הדיסק, מחליפים את INTERFACE באחד מהערכים הבאים:

    • אם קובץ האימג' של דיסק האתחול כולל מנהלי התקנים אופטימליים של NVMe: nvme.

    • אחרת: scsi.

    כוללים את הדגל --local-ssd לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים של Local SSD.

  • כדי להסיר את כל דיסקי ה-SSD המקומיים שמצורפים למכונות הווירטואליות השמורות, מסירים את כל הדגלים --local-ssd ומוסיפים את הדגל --clear-local-ssd.

• ‫MACHINE_TYPE: סוג המכונה החדש שבו רוצים להשתמש בכל מכונה וירטואלית שמורה. אם משנים את סוג המכונה, צריך לציין גם תקופת הזמנה מינימלית מומלצת לסדרת המכונות החדשה. אחרת,סביר להניח ש- Cloud de Confiance תדחה את בקשת השינוי.

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

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

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

• להמיר את הבקשה לבקשה לשריון מקום שמור לעתיד לפרויקט מסוים.

• משביתים את אפשרות המחיקה האוטומטית.

• לשריין 100 מכונות וירטואליות.

• שולחים את הבקשה למקום שמור לעתיד ל- Cloud de Confiance לבדיקה.

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

• ‫MINIMUM_CPU_PLATFORM: פלטפורמת CPU חדשה לשימוש בכל מכונה וירטואלית שמורה.

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

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

• ‫END_TIME: שעת הסיום החדשה של תקופת ההזמנה, בפורמט חותמת זמן RFC 3339. כדי להגדיל את הסיכוי שהבקשה תאושר ב-Cloud de Confiance , כדאי להשתמש בתקופה המינימלית לשמירת מקום. כדי לציין משך זמן במקום שעת סיום, מחליפים את השדה 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 מכונות וירטואליות.

• שולחים את הבקשה למקום שמור לעתיד ל- Cloud de Confiance לבדיקה.

כדי לשנות את 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"
  }
}