Help Center/ GeminiDB/ API Reference/ APIs v3 (Recommended)/ Instances/ Setting the Maintenance Period of an Instance

Updated on 2025-12-04 GMT+08:00

View PDF

Setting the Maintenance Period of an Instance

Function

This API is used to set the maintenance period of a specified instance.

Constraints

This API supports the following instances:

GeminiDB Influx
GeminiDB Redis
GeminiDB Mongo
GeminiDB Cassandra

Authorization Information

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

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

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
gaussdbfornosql:instance:modifyMaintenanceWindow	write	instance *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	nosql:instance:modifyMaintenanceWindow	-

URI

PUT /v3/{project_id}/instances/{instance_id}/maintenance-window

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
instance_id	Yes	String	Definition Instance ID Constraints N/A Range N/A Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token Constraints N/A Range N/A Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
start_time	Yes	String	Definition Start time Constraints The value must be a valid UTC time exactly on the hour in the HH:MM format. By default, the end time is four hours later than the start time. Range N/A Default Value N/A

Response Parameters

Status code: 204

None

Example Requests

Set the maintenance window of an instance to 02:00-06:00.

PUT https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/b0965c9010f44ffca9af4ee00746aa8din12/maintenance-window 
 
{ 
  "start_time" : "02:00" 
}