Maintenance windows

Periodically, Amazon Timestream for InfluxDB performs maintenance on Amazon Timestream for InfluxDB resources. Maintenance most often involves updates to the following resources in your DB instance:

Updates to the operating system most often occur for security issues.

Some maintenance items require that Amazon Timestream for InfluxDB take your DB instance offline for a short time. Maintenance items that require a resource to be offline include required operating system or database patching. Required patching is automatically scheduled only for patches that are related to security and instance reliability. Such patching occurs infrequently, typically once every few months. It seldom requires more than a fraction of your maintenance window.

Maintenance window

Every Amazon Timestream for InfluxDB DB instance has a weekly maintenance window during which maintenance is performed. You can configure your maintenance window in two ways:

You can set your preferred maintenance window when creating a DB instance or change it later using the update-db-instance API.

Timezone

You can specify a timezone for your maintenance window using the timezone field. When set, window times are interpreted in the specified timezone. The timezone field is required. Use IANA timezone identifiers such as America/New_York or Asia/Tokyo. The system handles Daylight Saving Time transitions automatically.

CLI examples

Create a DB instance with a custom maintenance window:

aws timestream-influxdb create-db-instance \
  --name "my-influxdb" \
  --db-instance-type db.influx.medium \
  --allocated-storage 50 \
  --vpc-subnet-ids subnet-12345abc subnet-67890def \
  --vpc-security-group-ids sg-12345abc \
  --maintenance-schedule '{
    "timezone": "America/New_York",
    "preferredMaintenanceWindow": "Sun:02:00-Sun:04:00"
  }' \
  --region us-west-2

Update the maintenance window on an existing DB instance:

aws timestream-influxdb update-db-instance \
  --identifier <instance-identifier> \
  --maintenance-schedule '{
    "timezone": "Asia/Tokyo",
    "preferredMaintenanceWindow": "Wed:03:00-Wed:06:00"
  }' \
  --region us-west-2

Revert to service managed:

aws timestream-influxdb update-db-instance \
  --identifier <instance-identifier> \
  --maintenance-schedule '{
    "timezone": "UTC",
    "preferredMaintenanceWindow": ""
  }' \
  --region us-west-2

During maintenance, the DB instance status changes to MAINTENANCE. After completion, the status returns to AVAILABLE.

Supported timezones

Use IANA timezone identifiers. Timezone abbreviations such as EST, PST, and GMT+5 are not supported.

Considerations