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

שינוי הזמנות

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

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

מגבלות

כשמשנים הזמנה, חלות המגבלות הבאות:

אפשר לשנות הזמנה משותפת רק מהפרויקט שבו היא קיימת.
אתם יכולים לשנות מקום שמור שנוצר אוטומטית (auto-created) למקום שמור לעתיד במצב יומן, או מקום שמור לעתיד של בלוקים של קיבולת, בכל שלב ורק באופן הבא:
אפשר לשנות מקום שמור לעתיד שנוצר אוטומטית רק בדרכים הבאות:
- אחרי שעת ההתחלה, אתם יכולים לבצע את הפעולות הבאות:
- אחרי שעת הסיום, אתם יכולים:
  - שינוי מספר המכונות השמורות ב-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 באמצעות המאגר המאוחד לניהול זהויות.
  
  הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.
הגדרת אזור ותחום כברירת מחדל.

REST

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

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

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

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

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

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

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

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

כדי לשנות הזמנות נדרשות ההרשאות הבאות:

כדי לשנות את אפשרות המחיקה האוטומטית בהזמנה, את סוג השימוש או סוג השיתוף בהזמנה, או את האפשרות שמשימות של Vertex AI יוכלו להשתמש בהזמנה של מכונות וירטואליות עם יחידות GPU צמודות: compute.reservations.update בפרויקט
כדי לשנות את מספר המכונות של Compute Engine בהזמנה: compute.reservations.resize בפרויקט

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

שינוי הזמנות

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

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

שינוי מספר המכונות השמורות של Compute Engine בהזמנה

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

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

כדי לשנות את מספר מכונות ה-Compute ששוריינו בהזמנה, בוחרים באחת מהאפשרויות הבאות:

המסוף

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

כניסה לדף Reservations
בכרטיסייה On-demand reservations (ברירת המחדל), בעמודה Name לוחצים על שם המקום השמור שרוצים לשנות. ייפתח דף עם פרטי ההזמנה.
לוחצים על עריכה.
בשדה Number of VM instances, מזינים את המספר המעודכן של מכונות וירטואליות שרוצים לשריין.
כדי לאשר, לוחצים על שמירה.

gcloud

כדי לשנות את מספר המכונות השמורות בהזמנה, משתמשים בפקודה gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

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

‫RESERVATION_NAME: שם ההזמנה.
‫NUMBER_OF_VMS: המספר החדש של מכונות וירטואליות לחישוב שרוצים לשריין.
‫ZONE: האזור שבו נמצאת ההזמנה.

REST

כדי לשנות את מספר המכונות הווירטואליות השמורות בהזמנה, שולחים בקשת POST אל ה-method‏ reservations.resize.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

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

‫PROJECT_ID: מזהה הפרויקט שבו קיימת ההזמנה.
‫ZONE: האזור שבו נמצאת ההזמנה.
‫RESERVATION_NAME: שם ההזמנה.
NUMBER_OF_VMS: המספר החדש של מכונות ה-Compute שרוצים לשמור.

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

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

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

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

gcloud

כדי לשנות את סוג השיתוף של ההזמנה, משתמשים בפקודה gcloud compute reservations update.

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

כדי להמיר מקום שמור לפרויקט יחיד למקום שמור משותף, צריך לכלול את הדגלים --add-share-with ו---share-setting=projects:
```
gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --share-setting=projects \
    --zone=ZONE
```
כדי להמיר מקום שמור משותף למקום שמור לפרויקט יחיד, צריך לכלול את הדגל --share-setting=local:
```
gcloud compute reservations update RESERVATION_NAME \
    --share-setting=local \
    --zone=ZONE
```

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

‫RESERVATION_NAME: שם ההזמנה שרוצים לשנות.
‫CONSUMER_PROJECT_IDS: רשימה מופרדת בפסיקים של מזהי הפרויקטים שאיתם רוצים לשתף את ההזמנה, לדוגמה project-1,project-2. אפשר לשתף הזמנה עם עד 100 פרויקטים שנמצאים באותו ארגון כמו הפרויקט שבבעלותכם.
‫ZONE: האזור שבו נמצאת ההזמנה.

REST

כדי לשנות את סוג השיתוף של בקשה לשמירת מקום, צריך לשלוח בקשת PATCH ל-method‏ reservations.update.

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

כדי להמיר מקום שמור לפרויקט יחיד למקום שמור משותף, שולחים בקשה באופן הבא: בכתובת ה-URL של הבקשה, מוסיפים את הפרמטר paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER של השאילתה לכל פרויקט שרוצים לשתף איתו את ההזמנה.

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

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

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

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

‫PROJECT_ID: מזהה הפרויקט שבו נמצאת ההזמנה (הפרויקט של הבעלים).
‫ZONE: האזור שבו קיימת ההזמנה.
‫RESERVATION_NAME: שם ההזמנה שרוצים לשנות.
‫CONSUMER_PROJECT_ID_OR_NUMBER_1 ו-CONSUMER_PROJECT_ID_OR_NUMBER_2: המזהה או המספר של שני הפרויקטים שרוצים לשתף איתם את ההזמנה.

שינוי פרויקטים של צרכנים במקום שמור משותף

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

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

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

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

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

המסוף

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

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

דף הפרטים של ההזמנה נפתח.
לוחצים על עריכה.
בקטע Selected projects, מבצעים אחת מהפעולות הבאות:
- כדי להפסיק את השיתוף של ההזמנה עם פרויקט צרכן ספציפי, לוחצים על Delete.
- כדי להתחיל לשתף את ההזמנה עם פרויקט ספציפי אחד או יותר:
  1. ‫ Add projects.
  2. מסמנים את התיבה לצד כל פרויקט מהארגון של הפרויקט הבעלים שרוצים לשתף איתו את ההזמנה. אפשר לשתף מקום שמור משותף עם עד 100 פרויקטים לשימוש פרטי.
  3. לוחצים על בחירה.
כדי לאשר את השינויים, לוחצים על שמירה.

יכול להיות שיעברו כמה שניות עד שהשינוי בהזמנה יתעדכן.

gcloud

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

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

כדי לאפשר לפרויקט אחד או יותר להשתמש בהזמנה משותפת, משתמשים בפקודה gcloud compute reservations update עם הדגל --add-share-with.
```
gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של הזמנה משותפת קיימת.
- ‫CONSUMER_PROJECT_IDS: רשימה מופרדת בפסיקים של מזהי הפרויקטים שאיתם רוצים לשתף את ההזמנה, לדוגמה project-1,project-2. אפשר לשתף הזמנה משותפת עם עד 100 פרויקטים של צרכנים.
- ‫ZONE: האזור שבו נמצאת ההזמנה המשותפת.
כדי להפסיק את השימוש בהזמנה משותפת בפרויקט אחד או יותר, משתמשים בפקודה gcloud compute reservations update עם הדגל --remove-share-with.
```
gcloud compute reservations update RESERVATION_NAME \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של הזמנה משותפת קיימת.
- ‫CONSUMER_PROJECT_IDS: רשימה מופרדת בפסיקים של מזהי הפרויקטים שרוצים להפסיק לשתף איתם את השריין – לדוגמה, project-1,project-2.
- ‫ZONE: האזור שבו נמצאת ההזמנה המשותפת.
כדי להחליף את רשימת הפרויקטים שיכולים להשתמש בהזמנה משותפת, משתמשים בפקודה gcloud beta compute reservations update עם הדגל --share-with.

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.
```
gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של הזמנה משותפת קיימת.
- ‫ZONE: האזור שבו נמצאת ההזמנה המשותפת.
- ‫CONSUMER_PROJECT_IDS: רשימה מופרדת בפסיקים של מזהי הפרויקטים שאיתם רוצים לשתף את ההזמנה, לדוגמה project-1,project-2. אפשר לשתף הזמנה משותפת עם עד 100 פרויקטים של צרכנים.

REST

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

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

כדי לאפשר לפרויקט אחד או יותר לצרוך מקום שמור משותף, שולחים בקשת PATCH ל-method‏ reservations.update. בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER לכל פרויקט שרוצים לשתף איתו את ההזמנה.

לדוגמה, כדי לאפשר לשני פרויקטים לצרוך נתונים ממקום שמור משותף, שולחים בקשת PATCH באופן הבא. אתם יכולים לשתף הזמנה משותפת עם עד 100 פרויקטים של צרכנים.
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט שבו נמצא המקום השמור המשותף (הפרויקט של הבעלים).
- ‫ZONE: האזור שבו נמצאת ההזמנה המשותפת.
- ‫RESERVATION_NAME: השם של הזמנה משותפת קיימת.
- ‫CONSUMER_PROJECT_ID_OR_NUMBER_1 ו-CONSUMER_PROJECT_ID_OR_NUMBER_2: המזהה או המספר של שני הפרויקטים שרוצים לשתף איתם את ההזמנה.
כדי להפסיק לאפשר לפרויקט אחד או יותר להשתמש במשאבים שהוקצו במשותף, שולחים בקשת PATCH ל-method‏ reservations.update. בכתובת ה-URL של הבקשה, מוסיפים את הפרמטר paths=shareSettings.projectMap.PROJECT_NUMBER של השאילתה לכל פרויקט שרוצים להפסיק לשתף איתו את ההזמנה. בנוסף, צריך להשמיט את השדה shareSetting מגוף הבקשה.

לדוגמה, כדי להפסיק לאפשר לשני פרויקטים לצרוך הזמנה משותפת, שולחים בקשת PATCH באופן הבא:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME"
}
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט שבו נמצא המקום השמור המשותף (הפרויקט של הבעלים).
- ‫ZONE: האזור שבו נמצאת ההזמנה המשותפת.
- ‫RESERVATION_NAME: השם של הזמנה משותפת קיימת.
- ‫CONSUMER_PROJECT_NUMBER_1 ו-CONSUMER_PROJECT_NUMBER_2: המספרים של שני הפרויקטים שרוצים להפסיק לשתף איתם את השריין.

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

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

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

המסוף

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

כניסה לדף Reservations
בכרטיסייה On-demand reservations (ברירת המחדל), בעמודה Name, לוחצים על השם של ההזמנה של מכונות GPU שרוצים לשנות. ייפתח דף עם פרטי ההזמנה.
בשורה שיתוף עם שירותי Google Cloud אחרים, לוחצים על עריכת הגדרות השיתוף של השירות.
בחלונית שיתוף הזמנות, מבצעים אחת מהפעולות הבאות:
- כדי לאפשר למשימות של Vertex AI להשתמש במקום השמור, בוחרים באפשרות Share reservation.
- כדי לא לאפשר למשימות של Vertex AI להשתמש במקום שנשמר, בוחרים באפשרות Don't share reservation.
לוחצים על Save.

יכול להיות שיעברו כמה שניות עד שהשינוי בהזמנה יושלם.

gcloud

כדי לשנות את מדיניות השיתוף של הזמנה של מכונות GPU, משתמשים בפקודה gcloud compute reservations update עם הדגל --reservation-sharing-policy.

gcloud compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

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

‫RESERVATION_NAME: השם של הזמנה קיימת.
SHARING_POLICY: מדיניות השיתוף של ההזמנה. מציינים את אחד מהערכים הבאים:
- כדי לאפשר למשימות של Vertex AI להשתמש במקום השמור: ALLOW_ALL
- כדי למנוע ממשימות של Vertex AI לצרוך את המשאבים שהוקצו: DISALLOW_ALL
‫ZONE: האזור שבו קיימת ההזמנה

REST

כדי לשנות את מדיניות השיתוף של הזמנת מכונות GPU, שולחים בקשת PATCH ל-method‏ reservations.update. בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה paths שמוגדר לערך reservationSharingPolicy.serviceShareType.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

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

‫PROJECT_ID: מזהה הפרויקט שבו נמצאת ההזמנה.
‫ZONE: האזור שבו קיימת ההזמנה.
‫RESERVATION_NAME: השם של הזמנה קיימת.
SHARING_POLICY: מדיניות השיתוף של ההזמנה. מציינים את אחד מהערכים הבאים:
- כדי לאפשר למשימות של Vertex AI להשתמש במקום השמור: ALLOW_ALL
- כדי למנוע ממשימות של Vertex AI לצרוך את המשאבים שהוקצו: DISALLOW_ALL

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

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

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

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

המסוף

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

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

ייפתח דף הפרטים של ההזמנה.
בשורה זמן מחיקה אוטומטית לוחצים על עריכת זמן מחיקה אוטומטית.
בחלונית Update reservation (עדכון ההזמנה), מבצעים אחת מהפעולות הבאות:
- כדי למחוק את הבקשה לשמירת מקום בתאריך ובשעה מסוימים:
  1. אם אפשרות המחיקה האוטומטית עדיין לא מופעלת, לוחצים על המתג Enable auto-delete כדי להפעיל אותה.
  2. בשדה Auto-delete time, בוחרים את התאריך והשעה שבהם הבקשה לשמירת מקום תימחק אוטומטית ב-Compute Engine.
- אם לא רוצים שהבקשות יימחקו אוטומטית, לוחצים על המתג Enable auto-delete כדי להשבית אותו.
לוחצים על שליחה.

יכול להיות שיעברו כמה שניות עד שהשינוי בהזמנה יושלם.

gcloud

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

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

כדי למחוק את הבקשה לשמירת מקום בתאריך ובשעה ספציפיים, משתמשים בפקודה gcloud beta compute reservations update עם הדגל --delete-at-time.
```
gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של הזמנה קיימת.
- ‫DELETE_AT_TIME: תאריך ושעה בפורמט של חותמת זמן RFC 3339.
- ‫ZONE: האזור שבו נמצאת ההזמנה.
כדי למחוק את ההזמנה אחרי משך זמן מסוים, משתמשים בפקודה gcloud beta compute reservations update עם הדגל --delete-after-duration.
```
gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של הזמנה קיימת.
- ‫DELETE_AFTER_DURATION: משך הזמן בימים, בשעות, בדקות או בשניות לפני שהבקשה לשמירת מקום תימחק אוטומטית. לדוגמה, מציינים 30m ל-30 דקות, או 1d2h3m4s ליום אחד, שעתיים, 3 דקות ו-4 שניות.
- ‫ZONE: האזור שבו נמצאת ההזמנה.

כדי להשבית את אפשרות המחיקה האוטומטית, משתמשים בפקודה gcloud beta compute reservations update עם הדגל --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

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

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

REST

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

כדי למחוק את הבקשה לשמירת מקום בתאריך ובשעה מסוימים, שולחים בקשת PATCH ל-method beta.reservations.update. בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה paths שמוגדר לערך deleteAtTime.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_TIME"
}
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט שבו נמצאת ההזמנה.
- ‫ZONE: האזור שבו נמצאת ההזמנה.
- ‫RESERVATION_NAME: השם של הזמנה קיימת.
- ‫DELETE_AT_TIME: תאריך ושעה בפורמט של חותמת זמן RFC 3339.
כדי למחוק את ההזמנה אחרי משך זמן מסוים, שולחים בקשת PATCH אל ה-method‏ beta.reservations.update. בכתובת ה-URL של הבקשה, מוסיפים את הפרמטר paths של השאילתה, מוגדר ל-deleteAfterDuration.seconds.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט שבו נמצאת ההזמנה.
- ‫ZONE: האזור שבו נמצאת ההזמנה.
- ‫RESERVATION_NAME: השם של הזמנה קיימת.
- ‫DELETE_AFTER_DURATION: משך הזמן בשניות לפני שהבקשה לשמירת מקום נמחקת אוטומטית. לדוגמה, כדי לציין 86,400 שניות (יום אחד), צריך להזין 86400.

כדי להשבית את אפשרות המחיקה האוטומטית, שולחים בקשת PATCH אל ה-method‏ beta.reservations.update. בבקשה, מציינים את פרמטר השאילתה paths=deleteAtTime&paths=deleteAfterDuration ומשמיטים את גוף הבקשה.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

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

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

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

מגבלות

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

המסוף

gcloud

REST

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

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

שינוי הזמנות

שינוי מספר המכונות השמורות של Compute Engine בהזמנה

המסוף

gcloud

REST

שינוי סוג השיתוף של הזמנה

gcloud

REST

שינוי פרויקטים של צרכנים במקום שמור משותף

המסוף

gcloud

REST

שינוי מדיניות השיתוף של הזמנה

המסוף

gcloud

REST

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

המסוף

gcloud

REST

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

שינוי הזמנות