查找和设置维护窗口

Memorystore for Valkey 会定期更新实例，以确保服务可靠、高效、安全且是最新版本。这些更新称为维护。

维护完全由服务管理，旨在实现零停机影响。不过，除了 Memorystore for Valkey 会对您的实例执行维护之外，您还可以自定义维护时间表，以满足应用的需求并最大限度地减少中断。如需自定义维护时间表，您可以为实例配置维护期。

本页介绍了如何完成以下任务来定制维护窗口：

• 创建具有维护窗口的实例
• 设置首选维护期
• 开启维护通知
• 查找计划内维护
• 重新安排维护
• 从实例中移除维护政策

如需简要了解维护更新和维护窗口，请参阅维护简介。

创建具有维护窗口的实例

您可以使用 gcloud CLI 创建具有维护窗口的 Memorystore for Valkey 实例。

重要提示： 在执行本部分中的步骤之前，请先完成准备工作和设置网络部分中的步骤。

gcloud

如需创建具有维护窗口的实例，请使用 gcloud memorystore instances create 命令：

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID \
--shard-count=SHARD_COUNT \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

进行以下替换：

• INSTANCE_ID：您要创建的 Memorystore for Valkey 实例的 ID。实例 ID 必须包含 1 到 63 个字符，并且只能使用小写字母、数字或连字符。并且必须以小写字母开头并以小写字母或数字结尾。

• PROJECT_ID：您希望创建实例的 Google Cloud 项目的 ID 或编号。

• REGION_ID：您希望实例所在的区域。

  注意： 您只能在 Memorystore for Valkey 的支持区域中创建实例。

• NETWORK_ID：您要用于创建实例的网络的 ID。

• SHARD_COUNT：实例中的分片数量。分片数决定了用于存储实例数据的总内存容量。如需详细了解实例规范，请参阅实例和节点规范。

• DAY：您希望进行维护的日期。可接受的值为
  MONDAY - SUNDAY。

• HOUR：维护时段开始时的世界协调时间 (UTC) 时段。可接受的值为 0 - 23。

例如：

gcloud memorystore instances create my-instance \
--project=my-project \
--location=us-central1 \
--psc-auto-connections=network=projects/my-project/global/networks/default \
--shard-count=8 \
--maintenance-policy-weekly-window=day=MONDAY,startTime=hours=9

默认情况下，当您创建具有维护窗口的实例时，传输中加密处于停用状态，并且已获授权的网络为 default。

设置首选维护期

您可以使用 gcloud CLI 为 Memorystore for Valkey 实例设置维护窗口。

gcloud

如需为实例设置维护窗口，请使用 gcloud memorystore instances update 命令：

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

进行以下替换：

• INSTANCE_ID：实例的 ID。
• PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或编号。
• REGION_ID：实例所在的区域。
• DAY：您希望进行维护的日期。可接受的值为
  MONDAY - SUNDAY。
• HOUR：维护时段开始时的世界协调时间 (UTC) 时段。可接受的值为 0 - 23。

开启维护通知

您可以使用 Google Cloud 控制台为 Memorystore for Valkey 实例启用维护通知。

注意 ：除非您为实例设置维护窗口，否则即使您开启维护通知，也不会收到通知。

1. 在 Google Cloud 控制台中，前往通信页面。

   通信

2. 点击产品通知。

3. 从菜单中选择您的 Google Cloud 项目。

4. 在 Memorystore 对应的行中，将电子邮件按钮切换为开启。

维护通知电子邮件会使用以下标题："Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]"。需要接收通知的每个电子邮件地址都必须单独选择启用。

您可以在项目级（而不是在实例上）设置维护通知。 Memorystore for Valkey 会向与您的 Google 账号关联的电子邮件地址发送通知。您无法配置自定义电子邮件别名（例如团队电子邮件别名）。

查找计划内维护

如果您为 Memorystore for Valkey 实例安排了维护，则可以使用 gcloud CLI 查看维护。

gcloud

如需查找实例的计划内维护，请使用 gcloud memorystore instances describe 命令。

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

进行以下替换：

• INSTANCE_ID：实例的 ID
• PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或编号
• REGION_ID：实例所在的区域

计划维护的输出如下所示：

maintenancePolicy:
  weeklyMaintenanceWindow:
  - day: DAY
      duration: 3600 seconds
  - startTime
       hour: HOUR
maintenanceSchedule:
  endTime: 'END_DATE_AND_TIME_STAMP'
  scheduleDeadlineTime: 'SCHEDULED_DATE_AND_TIME_STAMP'
  startTime: 'START_DATE_AND_TIME_STAMP'

其中：

• maintenancePolicy 会显示首选维护政策的创建时间。
• weeklyMaintenanceWindow 显示有关实例每周维护窗口的信息。
  • DAY 是进行维护的星期。
  • HOUR 是开始维护的小时（以世界协调时间 [UTC] 表示）。
• maintenanceSchedule 显示有关实例的计划性维护的信息。
  • END_DATE_AND_TIME_STAMP 表示实例的预定维护更新结束时间。
  • SCHEDULED_DATE_AND_TIME_STAMP 表示为实例安排的维护更新的完成时间。
  • START_DATE_AND_TIME_STAMP 表示实例的预定维护更新开始时间。

重新安排维护

您可以使用 gcloud CLI 为 Memorystore for Valkey 实例重新安排维护。因此，从最初为实例安排更新开始，您最多可以将维护更新推迟两周的时间。

注意： 虽然 Memorystore for Valkey 不提供一次性为多个实例重新安排维护的选项，但您可以通过编程方式批量重新安排维护。如果您要批量重新安排，请将操作分批处理为大小合适的请求。我们建议您将批次大小限制为 100 个实例，并在请求之间等待充足的时间。否则，您可能无法成功重新安排活动。如需了解详情，请参阅计划性维护。

gcloud

如需为实例重新安排维护时间，请使用 gcloud memorystore instances reschedule-maintenance 命令。

gcloud memorystore instances reschedule-maintenance INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESCHEDULE_TIME]

进行以下替换：

• INSTANCE_ID：实例的 ID。
• PROJECT_ID：包含实例的 Google Cloud 项目的项目 ID 或编号。
• REGION_ID：实例所在的区域。

• RESCHEDULE_TYPE：重新安排的更新的类型。可用的值包括：

  • IMMEDIATE：立即开始维护更新。
  • SPECIFIC_TIME：指定更新的具体时间。此时间不得超过原始维护窗口的时间 14 天。

• RESCHEDULE_TIME：Memorystore for Valkey 重新安排维护更新的日期和时间。

  注意： 如需为 RESCHEDULE_TIME 参数指定值，您必须将 RESCHEDULE_TYPE 参数设置为 SPECIFIC_TIME。此值采用 ISO 8601 标准（例如 2025-02-16T16:56:00.000Z）。时间以世界协调时间 (UTC) 设置。

从实例中移除维护政策

如果您不再需要 Memorystore for Valkey 实例的维护政策，并且想要改用该服务的默认维护设置，则可以使用 gcloud CLI 从实例中移除该政策。

gcloud

如需从实例中移除维护政策，请使用 gcloud memorystore instances update 命令。

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-maintenance-policy-weekly-window

进行以下替换：

• INSTANCE_ID：您要从中移除维护政策的实例的 ID
• PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或编号
• REGION_ID：实例所在的区域

后续步骤

• 查看管理 Memorystore for Valkey 实例维护窗口所需的权限。