Wartungsfenster für Apigee-Instanzen verwalten

Diese Seite gilt für Apigee, aber nicht für Apigee Hybrid.

Apigee Edge-Dokumentation ansehen

In diesem Abschnitt werden Vorgehensweisen beschrieben, mit denen Sie Wartungsfenster für Apigee-Ressourcen ermitteln und einrichten. Weitere Informationen darüber, wie und warum Apigee Wartungen durchführt, finden Sie unter Wartung – Übersicht.

Bevorzugtes Wartungsfenster festlegen

Wenn eine Ressource bereits gewartet wird oder ein Wartungsereignis geplant ist, gelten alle Änderungen, die Sie an der Einstellung für das Wartungsfenster vornehmen (einschließlich des Änderns des Tages/der Uhrzeit, des Änderns der Aktualisierungsreihenfolge oder des Zurücksetzens der Einstellungen), nicht für das ausstehende Ereignis. Die geplante Wartung wird wie geplant fortgesetzt und Ihre Änderungen gelten nur für zukünftige Wartungsbereitstellungen.

Wenn Sie Wartungsbenachrichtigungen aktiviert haben, sendet Apigee Ihnen Benachrichtigungen mit dem genauen Datum und der Uhrzeit, wenn eine Wartung geplant ist. Apigee sendet diese Benachrichtigungen basierend auf den Einstellungen für die Aktualisierungsreihenfolge des Wartungsfensters für Ihre Ressource:

Hinweis : „Woche 1“ und „Woche 2“ beziehen sich auf die Bereitstellungsphasen und Vorlaufzeiten für Benachrichtigungen (1 Woche im Vergleich zu 2 Wochen). Sie beziehen sich nicht auf die erste oder zweite Kalenderwoche des Monats. Eine Bereitstellung in „Woche 2“ erfolgt beispielsweise nicht unbedingt in der zweiten Woche eines Kalendermonats. Sie erfolgt eine Woche nach der Bereitstellung in „Woche 1“ für diese bestimmte Version.

  • Wenn die Einstellung für die Aktualisierungsreihenfolge auf „Woche 1“ festgelegt ist, sendet Apigee mindestens eine Woche im Voraus Wartungsbenachrichtigungen.
  • Wenn die Einstellung für die Aktualisierungsreihenfolge auf „Woche 2“ festgelegt ist, sendet Apigee mindestens zwei Wochen im Voraus Wartungsbenachrichtigungen.

Sie können nur ein Wartungsfenster pro Apigee-Instanz angeben. Anfragen mit mehr als einem Wartungsfenster werden abgelehnt.

Wenn Sie Wartungsfenster für mehrere Instanzen in derselben Organisation festlegen möchten, sollten Sie zwischen den Wartungsfenstern mindestens 12 Stunden einplanen, um Überschneidungen bei Wartungsvorgängen zu vermeiden.

Wenn Sie das Wartungsfenster aktualisieren, wird das vorherige Fenster überschrieben.

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"

Wobei:

  • Die startTime der Wartung wird in UTC konfiguriert.
  • maintenanceChannel: Die Einstellung für den Wartungskanal/die Aktualisierungsreihenfolge (z.B. WEEK1 oder WEEK2).
  • ORGANIZATION_ID ist Ihre Apigee-Organisations-ID.
  • INSTANCE_ID ist Ihre Apigee-Instanz-ID.

Vorhandene Wartungseinstellungen und Wartungspläne finden

Sie können Ihre aktuellen Wartungseinstellungen abrufen und anstehende Wartungen ansehen, indem Sie die Felder maintenanceUpdatePolicy und scheduledMaintenance prüfen, wie im folgenden API-Beispiel gezeigt:

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

Wobei:

  • ORGANIZATION_ID ist Ihre Apigee-Organisations-ID.
  • INSTANCE_ID ist Ihre Apigee-Instanz-ID.

Beispielausgabe

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

Wartungseinstellungen zurücksetzen

Wenn Sie keine Wartungseinstellungen mehr benötigen, können Sie sie gemäß der folgenden Anleitung zurücksetzen.

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"

Wobei:

  • ORGANIZATION_ID ist Ihre Apigee-Organisations-ID.
  • INSTANCE_ID ist Ihre Apigee-Instanz-ID.

Wartungsbenachrichtigungen aktivieren

Bevor Sie Wartungsbenachrichtigungen aktivieren können, müssen Sie ein bevorzugtes Wartungsfenster für eine Ressource festlegen.

  1. Rufen Sie in der Google Cloud Console die Seite Nutzereinstellungen > Kommunikation auf.

    Zu Kommunikation gehen

  2. Wählen Sie in der Zeile für Apigee, Wartungsfenster das Optionsfeld unter E-Mail aus, um diese Option zu aktivieren.

Jeder Nutzer, der Benachrichtigungen erhalten muss, muss die oben beschriebene Anleitung befolgen, um die Option separat zu aktivieren.