Modifies the parameters of a specified PolarDB cluster or applies existing parameter templates to a specified cluster.

PolarDB supports the parameter template feature. This allows you to quickly apply existing parameters to a PolarDB cluster.

Note Only ApsaraDB PolarDB MySQL-compatible edition clusters support parameter templates.


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
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.

Note You can call the DescribeDBClusters operation to query information about all clusters that are deployed in a specified region, such as the cluster ID.
Parameters String No {"wait_timeout":"86","innodb_old_blocks_time":"10"}

The JSON string that consists of parameters and values. The parameter values are strings, for example, {"wait_timeout":"86","innodb_old_blocks_time":"10"}.

  • You can call the DescribeDBClusterParameters operation to query the parameters of the PolarDB cluster.
  • For ApsaraDB PolarDB PostgreSQL-compatible edition clusters or ApsaraDB PolarDB O Edition clusters, this parameter is required.
  • For ApsaraDB PolarDB MySQL-compatible edition clusters, you must specify this parameter or the ParameterGroupId parameter.
ParameterGroupId String No pcpg-**************

The ID of the parameter template.

  • You can call the DescribeParameterGroups operation to query the parameter template ID.
  • You must specify this parameter or the Parameters parameter.
  • This parameter is supported by only ApsaraDB PolarDB MySQL-compatible edition clusters.

Response parameters

Parameter Type Example Description
RequestId String C5D526E5-91B5-48B8-B980-FE07FF******

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "C5D526E5-91B5-48B8-B980-FE07FF******"

Error codes

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