管理 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 是以世界標準時間設定。
  • ORGANIZATION_ID 是您的 Apigee 機構 ID。
  • INSTANCE_ID 是您的 Apigee 執行個體 ID。

查看現有的維護設定和維護時間表

您可以擷取目前的維護設定，並查看 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 機構 ID。
  • INSTANCE_ID 是您的 Apigee 執行個體 ID。

輸出範例

{
  ...
  "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 機構 ID。
  • INSTANCE_ID 是您的 Apigee 執行個體 ID。

選擇接收維護通知

選擇啟用維護通知前，請先 為資源設定偏好的維護期間。

  1. 在 Google Cloud 控制台中，前往「使用者偏好設定」>「通訊」頁面。

    前往「通訊」頁面

  2. 在「Apigee，維護期間」列中，選取「電子郵件」下方的圓形按鈕，將其設為「開啟」。

如要接收通知，每位使用者都必須按照上述指示個別啟用。