本頁內容適用於 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。
選擇接收維護通知
選擇啟用維護通知前，請先 為資源設定偏好的維護期間。
-
在 Google Cloud 控制台中，前往「使用者偏好設定」>「通訊」頁面。
- 在「Apigee，維護期間」列中，選取「電子郵件」下方的圓形按鈕，將其設為「開啟」。
如要接收通知，每位使用者都必須按照上述指示個別啟用。