Find and set maintenance windows

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This page provides instructions how to find scheduled maintenance, set maintenance windows, reschedule maintenance, and more. For an overview of maintenance updates and maintenance windows, see About maintenance.

Set a preferred window for maintenance on a cluster

gcloud

Run the following command to set a maintenance window for a Redis cluster:

gcloud redis clusters update CLUSTER_ID --region=REGION --maintenance-window-day=DAY --maintenance-window-hour=HOUR

Where:

• CLUSTER_ID is the ID of the cluster
• REGION is the region where your cluster is located
• DAY is the day you want maintenance to occur. Acceptable values are: MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY
• HOUR is the hour of the day in UTC time for when the maintenance window starts. Acceptable values are 0-23

For reference information, see gcloud redis clusters update

Opt in to maintenance notifications

Note: Even if you turn on maintenance notifications, you don't receive notifications unless you set a maintenance window for that cluster.

To turn on maintenance notifications:

1. Go to the Communication page in the Google Cloud console:

   Communication

2. Click the Product Notifications tab.

3. Select your project from the drop-down menu.

4. In the row for Memorystore, toggle the email button to ON.

A maintenance notification email uses the title, "Upcoming maintenance for your Cloud Memorystore cluster [your-cluster-name]". Each email address that needs to receive notifications must opt in separately.

Maintenance notifications are set at the project level rather than on clusters. Email notifications are sent to the email address associated with your Google Account. It is not possible to configure a custom email alias (for instance, a team email alias).

Find scheduled maintenance

If maintenance has been scheduled for your cluster, you can view it using the following instructions:

gcloud

gcloud redis clusters describe CLUSTER_ID --region=REGION

where:

• CLUSTER_ID is the ID of the cluster
• REGION is the region where your cluster is located

The output for scheduled maintenance is as follows:

maintenancePolicy:
createTime: 'TIME_STAMP'
updateTime: 'TIME_STAMP'
maintenanceWindow:
- day: DAY
  duration: 60 minutes
  hour: HOUR
maintenanceSchedule:
 endTime: 'TIME_STAMP'
 startTime: 'TIME_STAMP'

Where:

• maintenancePolicy shows information on the creation time of your preferred maintenance policy and the last time the policy was updated.
• createTime is when the maintenance policy is first created.
• updateTime is when the maintenance policy was last updated.
• DAY indicates the day of the week maintenance occurs.
• HOUR indicates the hour in UTC time that maintenance begins.
• startTime indicates the specific start time for a maintenance update that is scheduled for your cluster.
• endTime indicates the specific ending time for a maintenance update that is scheduled for your cluster.
• TIME_STAMP uses the RFC 3339 format.

Reschedule maintenance

Caution: if you programmatically reschedule maintenance in bulk requests (not natively supported by Memorystore for Redis Cluster), limit batch reschedule sizes to 100 clusters per batch. For more information, see Rescheduling maintenance.

To reschedule maintenance, see the instructions below:

gcloud

Note: You can only defer a maintenance update for up to two weeks from when a maintenance update is originally scheduled for your cluster.

gcloud redis clusters reschedule-maintenance CLUSTER_ID --region=REGION --reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESHEDULE_TIME]

where:

• CLUSTER_ID is the ID of the cluster
• REGION is the region where your cluster is located

• RESCHEDULE_TYPE is the type of rescheduled update. Available values are:

  • IMMEDIATE: Starts the maintenance update immediately
  • SPECIFIC_TIME: Allows you to designate a specific time for the update. The rescheduled time must be no more than seven days from time of the original maintenance window

• RESHEDULE_TIME You can only specify this value if you set --reschedule-type to SPECIFIC TIME. This value uses the ISO 1801 format. For example, 2020-01-16T16:56:00.000Z. The time is set in UTC time.

For reference information, see gcloud redis clusters reschedule-maintenance.

What's next

• View the permissions required to manage maintenance windows for your Redis cluster.