Scheduling Auto-Tune enhancements - Amazon OpenSearch Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Scheduling Auto-Tune enhancements

Prior to February 16, 2023, Auto-Tune used maintenance windows to schedule changes that required a blue/green deployment. Maintenance windows are now deprecated in favor of the off-peak window, which is a daily 10-hour time block during which your domain typically experiences low traffic. You can modify the default start time for the off-peak window, but you can't modify the length.

Any domains that had Auto-Tune maintenance windows enabled before the introduction of off-peak windows on February 16, 2023 can continue to use legacy maintenance windows with no interruption. However, we recommend that you migrate your existing domains to use the off-peak window for domain maintenance instead. For instructions, see Migrating from Auto-Tune maintenance windows.

To schedule Auto-Tune actions the off-peak window

  1. Open the Amazon OpenSearch Service console at https://console.aws.amazon.com/aos/home.

  2. In the navigation pane, under Domains, choose the domain name to open the cluster configuration.

  3. Go to the Auto-Tune tab and choose Edit.

  4. Choose Turn on if Auto-Tune isn't already enabled.

  5. Under Schedule optimizations during off-peak window, select Off-peak window.

  6. Choose Save changes.

To configure your domain to schedule Auto-Tune actions during the configured off-peak window, include UseOffPeakWindow in the UpdateDomainConfig request:

aws opensearch update-domain-config \
  --domain-name my-domain \
  --auto-tune-options DesiredState=ENABLED,UseOffPeakWindow=true,MaintenanceSchedules=null