ניהול חלונות זמן לתחזוקה של מופע 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.

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