ניהול חלונות זמן לתחזוקה של מופע Apigee

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

הגדרת חלון זמן מועדף לתחזוקה

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

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

  • אם סדר הגדרת העדכון הוא שבוע 1, מערכת Apigee שולחת הודעות על תחזוקה לפחות שבוע מראש.
  • אם סדר הגדרת העדכון הוא שבוע 2, מערכת Apigee שולחת הודעות על תחזוקה לפחות שבועיים מראש.

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

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

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

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

כאשר:

  • התחזוקה startTime מוגדרת לפי שעון UTC.
  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • ‫INSTANCE_ID הוא מזהה מופע Apigee שלכם.

איך מוצאים הגדרות תחזוקה קיימות ולוחות זמנים לתחזוקה

כדי לאחזר את הגדרות התחזוקה הנוכחיות ולראות אם יש תחזוקה מתוכננת, בודקים את השדות maintenanceUpdatePolicy ו-scheduledMaintenance, כמו בדוגמה הבאה של ה-API:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

כאשר:

  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • ‫INSTANCE_ID הוא מזהה מופע Apigee שלכם.

פלט לדוגמה

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ]
  }
}

ניקוי הגדרות התחזוקה

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

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

כאשר:

  • ‫ORGANIZATION_ID הוא מזהה הארגון שלכם ב-Apigee.
  • ‫INSTANCE_ID הוא מזהה מופע Apigee שלכם.

הסכמה לקבלת התראות לגבי פעולות תחזוקה

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

  1. במסוף Google Cloud , נכנסים לדף User preferences > Communication.

    מעבר אל 'תקשורת'

  2. בשורה של Apigee, חלון זמן לתחזוקה, לוחצים על כפתור בחירה שמתחת לEmail כדי להפעיל אותו (On).

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