Stay organized with collections
Save and categorize content based on your preferences.
This page provides instructions how to find scheduled maintenance, set
maintenance windows, reschedule planned maintenance, and more.
For an overview of maintenance updates and maintenance windows, see Maintenance policy.
Set a preferred window for maintenance on an instance
In the row for Memorystore, toggle the email button to ON.
A maintenance notification email uses the title, "Upcoming maintenance for your
Cloud Memorystore instance [your-instance-name]". Each person who needs to
needs to receive notifications must opt in separately.
Maintenance notifications are set at the project level rather than on instances.
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 instance, you can view it using the
following instructions:
Choose between Update now, Defer to next scheduled window, and
Custom day and time. For more information, see the overview of rescheduling maintenance.
If you want to update your instance immediately, select Update now
and click Update.
If you want to delay the scheduled maintenance by one week, select
Defer to the next scheduled window and click Reschedule.
If you want to designate a specific time, select Custom day and time,
choose the new time, and click Reschedule.
REGION is the region where your instance is located
RESCHEDULE_TYPE is the type of rescheduled update. Available values are:
IMMEDIATE: Starts the maintenance update immediately
NEXT_AVAILABLE_WINDOW: Defers maintenance until the next maintenance
window. The next window is one week from the window in which maintenance
was originally scheduled
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.
After you receive a notification of upcoming maintenance you have the option
to apply the maintenance update to nodes manually. Manual maintenance is only
available after a maintenance event is scheduled for your instance, and you must
opt in to maintenance notifications and set a maintenance window to be informed
of this upcoming maintenance. For more information, see Manual maintenance.
Updating individual nodes in the Memcached cluster
To update individual nodes in your cluster, run the following command, replacing
VARIABLES with appropriate values:
Checking for available updates and verifying node updates
Signing up for maintenance notifications is the best way to learn when an update
is available, but you can also use the command to below to manually check if
maintenance is available. The following command also shows what nodes have been
updated for your instance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Find and set maintenance windows\n\nThis page provides instructions how to find scheduled maintenance, set\nmaintenance windows, reschedule planned maintenance, and more.\nFor an overview of maintenance updates and maintenance windows, see [Maintenance policy](/memorystore/docs/memcached/maintenance-policy).\n\nSet a preferred window for maintenance on an instance\n-----------------------------------------------------\n\n### Console\n\n1. Go to the **Memorystore for Memcached** page in the Google Cloud console.\n\n [Memorystore for Memcached](https://console.cloud.google.com/memorystore/memcached/instances?)\n\n2. Click the instance ID of the instance you want to set a maintenance window\n for.\n\n3. Click **Edit**.\n\n4. Under the **Maintenance** section, select the desired day, time, and\n duration for the maintenance window. The time is set in your local time\n zone.\n\n5. Click **Save**.\n\n### gcloud\n\nRun the following command to set a maintenance window for a Memcached instance: \n\n```\ngcloud memcache instances update INSTANCE_ID --region=REGION --maintenance-window-day=DAY --maintenance-window-start-time=START_TIME --maintenance-window-duration=DURATION\n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e is the ID of the instance.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e is the region where your instance is located.\n- \u003cvar translate=\"no\"\u003eDAY\u003c/var\u003e is the day you want maintenance to occur. Acceptable values are: `MONDAY`,`TUESDAY`,`WEDNESDAY`,`THURSDAY`,`FRIDAY`,`SATURDAY`,`SUNDAY`.\n- \u003cvar translate=\"no\"\u003eSTART_TIME\u003c/var\u003e is the hour of day (0 to 23) for the start of the maintenance window, in the UTC time zone.\n- \u003cvar translate=\"no\"\u003eDURATION\u003c/var\u003e is a window between 3 and 8 hours in length. Acceptable values are `3h` through `8h`, integers only.\n\nFor reference information, see [`gcloud memcached instances update`](/sdk/gcloud/reference/memcache/instances/update)\n\nOpt in to maintenance notifications\n-----------------------------------\n\n| **Note:** Even if you turn on maintenance notifications, you do not receive notifications unless you [set a maintenance window](/memorystore/docs/memcached/finding-and-setting-maintenance-windows#set_maintenance) for that instance.\n\nTo turn on maintenance notifications:\n\n1. Go to the **Communication** page in the Google Cloud console:\n\n [Communication](https://console.cloud.google.com/user-preferences/communication)\n2. Click the **Product Notifications** tab.\n\n3. Select your project from the dropdown menu.\n\n4. In the row for Memorystore, toggle the email button to **ON**.\n\nA maintenance notification email uses the title, `\"Upcoming maintenance for your\nCloud Memorystore instance [your-instance-name]\"`. Each person who needs to\nneeds to receive notifications must opt in separately.\n\nMaintenance notifications are set at the project level rather than on instances.\nEmail notifications are sent to the email address associated with your Google\naccount. It is not possible to configure a custom email alias (for instance, a\nteam email alias).\n\nFind scheduled maintenance\n--------------------------\n\nIf maintenance has been scheduled for your instance, you can view it using the\nfollowing instructions: \n\n### Console\n\n1. Go to the **Memorystore for Memcached** page in the Google Cloud console.\n\n [Memorystore for Memcached](https://console.cloud.google.com/memorystore/memcached/instances?)\n\n2. Click the instance ID of the instance that you want to view scheduled\n maintenance for.\n\n3. Under the **Maintenance** section, you can view the date and time of any\n scheduled maintenance updates.\n\n### gcloud\n\n```\ngcloud memcache instances describe INSTANCE-ID --region=REGION\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e is the ID of the instance\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e is the region where your instance is located\n\nThe output for scheduled maintenance is as follows: \n\n```\nmaintenancePolicy:\ncreateTime: 'TIME_STAMP'\nupdateTime: 'TIME_STAMP'\nmaintenanceWindow:\n- day: DAY\n duration: 180 minutes\n hour: HOUR\nmaintenanceSchedule:\n endTime: 'TIME_STAMP'\n startTime: 'TIME_STAMP'\n```\n\nWhere:\n\n- `maintenancePolicy` shows information on the creation time of your preferred maintenance policy and the last time the policy was updated.\n- `createTime` is when the maintenance policy is first created.\n- `updateTime` is when the maintenance policy was last updated.\n- `DAY` indicates the day of the week maintenance occurs.\n- `duration` indicates the length of the maintenance window in minutes.\n- `HOUR` indicates the hour in UTC time that maintenance begins.\n- `startTime` indicates the specific start time for a maintenance update that is scheduled for your instance.\n- `endTime` indicates the specific ending time for a maintenance update that is scheduled for your instance.\n- `TIME_STAMP` uses the RFC 3339 format.\n\nReschedule planned maintenance\n------------------------------\n\n| **Caution:** if you programmatically reschedule maintenance in bulk requests (not natively supported by Memorystore for Memcached), limit batch reschedule sizes to 100 instances per batch. For more information, see [Rescheduling maintenance](/memorystore/docs/memcached/maintenance-policy#rescheduling_maintenance).\n\nTo reschedule maintenance, see the instructions below: \n\n### Console\n\n1. Go to the **Memorystore for Memcached** page in the Google Cloud console.\n\n [Memorystore for Memcached](https://console.cloud.google.com/memorystore/memcached/instances?)\n\n2. Click the instance ID of the instance you want to reschedule maintenance\n for.\n\n3. Under the **Maintenance** section, click **RESCHEDULE**.\n\n - You can only reschedule maintenance if you [have a scheduled update](/memorystore/docs/memcached/finding-and-setting-maintenance-windows#find_scheduled_maintenance), for your instance.\n4. Choose between **Update now** , **Defer to next scheduled window** , and\n **Custom day and time** . For more information, see the [overview of rescheduling maintenance](/memorystore/docs/memcached/maintenance-policy#rescheduling_maintenance).\n\n - If you want to update your instance immediately, select **Update now**\n and click **Update**.\n\n - If you want to delay the scheduled maintenance by one week, select\n **Defer to the next scheduled window** and click **Reschedule**.\n\n - If you want to designate a specific time, select **Custom day and time** ,\n choose the new time, and click **Reschedule**.\n\n### gcloud\n\n```\ngcloud memcache instances reschedule-maintenance INSTANCE_ID --region=REGION --reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESHEDULE_TIME]\n```\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e is the ID of the instance\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e is the region where your instance is located\n- \u003cvar translate=\"no\"\u003eRESCHEDULE_TYPE\u003c/var\u003e is the type of rescheduled update. Available values are:\n\n - `IMMEDIATE`: Starts the maintenance update immediately\n - `NEXT_AVAILABLE_WINDOW`: Defers maintenance until the next maintenance window. The next window is one week from the window in which maintenance was originally scheduled\n - `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\n- \u003cvar translate=\"no\"\u003eRESHEDULE_TIME\u003c/var\u003e 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.\n\nFor reference information, see [gcloud memcache instances reschedule-maintenance](/sdk/gcloud/reference/memcache).\n\nManually applying maintenance updates\n-------------------------------------\n\nAfter you receive a notification of upcoming maintenance you have the option\nto apply the maintenance update to nodes manually. Manual maintenance is only\navailable after a maintenance event is scheduled for your instance, and you must\nopt in to maintenance notifications and set a maintenance window to be informed\nof this upcoming maintenance. For more information, see [Manual maintenance](/memorystore/docs/memcached/maintenance-policy#manual_maintenance).\n\n#### Updating individual nodes in the Memcached cluster\n\nTo update individual nodes in your cluster, run the following command, replacing\n\u003cvar translate=\"no\"\u003eVARIABLES\u003c/var\u003e with appropriate values: \n\n```\n\ngcloud beta memcache instances apply-software-update INSTANCE_NAME --node-ids=NODE_ID_1,NODE_ID_2 --region=REGION\n\n```\n\n#### Updating all nodes in the Memcached cluster\n\nTo update all nodes in your cluster, run the following command, replacing\n\u003cvar translate=\"no\"\u003eVARIABLES\u003c/var\u003e with appropriate values: \n\n```\n\ngcloud beta memcache instances apply-software-update INSTANCE_NAME --apply-all --region=REGION\n\n```\n\nChecking for available updates and verifying node updates\n---------------------------------------------------------\n\nSigning up for maintenance notifications is the best way to learn when an update\nis available, but you can also use the command to below to manually check if\nmaintenance is available. The following command also shows what nodes have been\nupdated for your instance. \n\n```\ngcloud memcache instances describe INSTANCE_NAME --region=REGION --format=\"table(updateAvailable.yesno(yes=\"YES\",no=\"NO\"),memcacheNodes:format='table(nodeId,updateAvailable.yesno(yes=\"YES\", no=\"NO\"))')\"\n```\n\nWhat's next\n-----------\n\n- View the [permissions](/memorystore/docs/memcached/access-control#maintenance_policy_permissions) required to manage maintenance windows for your Memcached instance."]]
