Modifies the parameters of a specified PolarDB cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No ModifyDBClusterParameters

The operation that you want to perform. Set the value to ModifyDBClusterParameters.

DBClusterId String Yes pc-**************

The ID of the cluster.
Parameters String Yes {"auto_increment_increment":"1","character_set_filesystem":"utf8"}

The JSON string that consists of parameters and values. The parameter values are strings, for example, {"auto_increment_increment":"1","character_set_filesystem":"utf8"}.

Note You can call the DescribeDBClusterParameters operation to view the parameters of the PolarDB cluster.
EffectiveTime String No Auto

The time when the modified values of parameters take effect. Valid values:

  • Auto: The system automatically determines how the modified values of parameters take effect. If all the modified values of parameters can take effect without a cluster restart, they immediately take effect. If a cluster restart is required to make the modified values of some parameters take effect, all of them take effect after a cluster restart is performed within the maintenance window.
  • Immediately: If all the modified values of parameters can take effect without a cluster restart, the modifications immediately take effect. If a cluster restart is required to make the modified values of some parameters take effect, the cluster is immediately restarted for the modifications to take effect.
  • MaintainTime: The modified values of parameters take effect within the maintenance window. All the modified values of parameters take effect within the maintenance window.

Default value: Auto.

Response parameters

Parameter Type Example Description
RequestId String D0CEC6AC-7760-409A-A0D5-E6CD86******

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/? Action=ModifyDBClusterParameters
&DBClusterId=pc-**************
&Parameters={"auto_increment_increment":"1","character_set_filesystem":"utf8"} 
&<Common request parameters>

Sample success responses

XML format 

<ModifyDBClusterParametersResponse>  
	  <RequestId>D0CEC6AC-7760-409A-A0D5-E6CD86******</RequestId>
</ModifyDBClusterParametersResponse>

JSON format 

{
  "RequestId": "D0CEC6AC-7760-409A-A0D5-E6CD86******"
}

Error codes

For a list of error codes, visit the API Error Center.