查看和设置维护窗口

本页面介绍如何查找和设置 Cloud SQL 实例的维护期。如需详细了解 Cloud SQL 为何及如何执行维护，请参阅 Clou d 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. 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

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

  3. 安装 gcloud CLI。

  4. 配置 gcloud CLI 以使用您的联合身份。

    如需了解详情，请参阅使用联合身份登录 gcloud CLI。

  5. 如需初始化 gcloud CLI，请运行以下命令： 

    gcloud init

为实例设置维护窗口

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 实例页面。

    转到“Cloud SQL 实例”

  2. 如需打开实例的概览页面，请点击实例名称。
  3. 在维护部分，点击修改维护偏好设置。
  4. 在配置选项部分，打开维护。
  5. 配置以下选项：
    • 维护时间。选择要应用自动维护更新的一周。您可以采取以下做法：
      • 任意：维护更新可能会随时进行，但通常会在第 1 周内进行。
      • 第 1 周：维护更新在发出通知后的 7 到 14 天内进行。
      • 第 2 周：维护更新在发出通知后的 15 到 21 天内进行。
      • 第 5 周：维护更新在发出通知后的 35 到 42 天内进行。
    • 维护窗口。选择您首选的每周时间和时长。包括以下选项：
      • 任何窗口：默认维护窗口。维护更新不限于一周中的星期几或一天中的特定时间。
      • 星期几：为维护窗口选择日期，可以是星期六、星期日、星期一、星期二、星期三、星期四或星期五。
      • 时间：如果您选择了星期几，则还可以选择时间。选择您所在时区的一个小时间隔。

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。 采用世界协调时间 (UTC) 时区指定。
  • HOUR：维护窗口的时段，介于 0 到 23 之间。采用世界协调时间 (UTC) 时区指定。
  • 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 之间。采用世界协调时间 (UTC) 时区指定。
  • DAY：要在星期几进行维护更新。 指定 MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY 或 SUNDAY。 采用世界协调时间 (UTC) 时区指定。
  • 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 之间。采用世界协调时间 (UTC) 时区指定。
  • DAY：您希望在星期几进行维护更新。 指定 MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY 或 SUNDAY。 采用世界协调时间 (UTC) 时区指定。
  • 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"
    }
  }
}

如需发送您的请求，请展开以下选项之一：