查看及設定維護期間

本頁面提供尋找及設定 Cloud SQL 執行個體維護期間的程序。如要進一步瞭解 Cloud SQL 執行維護作業的方式和原因，請參閱「Cloud SQL 執行個體的維護更新」。

如果您選擇加入接收維護通知，Cloud SQL 會在 Cloud SQL 執行個體有可用的維護更新時，傳送電子郵件通知給您。Cloud SQL 會在維護作業推出前傳送通知，然後按照每週排程，對各組執行個體套用更新。您可以選取執行個體的維護時間，控制在執行個體收到維護更新前，提前多久收到通知。

您可以透過下列選項，排定維護更新時間：

  • 如果選取「Any」或未設定，維護更新作業可能會在任何時間執行，但通常會在推出後的第一週內執行。
  • 如果選取 Week 1 (也稱為 preview 和 canary)，系統會在傳送維護通知後的 7 到 14 天內執行維護更新。
  • 如果選取 Week 2 (也稱為 production 和 stable)，則維護更新會在通知傳送後 15 到 21 天內進行。
  • 如果選取「Week 5」，維護更新會在通知發出後 35 到 42 天內進行。

如果執行個體已在維護中或已排定維護，則變更維護期間設定不會立即生效。這些變更會反映在日後的維護事件中。

事前準備

  1. 登入 Google Cloud 帳戶。如果您未曾使用過 Google Cloud，歡迎 建立帳戶，親自體驗實際使用我們產品的成效。新客戶還能獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Install the gcloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  8. Verify that billing is enabled for your Google Cloud project.

  9. Install the gcloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init

設定執行個體的維護期間

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在「維護」部分，按一下「編輯維護作業偏好設定」。
  4. 在「Configuration options」(設定選項) 部分，開啟「Maintenance」(維護)。
  5. 設定下列選項：
    • 維護時間。選取要套用自動維護更新的週別。您可以採取下列做法：
      • 不限：維護更新作業可在任何時間執行，但通常會在第 1 週內執行。
      • 第 1 週：維護作業會在維護通知傳送後的 7 到 14 天內進行。
      • 第 2 週：在通知傳送後的 15 到 21 天內進行維護更新。
      • 第 5 週：在通知傳送後的 35 到 42 天內進行維護更新。
    • 維護期間。選取偏好的星期幾和時段。選項包括：
      • 「Any window」(任意一天)：預設維護期間。維護更新不限於一週中的任何特定日期或一天中的任何特定時間。
      • Day of the week (星期幾)：選取維護期間的星期幾，例如「Saturday」(星期六)、「Sunday」(星期日)、「Monday」(星期一)、「Tuesday」(星期二)、「Wednesday」(星期三)、「Thursday」(星期四)或「Friday」(星期五)。
      • Time of day：如果選取星期幾，也可以選擇時段。請選取當地時區的一小時時段。

gcloud

如要設定 Cloud SQL 執行個體的維護期間和維護時間，請執行下列指令：

gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING

請替換下列變數：

  • INSTANCE_ID：執行個體 ID，不得為唯讀副本執行個體。
  • DAY：要進行維護作業的星期幾。設為 MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY 或 SUNDAY。請以世界標準時間時區指定。
  • HOUR：維護期間的小時，0 - 23。請以世界標準時間時區指定。
  • MAINTENANCE_TIMING：要套用維護更新的維護作業推出期間週數。選項包括：
    • preview：這代表維護通知傳送後的第 1 週。維護更新作業預計會在通知後 7 到 14 天內完成。
    • production：這代表維護通知傳送後的第 2 週。維護更新作業預定在通知後 15 到 21 天內進行。
    • week5：維護通知送出後，系統會在 35 到 42 天內安排維護更新。

如需參考資訊，請參閱 gcloud sql instances patch。

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號。
  • INSTANCE_ID：執行個體 ID，不得為唯讀副本執行個體。
  • HOUR：維護期間的小時，0 - 23。請以世界標準時間時區指定。
  • DAY：維護更新作業的執行星期。請指定MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY或SUNDAY。 請以世界標準時間時區指定。
  • MAINTENANCE_TIMING：要套用維護更新的維護作業推出期間週數。選項包括：
    • canary：這代表維護通知傳送後的第 1 週。維護更新作業預計在通知後 7 到 14 天內進行。
    • stable：這代表維護通知傳送後的第 2 週。維護更新作業預計在通知後 15 到 21 天內進行。
    • week5：維護更新排定在維護通知傳送後的 35 到 42 天內進行。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號。
  • INSTANCE_ID：執行個體 ID，不得為唯讀副本執行個體。
  • HOUR：維護期間的小時，0 - 23。請以世界標準時間時區指定。
  • DAY：：要執行維護更新的星期幾。 請指定MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY或SUNDAY。 請以世界標準時間時區指定。
  • MAINTENANCE_TIMING：要套用維護更新的維護作業推出期間週數。選項包括：
    • canary：這代表維護通知傳送後的第 1 週。維護更新作業預計在通知後 7 到 14 天內進行。
    • stable：這代表維護通知傳送後的第 2 週。維護更新作業預計在通知後 15 到 21 天內進行。
    • week5：維護更新排定在維護通知傳送後的 35 到 42 天內進行。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

選擇接收維護作業通知

選擇加入接收維護通知前，您必須為執行個體設定維護期間。

  1. 前往「Communication」(通訊) 頁面。前往「通訊」
  2. 在「Cloud SQL」、「Maintenance window」(維護期間) 的資料列中，選取「Email」(電子郵件) 下方的圓形按鈕，將其設為「ON」(開啟)。

每位需要接收通知的使用者都必須個別選擇加入。

在 Google Cloud 控制台中查看維護作業通知

您可以在 Google Cloud 控制台的幾個位置查看維護通知：

  • Google Cloud 控制台的「Logs Explorer」頁面。使用「All logs name」(所有記錄名稱) 下拉式選單搜尋 maintenance-events，然後按一下「Apply」(套用)。如果執行個體已排定維護作業，記錄會顯示執行個體名稱和排定的維護作業開始時間。

  • 如果執行個體已排定維護作業，維護日期會列在「Instances」(執行個體) 頁面的「Maintenance」(維護) 欄中。「Maintenance」(維護) 欄通常會隱藏，但排定維護作業時會自動顯示。如果想一律顯示「維護」欄，也可以在「資料欄顯示選項」(「資料欄顯示選項」圖示為三條線) 中選取「維護」。

  • 或者，您也可以選取執行個體，前往「Instance details」(執行個體詳細資料) 頁面。如果執行個體已排定維護作業，您會在「Maintenance」(維護) 窗格中看到訊息。
    前往 Cloud SQL 執行個體

使用 API 尋找排定的維護作業

gcloud

如要查看即將進行的排定維護作業，請使用下列指令：

gcloud sql instances describe INSTANCE_ID

替換下列變數：

  • INSTANCE_ID：要檢查排定維護作業的執行個體。

在回應中，找到 scheduledMaintenance 部分。

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：要設定高可用性的執行個體名稱

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

在回應中，找到 scheduledMaintenance 部分。

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：要設定高可用性的執行個體名稱

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

在回應中，找到 scheduledMaintenance 部分。

重新安排預定維護作業

您可以使用 Google Cloud 控制台、gcloud CLI 或 Cloud SQL Admin API 重新排定維護作業。

如果將執行個體的維護時間設為第 1 週或第 2 週，則最多可將維護作業延後 28 天。

如果將執行個體的維護時間設為第 5 週，則最多可將維護作業延後 7 天。您必須在這段時間範圍內重新安排維護作業，確保執行個體在下一季維護作業推出前，收到維護更新。

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 篩選「Maintenance」一詞，即可列出所有排定維護作業的執行個體。
  3. 在「Maintenance」(維護) 欄中，按一下「Reschedule」(重新排程)。
  4. 在「Reschedule」(重新排定) 對話方塊中，選擇要立即套用維護作業、重新排定在重新排定的計畫維護作業定義的允許延遲期間內執行，還是延遲至下一個可用的維護期間。

gcloud

如要重新排定 Cloud SQL 執行個體的維護作業，請執行下列指令：

gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]

請替換下列變數：

  • INSTANCE_ID：要重新排程的執行個體。
  • RESCHEDULE_TYPE：使用 IMMEDIATE、NEXT_AVAILABLE_WINDOW 或 SPECIFIC_TIME 其中之一。

    如果選擇 NEXT_AVAILABLE_WINDOW，維護作業會重新排定在目前排定時間後的下一個可用維護期間。

  • RESCHEDULE_TIME：如果為 RESCHEDULE_TYPE 指定 SPECIFIC_TIME，則也必須設定 --schedule-time 旗標，指定新的維護日期和時間。採用 ISO 8601 格式。例如 2020-01-16T16:56:00.000Z

如需參考資訊，請參閱 gcloud sql reschedule-maintenance。

如要將維護作業重新排定在最多 28 天後，請查看 gcloud 的版本號碼。如果版本號碼低於 390.0.0_RC00，請重新安裝 gcloud。

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID。
  • INSTANCE_ID：執行個體 ID。
  • RESCHEDULE_TYPE：重新排程類型。請使用 IMMEDIATE、NEXT_AVAILABLE_WINDOW 或 SPECIFIC_TIME 其中之一。

    如果選擇 NEXT_AVAILABLE_WINDOW，維護作業會重新排定在下一個可用的維護期間。

    如果選擇 SPECIFIC_TIME，則必須在要求主體中加入 schedule_time。

  • SCHEDULE_TIME：如果您為 RESCHEDULE_TYPE 指定 SPECIFIC_TIME，請以 RFC 3339 格式指定重新排定維護作業的日期和時間。例如：2026-11-07T04:00:00Z。 如果指定 IMMEDIATE 或 NEXT_AVAILABLE_WINDOW，請從要求主體中省略 schedule_time。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

JSON 要求主體：

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE",
    "schedule_time": "SCHEDULE_TIME"
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": "RESCHEDULE_MAINTENANCE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID。
  • INSTANCE_ID：執行個體 ID。
  • RESCHEDULE_TYPE：重新排程類型。請使用 IMMEDIATE、NEXT_AVAILABLE_WINDOW 或 SPECIFIC_TIME 其中之一。

    如果選擇 NEXT_AVAILABLE_WINDOW，維護作業會重新排定在下一個可用的維護期間。

    如果選擇 SPECIFIC_TIME，則必須在要求主體中加入 schedule_time。

  • SCHEDULE_TIME：如果您為 RESCHEDULE_TYPE 指定 SPECIFIC_TIME，請以 RFC 3339 格式指定重新排定維護作業的日期和時間。例如：2026-11-07T04:00:00Z。 如果指定 IMMEDIATE 或 NEXT_AVAILABLE_WINDOW，請從要求主體中省略 schedule_time。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

JSON 要求主體：

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE",
    "schedule_time": "SCHEDULE_TIME"
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": "RESCHEDULE_MAINTENANCE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
如要瞭解如何為這項工作建構基礎 REST API 要求，請參閱 instances:rescheduleMaintenance 頁面上的 APIs Explorer。

設定拒絕維護期

在任何指定時間，您最多可以為 Cloud SQL 執行個體設定一個拒絕維護期。拒絕維護期優先於任何排定的維護期間。如果維護期間與拒絕維護期衝突，則以拒絕維護期為準。

無論拒絕維護期是否已發生，您都可以手動移除。

如要設定拒絕維護期，請設定開始日期、結束日期，以及時段的開始和結束時間。拒絕維護期可介於 1 到 90 天。

開始日期和結束日期有兩種格式：

  • yyyy-mm-dd：表示特定日期
  • mm-dd：表示每年重複的日期

開始日期和結束日期採用世界標準時間。如要設定時區，請使用時間欄位調整開始時間。例如，開始日期 = 2020-10-10 且時間 = 07:00:00，表示開始時間為 2020-10-10 07:00:00 UTC (2020-10-10 00:00:00 PST)

時間格式為：HH:mm:SS。

  • 小時介於 0 至 23 之間 (含 0 和 23)。
  • 分鐘和秒數介於 0 至 59 之間 (含 0 和 59)。

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在「維護」部分，按一下「編輯維護作業偏好設定」。
  4. 在「拒絕維護期」部分，設定開始和結束日期。
  5. 在「進階選項」部分，視需要選取「每年重複」。
  6. 按一下 [儲存]。

gcloud

如要設定 Cloud SQL 執行個體的拒絕維護期，請執行下列指令：

gcloud sql instances patch INSTANCE_ID\
   --deny-maintenance-period-start-date=START_DATE \
   --deny-maintenance-period-end-date=END_DATE \
   --deny-maintenance-period-time=TIME

請替換下列變數：

  • INSTANCE_ID：Cloud SQL 執行個體 ID
  • START_DATE：間隔開始日期。例如 2021-11-29
  • END_DATE：間隔結束日期。例如 2021-12-02
  • TIME：間隔的開始和結束時間。例如 00:00:00

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • start-date：開始日期 (yyyy-mm-dd) 或每年重複的日期 (mm-dd)
  • end-date：結束日期 (yyyy-mm-dd) 或每年重複的日期 (mm-dd)
  • time：開始和結束時間 (HH:mm:SS)

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • start-date：開始日期 (yyyy-mm-dd) 或每年重複的日期 (mm-dd)
  • end-date：結束日期 (yyyy-mm-dd) 或每年重複的日期 (mm-dd)
  • time：開始和結束時間 (HH:mm:SS)

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

移除拒絕維護期

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在「維護」部分，按一下「編輯維護作業偏好設定」。
  4. 在「拒絕維護期」部分，按一下「清除」。
  5. 按一下 [儲存]。

gcloud

如要移除 Cloud SQL 執行個體的拒絕維護期，請執行下列指令：

gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

請替換下列變數：

  • INSTANCE_ID：Cloud SQL 執行個體 ID

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

拒絕維護期通知

如果預定維護時間落在拒絕維護期內，且維護拒絕期設定禁止維護，系統就不會傳送維護期間通知。

如果您變更拒絕維護期設定，防止在先前排定的時間進行維護，Cloud SQL 執行個體會略過維護作業，並傳送取消維護的通知。每當執行個體排定更新時，Cloud SQL 都會傳送這則取消通知。

只要預定維護作業排定在拒絕維護期以外的時間進行，系統就會在拒絕維護期內傳送預定維護作業通知。

後續步驟