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

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

Clustered GPUs

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

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

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

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

המסוף

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

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.
לוחצים על המתג Show query כדי להפעיל אותו.

בחלונית 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. בעמודה Name (שם), לוחצים על שם ההזמנה. יופיע דף עם פרטי ההזמנה.
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 באחת מהשיטות הבאות:
- כדי לראות את ההזמנות בכל האזורים, משתמשים בשיטה 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 , מצב התחזוקה מוצג כ-—. בשדה `maintenanceStatus` ב-CLI של gcloud או ב-API בארכיטקטורת REST לא קיים.

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

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

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