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

ניהול אירועים של מארחים בהזמנות

Clustered GPUs

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

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

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

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

המסוף

כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud

gcloud

במסוף Google Cloud , מפעילים את Cloud Shell.

הפעלת Cloud Shell

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

REST

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

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

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

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

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

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

אדמין Compute (roles/compute.admin) בפרויקט
כדי לקבל גישת קריאה בלבד ליומני הביקורת System Event: צפייה ביומנים (roles/logging.viewer) בפרויקט

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

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

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

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

כדי להתחיל תחזוקת מארח בהזמנה: compute.reservations.performMaintenance בפרויקט
כדי להתחיל תחזוקת מארח למשבצת זמן להזמנה: compute.reservationBlocks.performMaintenance בפרויקט
כדי להתחיל תחזוקת מארח עבור בלוק משנה של הזמנה: compute.reservationSubBlocks.performMaintenance בפרויקט
כדי לראות רשימה של הזמנות: compute.reservations.list בפרויקט
כדי לראות את פרטי ההזמנה: compute.reservations.get בפרויקט
כדי לראות רשימה של בלוקים בהזמנה: compute.reservationBlocks.list בפרויקט
כדי לראות רשימה של בלוקים משניים בתוך בלוק של הזמנה: compute.reservationSubBlocks.list בפרויקט

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

סקירה כללית

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

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

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

הגדרת התראות לגבי הזמנות

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

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

במסוף Google Cloud , נכנסים לדף Logs Explorer:
כניסה אל Logs Explorer

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

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

קבלת התראות על תחזוקה בהזמנה:

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

protoPayload.methodName="compute.reservations.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

כדי לקבל התראות כשהתחזוקה מסתיימת:

protoPayload.methodName="compute.reservations.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

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

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

protoPayload.methodName="compute.reservations.block.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

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

protoPayload.methodName="compute.reservations.block.startGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "started"

כדי לקבל התראות כשהתחזוקה מסתיימת:

protoPayload.methodName="compute.reservations.block.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

קבלת התראות על תחזוקה של בלוק משנה של הזמנה של מכונות וירטואליות מסוג A4X Max או A4X:

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

protoPayload.methodName="compute.reservations.subBlock.upcomingGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "scheduled"

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

protoPayload.methodName="compute.reservations.subBlock.startGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "started"

כדי לקבל התראות כשהתחזוקה מסתיימת:

protoPayload.methodName="compute.reservations.subBlock.completedGroupMaintenance" severity>=DEFAULT
protoPayload.status.message =~ "completed"

כדי לקבל התראות כשמכונת A4X Max או A4X נתקלת בשגיאה ו-Compute Engine מתחיל בתחזוקה:

protoPayload.methodName="compute.reservations.subblock.unusedmachinerepair" severity>=DEFAULT
protoPayload.status.message =~ "maintenance"

כדי לקבל התראות כשתחזוקה של מכונת A4X Max או A4X שנתקלה בשגיאה תושלם:

protoPayload.methodName="compute.reservations.subblock.unusedmachinerepaircomplete" severity>=DEFAULT
protoPayload.status.message =~ "repaired"

כדי לאמת את השאילתה, לוחצים על Run query. אם השאילתה תקינה, בחלונית Query results יוצגו רשומות ביומן שתואמות לשאילתה.
בסרגל הכלים של תוצאות השאילתה, לוחצים על רשימת הפעולות ובוחרים באפשרות יצירת התראה ביומן. מופיעה החלונית Create logs-based alert policy.
בקטע פרטי ההתראה, מבצעים את הפעולות הבאות:
1. בשדה שם מדיניות ההתראה, מזינים שם למדיניות.
2. ברשימה רמת החומרה של המדיניות, בוחרים באפשרות אזהרה (או ברמת חומרה גבוהה יותר).
3. לוחצים על הבא.
בקטע בחירת יומנים שיכללו בהתראה, לוחצים על הבא.
בקטע הגדרת תדירות ההודעות ומשך הזמן לסגירה אוטומטית, מציינים את הפרטים הבאים:
1. ברשימה הזמן בין ההתראות, בוחרים באיזו תדירות רוצים לקבל התראות.
2. ברשימה Incident autoclose duration (משך הזמן עד לסגירה אוטומטית של האירוע), בוחרים אחרי כמה זמן Cloud Logging יפסיק לשלוח התראות ויסגור אוטומטית את האירוע.
3. לוחצים על הבא.
בקטע למי לשלוח התראות?, מציינים ערוץ התראות ששירות Logging ישלח אליו התראות.
לוחצים על Save.

ניהול תחזוקה בהזמנות

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

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

צפייה במצב התחזוקה

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

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

סוג התחזוקה	הסיבה לתחזוקה	מצב המכונה
תחזוקה מתוכננת אחרי דוח מארח שגוי	`FAILURE_GPU_CUSTOMER_REPORTED`	ההגדרה חלה רק על מקרים שפועלים במארח שדיווחתם עליו כפגום.
תחזוקה מתוכננת לתחזוקה רגילה	‫`PLANNED_UPDATE`: תחזוקת תשתית מתוכננת ‫`PLANNED_NETWORK_UPDATE`: תחזוקת רשת מתוכננת	הפעולה חלה על מכונות וירטואליות שפועלות, שהופסקו או שהושעו.
תחזוקת חירום לא מתוכננת	‫`FAILURE_DISK`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה בדיסק שמצורף למופע. ‫`FAILURE_GPU`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה שקשורה ל-GPU. ‫`FAILURE_GPU_TEMPERATURE`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה שקשורה ל-GPU אחרי שה-GPU הגיע לטמפרטורה גבוהה. ‫`FAILURE_GPU_XID`: תחזוקה לא מתוכננת אחרי שקיבלתם הודעת Xid בגלל שגיאה שקשורה ל-GPU. ‫`FAILURE_INFRA`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה בתשתית. ‫`FAILURE_INTERFACE`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה בכרטיס ה-NIC. ‫`FAILURE_MEMORY`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה בזיכרון של מופע. ‫`FAILURE_NETWORK`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה ברשת. ‫`FAILURE_NVLINK`: תחזוקה לא מתוכננת שנקבעה בגלל שגיאה ב-NVLink.	ההגדרה רלוונטית רק למופעים פעילים.

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

המסוף

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

כניסה לדף Reservations
בעמודה סטטוס תחזוקה, ‏ Compute Engine מציג את מצב התחזוקה של ההזמנות. אם העמודה הזו לא מופיעה בטבלה On-demand reservations, לוחצים על Column display options, מסמנים את תיבת הסימון Maintenance status ואז לוחצים על OK.
כדי לראות את מצב התחזוקה של בלוק הזמנה, פועלים לפי השלבים הבאים:
1. בעמודה שם, לוחצים על שם ההזמנה. יופיע דף עם פרטי ההזמנה.
2. בטבלה Blocks, בעמודה Maintenance,‏ Compute Engine מציג את מצב התחזוקה של הבלוקים בהזמנה.

gcloud

כדי לראות את מצב התחזוקה של הזמנה, משתמשים בפקודה gcloud compute reservations describe עם הדגל --flatten שמוגדר לערך resourceStatus.reservationMaintenance:
```
gcloud compute reservations describe RESERVATION_NAME \
    --flatten=resourceStatus.reservationMaintenance \
    --zone=ZONE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫RESERVATION_NAME: השם של ההזמנה.
- ‫ZONE: האזור שבו קיימת ההזמנה.
הפלט אמור להיראות כך:
- אם מתוכננת תחזוקה להזמנה שלכם, הפלט ייראה בערך כך:
```
---
maintenanceOngoingCount: 0
maintenancePendingCount: 6
schedulingType: GROUPED
upcomingGroupMaintenance:
  canReschedule: true
  maintenanceStatus: PENDING
  type: SCHEDULED
  windowEndTime: '2025-11-13T14:00:00.000-08:00'
  windowStartTime: '2025-11-13T12:00:00.000-08:00'
```
  אם השדה schedulingType מוגדר לערך INDEPENDENT, השדה upcomingGroupMaintenance לא מכיל את השדות windowStartTime ו-windowEndTime. כדי לראות מתי מתוכננת תחזוקה למכונה שפועלת על מארח שמור, צופים במצב התחזוקה של המכונה.
- אם לא מתוכננת תחזוקה להזמנה, הפלט ייראה כך:
```
---
schedulingType: GROUPED
```

אם נקבעה תחזוקה להזמנה שלכם, כדי לראות את מצב התחזוקה של הבלוקים בהזמנה, משתמשים בפקודה gcloud compute reservations blocks list:

gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE

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

---
...
name: example-fr-a3u-dense-1-block-0001
...
reservationBlockMaintenance:
  maintenanceOngoingCount: 0
  maintenancePendingCount: 6
  schedulingType: GROUPED
  upcomingGroupMaintenance:
    canReschedule: true
    maintenanceReasons:
    - PLANNED_UPDATE
    - PLANNED_NETWORK_UPDATE
    maintenanceStatus: PENDING
    type: UNSCHEDULED
    windowEndTime: '2025-11-13T14:00:00.000-08:00'
    windowStartTime: '2025-11-13T12:00:00.000-08:00'
...
---
...
name: example-fr-a3u-dense-1-block-0002
...
schedulingType: GROUPED
...

אם מתוכחז תחזוקה לבלוק של הזמנה, כדי לראות את מצב התחזוקה של תת-בלוקים בתוך בלוק ההזמנה, משתמשים בפקודה gcloud compute reservations sub-blocks list:

gcloud compute reservations sub-blocks list RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --zone=ZONE

מחליפים את BLOCK_NAME בשם של בלוק שקיים בהזמנה.

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

...
reservationSubBlockMaintenance:
  instanceMaintenanceOngoingCount: 0
  instanceMaintenancePendingCount: 3
  maintenanceOngoingCount: 0
  maintenancePendingCount: 32
  schedulingType: GROUPED
  subblockInfraMaintenanceOngoingCount: 0
  subblockInfraMaintenancePendingCount: 0
  upcomingGroupMaintenance:
    canReschedule: true
    maintenanceReasons:
    - PLANNED_UPDATE
    - PLANNED_NETWORK_UPDATE
    maintenanceStatus: PENDING
    type: SCHEDULED
    windowEndTime: '2025-11-13T14:00:00.000-08:00'
    windowStartTime: '2025-11-13T12:00:00.000-08:00'
...

REST

כדי לראות את מצב התחזוקה של ההזמנות, שולחים בקשת GET לאחת מהשיטות הבאות:
- כדי לראות את ההזמנות בכל האזורים, משתמשים ב-method ‏reservations.aggregatedList.
- כדי לראות את השמירה באזור מסוים, משתמשים בשיטה reservations.list.
בכתובת ה-URL של הבקשה, כוללים את פרמטרים השאילתה הבאים:
- כדי להציג רק את השם, סוג המכונה השמור ומצב התחזוקה של הזמנה, צריך לכלול את פרמטר השאילתה fields עם הערך items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance.
- כדי לסנן רק הזמנות שמציינות סוג מכונה ספציפי, צריך לכלול את פרמטר השאילתה filter שמוגדר לערך specificReservation.instanceProperties.machineType:MACHINE_TYPE באמצעות ערכים מקודדים בכתובת ה-URL.
לדוגמה, כדי לראות את ההזמנות בכל האזורים, שולחים בקשת GET באופן הבא:
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations?fields=items.name,items.specificReservation.instanceProperties.machineType,items.resourceStatus.reservationMaintenance&filter=specificReservation.instanceProperties.machineType%3AMACHINE_TYPE
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט שבו קיימות ההזמנות.
- ‫MACHINE_TYPE: סוג המכונה השמור שרוצים לסנן את ההזמנות לפיו.
אם מתוכננת תחזוקה להזמנה או שהיא מתבצעת, הפלט ייראה כך:
```
{
  "items": [
    {
      "specificReservation": {
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        }
      },
      "name": "example-reservation",
      "resourceStatus": {
        "reservationMaintenance": {
          maintenanceOngoingCount: 0,
          maintenancePendingCount: 6,
          "schedulingType": "GROUPED",
          "upcomingGroupMaintenance": {
            "type": "SCHEDULED",
            "canReschedule": true,
            "windowStartTime": "2025-11-13T12:00:00.000-08:00",
            "windowEndTime": "2025-11-13T14:00:00.000-08:00",
            "maintenanceStatus": "PENDING"
          }
        }
      }
    },
    ...
  ]
}
```
אפשר גם לצמצם עוד יותר את רשימת מופעי המחשוב על ידי הגדרת הפרמטר של השאילתה filter לביטוי סינון שונה.
אם מתוכננת תחזוקה להזמנה, כדי לראות את מצב התחזוקה של הבלוקים בהזמנה, צריך לשלוח GETבקשה לשיטה reservationBlocks.list. בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה fields שמוגדר לערך items.name,items.reservationMaintenance:
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks?fields=items.name,items.reservationMaintenance
```
מחליפים את RESERVATION_NAME בשם ההזמנה.

אם מתוכננת תחזוקה לבלוק של הזמנות או שהתחזוקה בעיצומה, הפלט ייראה כך:
```
{
  "items": [
    {
      "name": "example-fr-a3u-dense-1-block-0001",
      "reservationBlockMaintenance": {
        "maintenanceOngoingCount": 0,
        "maintenancePendingCount": 6,
        "schedulingType": "GROUPED",
        "upcomingGroupMaintenance": {
          "type": "SCHEDULED",
          "canReschedule": true,
          "windowStartTime": "2025-11-13T12:00:00.000-08:00",
          "windowEndTime": "2025-11-13T14:00:00.000-08:00",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ]
        }
      }
    },
    ...
  ]
}
```
אם השדה schedulingType מוגדר ל-INDEPENDENT עבור בלוק, השדה upcomingGroupMaintenance לא מכיל את השדות windowStartTime ו-windowEndTime. כדי לראות מתי מתוכננת תחזוקה למופע שפועל בבלוק שמור, צופים במצב התחזוקה של המופע.

אם מתוכחז תחזוקה לחלון הזמנה, כדי לראות את מצב התחזוקה של חלונות המשנה בתוך חלון ההזמנה, צריך לשלוח בקשת GET לשיטה reservationSubBlocks.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks

מחליפים את BLOCK_NAME בשם של בלוק שקיים בהזמנה.

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

{
  "items": [
    {
      "name": "example-fr-a3u-dense-1-block-0001",
      "reservationSubBlockMaintenance": {
        "instanceMaintenanceOngoingCount": 0,
        "instanceMaintenancePendingCount": 3,
        "maintenanceOngoingCount": 0,
        "maintenancePendingCount": 6,
        "schedulingType": "GROUPED",
        "subblockInfraMaintenanceOngoingCount": 0,
        "subblockInfraMaintenancePendingCount": 0,
        "upcomingGroupMaintenance": {
          "type": "SCHEDULED",
          "canReschedule": true,
          "windowStartTime": "2025-11-13T12:00:00.000-08:00",
          "windowEndTime": "2025-11-13T14:00:00.000-08:00",
          "maintenanceStatus": "PENDING",
          "maintenanceReasons": [
            "PLANNED_UPDATE",
            "PLANNED_NETWORK_UPDATE"
          ]
        }
      }
    },
    ...
  ]
}

התחלת תחזוקה באופן ידני

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

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

מצב תחזוקה	תיאור	מה שרואים
מתוזמנת	מתבצעת תחזוקה מתוזמנת ב-Compute Engine במקום השמור. אתם יכולים להתחיל תחזוקה ידנית לפני המועד שנקבע.	במסוף Google Cloud , מצב התחזוקה מוצג כ-Ready to run - will run on `DATE`. ב-CLI של gcloud או ב-API בארכיטקטורת REST,‏ Compute Engine מגדיר את השדה `maintenanceStatus` לערך `PENDING`.
בתהליך	מתבצעות פעולות תחזוקה. אי אפשר לתזמן אותו מחדש.	במסוף Google Cloud , מצב התחזוקה יהיה פועל. ב-CLI של gcloud או ב-API בארכיטקטורת REST,‏ Compute Engine מגדיר את השדה `maintenanceStatus` לערך `ONGOING`.
הושלמה	התחזוקה הסתיימה. ‫Compute Engine הסיר את כל ההתראות על תחזוקה מהאינסטנס.	במסוף Google Cloud , מצב התחזוקה מוצג כ-—. ב-CLI של gcloud או ב-API בארכיטקטורת REST, השדה `maintenanceStatus` לא קיים.

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

המסוף

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

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

gcloud

כדי להתחיל תחזוקה בהזמנה, משתמשים בפקודה gcloud compute reservations perform-maintenance:

gcloud compute reservations perform-maintenance RESERVATION_NAME \
    --scope=RESERVATION_MAINTENANCE_SCOPE \
    --zone=ZONE

כדי להתחיל תחזוקה של בלוק הזמנה, משתמשים בפקודה gcloud compute reservations blocks perform-maintenance:

gcloud compute reservations blocks perform-maintenance RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --scope=BLOCK_MAINTENANCE_SCOPE \
    --zone=ZONE

כדי להתחיל תחזוקה של תת-בלוק של הזמנה, משתמשים בפקודה gcloud compute reservations sub-blocks perform-maintenance:

gcloud compute reservations sub-blocks perform-maintenance RESERVATION_NAME \
    --block-name=BLOCK_NAME \
    --subblock-name=SUB_BLOCK_NAME \
    --zone=ZONE

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

‫RESERVATION_NAME: השם של ההזמנה.
‫RESERVATION_MAINTENANCE_SCOPE: היקף התחזוקה של ההזמנה. מציינים אחד מהערכים הבאים:
- כדי להתחיל תחזוקה בכל הבלוקים: all
- כדי להתחיל תחזוקה רק בבלוקים עם מכונות פעילות: running
- כדי להתחיל תחזוקה רק בבלוקים שלא בשימוש ובבלוקים עם מכונות שהופסקו או הושעו: unused
‫BLOCK_NAME: השם של בלוק שקיים בהזמנה.
‫SUB_BLOCK_NAME: השם של תת-בלוק שקיים בבלוק ההזמנה.
‫BLOCK_MAINTENANCE_SCOPE: היקף התחזוקה של בלוק ההזמנה. מציינים אחד מהערכים הבאים:
- כדי להתחיל תחזוקה בכל המארחים: all
- כדי להתחיל תחזוקה רק במארחים עם מופעים פעילים: running
- כדי להתחיל תחזוקה רק במארחים שלא בשימוש ובמארחים עם מופעים שהופסקו או הושעו: unused
‫ZONE: האזור שבו קיימת ההזמנה.

REST

כדי להתחיל תחזוקה של הזמנה, שולחים בקשת POST ל-method‏ reservations.performMaintenance:

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

{
  "maintenanceScope": "RESERVATION_MAINTENANCE_SCOPE"
}

כדי להתחיל תחזוקה של חלון עם משבצות זמן לפגישות, שולחים בקשת POST ל-method‏ reservationBlocks.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/performMaintenance

{
  "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE"
}

כדי להתחיל תחזוקה של בלוק משנה של הזמנה, שולחים בקשת POST ל-method‏ reservationSubBlocks.performMaintenance:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB_BLOCK_NAME/performMaintenance

{
  "maintenanceScope": "BLOCK_MAINTENANCE_SCOPE"
}

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

‫PROJECT_ID: מזהה הפרויקט שבו Compute Engine יצר באופן אוטומטי את המקום השמור.
‫ZONE: האזור שבו קיימת ההזמנה.
‫RESERVATION_NAME: השם של ההזמנה.
‫RESERVATION_MAINTENANCE_SCOPE: היקף התחזוקה של ההזמנה. מציינים אחד מהערכים הבאים:
- כדי להתחיל תחזוקה בכל הבלוקים: ALL
- כדי להתחיל תחזוקה רק בבלוקים עם מכונות פעילות: RUNNING
- כדי להתחיל תחזוקה רק בבלוקים שלא בשימוש ובבלוקים עם מכונות שהופסקו או הושעו: UNUSED
‫BLOCK_NAME: השם של בלוק שקיים בהזמנה.
‫SUB_BLOCK_NAME: השם של תת-בלוק שקיים בבלוק ההזמנה.
‫BLOCK_MAINTENANCE_SCOPE: היקף התחזוקה של בלוק ההזמנה. מציינים אחד מהערכים הבאים:
- כדי להתחיל תחזוקה בכל המארחים: ALL
- כדי להתחיל תחזוקה רק במארחים עם מופעים פעילים: RUNNING
- כדי להתחיל תחזוקה רק במארחים שלא בשימוש ובמארחים עם מופעים שהופסקו או הושעו: UNUSED

ניהול התראות על תחזוקת חירום של חומרה

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

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

gcloud

כדי להפעיל התראות על תחזוקת חירום של ציוד בהזמנה, משתמשים בפקודה gcloud compute reservations update עם הדגל --enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --enable-emergent-maintenance \
    --zone=ZONE
```
כדי להשבית את ההתראות על תחזוקת חירום של ציוד בהזמנה, משתמשים בפקודה gcloud compute reservations update עם הדגל --no-enable-emergent-maintenance:
```
gcloud compute reservations update RESERVATION_NAME \
    --no-enable-emergent-maintenance \
    --zone=ZONE
```

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

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

REST

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

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

{
  "name": "RESERVATION_NAME",
  "enableEmergentMaintenance": EMERGENCY_MAINTENANCE_NOTIFICATIONS
}

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

‫PROJECT_ID: מזהה הפרויקט שבו קיימת ההזמנה.
‫ZONE: האזור שבו קיימת ההזמנה.
‫RESERVATION_NAME: השם של ההזמנה.
‫EMERGENCY_MAINTENANCE_NOTIFICATIONS: מציינים אחד מהערכים הבאים:
- כדי להפעיל את ההתראות: true
- כדי להשבית את ההתראות: false

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

‫true: מופעלות התראות על תחזוקת חירום של החומרה.
‫false: ההתראות על תחזוקת חירום של החומרה מושבתות.

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

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

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

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

המסוף

gcloud

REST

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

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

סקירה כללית

הגדרת התראות לגבי הזמנות

ניהול תחזוקה בהזמנות

צפייה במצב התחזוקה

המסוף

gcloud

REST

התחלת תחזוקה באופן ידני

המסוף

gcloud

REST

ניהול התראות על תחזוקת חירום של חומרה

gcloud

REST

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

ניהול אירועים של מארחים בהזמנות