You can call this operation to modify the parameters of a specified ApsaraDB for 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 dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
DBClusterId String Yes pc-xxxxxxxxxx

The ID of the cluster.

Parameters String Yes {"auto_increment":"1","character_set_client":"utf8"}

The JSON string that consists of the parameter and its value. The parameter values are strings: {"auto_increment":"1","character_set_client":"utf8"}

Note You can call the DescribeDBClusterParameters operation to view the parameters of ApsaraDB for PolarDB clusters.
AccessKeyId String No key-test

The AccessKey ID provided to you by Alibaba Cloud.

Action String No ModifyDBClusterParameters

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

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 regardless of 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 within the maintenance window.
  • Immediately: If all the modified values of parameters can take effect regardless of a cluster restart, they immediately take effect. If a cluster restart is required to make the modified values of some parameters take effect, the cluster is immediately restarted to make all of them take effect.
  • MaintainTime: The modified values of parameters take effect within the maintenance window. No matter whether a cluster restart is required to make the modified values of parameters take effect, all of them take effect within the maintenance window.

Default value: Auto

Response parameters

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

The ID of the request.

Examples

Sample requests


http(s)://[Endpoint]/? Action=ModifyDBClusterParameters
&DBClusterId=pc-xxxxxxxxxx
&Parameters={"auto_increment":"1","character_set_client":"utf8"}
&<Common request parameters>

Sample success responses

XML format

<ModifyDBClusterParametersResponse>  
	  <RequestId>D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC</RequestId>
</ModifyDBClusterParametersResponse>

JSON format

{
	"RequestId":"D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC"
}

Error codes

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