Find and set maintenance windows

Console

To create a cluster with maintenance windows, see Create instances.

gcloud

To create a cluster with maintenance windows, use the gcloud redis clusters create command:

gcloud redis clusters create CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--network=NETWORK \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--maintenance-window-day=MAINTENANCE_WINDOW_DAY \
--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR

Make the following replacements:

• CLUSTER_ID: the ID of the cluster that you're creating. The cluster ID must be 1 to 63 characters and use only lowercase letters, numbers, or hyphens. It must start with a lowercase letter and end with a lowercase letter or number.

• PROJECT_ID: the project ID or number of the Google Cloud project where you want to create the cluster.

• REGION_ID: the region where you want the cluster to be located.

• NETWORK: the network that you want to use to create the cluster. It must use this format: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. The NETWORK_ID that you use here must match the network ID that the service connection policy uses. Otherwise, you can't create the cluster.

• REPLICA_COUNT: the number of replicas (per shard). Accepted values are 0-5.

• NODE_TYPE: the node type for the cluster. Accepted values are:

  • redis-shared-core-nano
  • redis-standard-small
  • redis-highmem-medium
  • redis-highmem-xlarge

• SHARD_COUNT: the number of shards in the cluster. The shard count determines the total memory capacity for storing cluster data. For more information about cluster specifications, see Cluster and node specification.

• MAINTENANCE_WINDOW_DAY: the day that you want maintenance to occur. Acceptable values are MONDAY - SUNDAY.

• MAINTENANCE_WINDOW_HOUR: the hour of the day (in UTC time) when the maintenance window starts. Acceptable values are 0 - 23.

For example:

gcloud memorystore redis clusters my-cluster \
--project=my-project \
--region=us-central1 \
--network=projects/my-network-project/global/networks/default \
--replica-count=2 \
--node-type=redis-highmem-medium \
--shard-count=8 \
--maintenance-window-day=MONDAY \
--maintenance-window-hour=9

By default, when you create a cluster with maintenance windows, in-transit encryption is deactivated and the authorized network is default.

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click the cluster for which you want to set a preferred window.

3. On the Cluster at a glance page, scroll until the Maintenance card appears.

4. Next to the Maintenance window field, click Edit (edit).

   If a day and time appear next to the field, then you already set the maintenance window for the cluster.

5. In the Edit maintenance window dialog, do the following:

   1. Select Custom.
   2. From the Day menu, select the day that you want maintenance to occur.
   3. From the Time menu, select the hour when you want the maintenance window to start.
   4. Click Update cluster.

gcloud

To set a maintenance window for a cluster, use the gcloud redis clusters update command:

gcloud redis clusters update CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--maintenance-window-day=DAY
--maintenance-window-hour=HOUR

Make the following replacements:

• CLUSTER_ID: the ID of the cluster.
• PROJECT_ID: the project ID or number of the Google Cloud project that contains the cluster.
• REGION_ID: the region where the cluster is located.
• DAY: the day that you want maintenance to occur. Acceptable values are
  MONDAY - SUNDAY.
• HOUR: the hour of the day (in UTC time) when the maintenance window starts. Acceptable values are 0 - 23.

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click the cluster for which you want to find the scheduled maintenance.

3. On the Cluster at a glance page, scroll until the Maintenance card appears.

   Next to the Maintenance window field, the day and time of the scheduled maintenance appear.

gcloud

To find the scheduled maintenance for a cluster, use the gcloud redis clusters describe command.

gcloud redis clusters describe CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID

Make the following replacements:

• CLUSTER_ID: the ID of the cluster
• PROJECT_ID: the project ID or number of the Google Cloud project that contains the cluster
• REGION_ID: the region where the cluster is located

The output for scheduled maintenance is as follows:

maintenancePolicy:
createTime: 'CREATE_DATE_AND_TIME_STAMP'
updateTime: 'UPDATE_DATE_AND_TIME_STAMP'
maintenanceWindow:
- day: DAY
  duration: 60 minutes
  hour: HOUR
maintenanceSchedule:
 endTime: 'END_DATE_AND_TIME_STAMP'
 startTime: 'START_DATE_AND_TIME_STAMP'

Where:

• maintenancePolicy displays information about the creation time of the preferred maintenance policy and the last time the policy is updated.
  • CREATE_DATE_AND_TIME_STAMP is when the maintenance policy is first created.
  • UPDATE_DATE_AND_TIME_STAMP is when the maintenance policy is last updated.
• maintenanceWindow displays information about the maintenance window for the cluster.
  • DAY is the day of the week when maintenance occurs.
  • HOUR is the hour (in UTC time) when maintenance begins.
• maintenanceSchedule displays information about the scheduled maintenance for the cluster.
  • END_DATE_AND_TIME_STAMP indicates when a scheduled maintenance update ends for the cluster.
  • START_DATE_AND_TIME_STAMP indicates when a scheduled maintenance update begins for the cluster.

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click the cluster for which you want to reschedule maintenance.

3. On the Cluster at a glance page, scroll until the Maintenance card appears.

4. Next to the Upcoming maintenance field, click Edit (edit).

   If the No maintenance scheduled right now status appears next to this field, then maintenance isn't scheduled for the cluster.

5. In the Reschedule upcoming maintenance dialog, do the following:

   1. From the Choose a new time menu, select Specific time.
   2. From the Date field, click Calendar (date_range), and then select the date that you want maintenance to occur.
   3. From the Time menu, designate a specific time for the update. This time must be no more than 14 days from the time of the original maintenance window.
   4. Click Reschedule.

   You can also use the Reschedule upcoming maintenance dialog to have Memorystore for Redis Cluster perform maintenance on the cluster immediately. From this dialog, select Update now from the Choose a new time menu, and then click Update now.

gcloud

To reschedule maintenance for a cluster, use the gcloud redis clusters reschedule-maintenance command.

gcloud redis clusters reschedule-maintenance CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESHEDULE_TIME]

Make the following replacements:

• CLUSTER_ID: the ID of the cluster.
• PROJECT_ID: the project ID or number of the Google Cloud project that contains the cluster.
• REGION_ID: the region where the cluster is located.

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

  • IMMEDIATE: start the maintenance update immediately.
  • SPECIFIC_TIME: designate a specific time for the update. This time must be no more than 14 days from the time of the original maintenance window.

• RESCHEDULE_TIME: the date and time when Memorystore for Redis Cluster reschedules the maintenance update.