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 the request header parameters.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
rds:instance:updateOpsWindow	write	instance	g:EnterpriseProjectId g:ResourceTag/<tag-key>	rds:instance:modify	-

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

rds:instance:updateOpsWindow

write

instance

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

rds:instance:modify

URI

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

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Definition Project ID of a tenant in a region. Constraints The value cannot be empty. Range To obtain the value, see Obtaining a Project ID. Default Value N/A
instance_id	Yes	Definition Instance ID. Constraints The value cannot be empty. Range You can obtain the value of this parameter from id in Table 4 by calling the API for querying DB instances. Default Value N/A

Request

**Table 2** Parameters
Parameter	Mandatory	Type	Description
start_time	Yes	String	Definition Specifies the start time (UTC). Constraints N/A Range N/A Default Value N/A
end_time	Yes	String	Definition Specifies the end time (UTC). Constraints N/A Range 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. Default Value N/A

Example Request

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

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/ops-window

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