Updated on 2025-10-21 GMT+08:00

Configuring the Maintenance Window

Function

This API is used to change the maintenance window as required. To prevent service interruption, the maintenance window should fall within the off-peak hours.

Before calling this API, learn how to authenticate it.
Before calling this API, learn about request header parameters.

URI

URI format
PUT /v3/{project_id}/instances/{instance_id}/ops-window

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID.
instance_id	Yes	Specifies the DB instance ID.

Request

**Table 2** Parameters
Parameter	Mandatory	Type	Description
start_time	Yes	String	Specifies the start time (UTC).
end_time	Yes	String	Specifies the end time (UTC). For RDS for MySQL and RDS for PostgreSQL databases, the start time and end time must be on the hour, and the interval between them must be one to four hours. For RDS for SQL Server databases, the interval between the start time and end time must be four hours.

Example Request

Set the maintenance window of a DB instance to 22:00-02:00.

{
     "start_time": "22:00",
     "end_time":"02:00"
}

Response

Example normal response
```
{}
```
Abnormal response
For details, see Abnormal Request Results.

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Parent Topic: DB Instance Management