Modifies the parameters of a node and applies them to specified nodes.

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

ParameterTypeRequiredExampleDescription
ActionStringYesModifyDBNodesParameters

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

DBClusterIdStringYespc-**************

The IDs of the clusters.

DBNodeIdsStringYespi-****************, pi-****************

The ID of the node. You can specify multiple node IDs. Separate multiple node IDs with commas (,).

ParametersStringNo{"wait_timeout":"86","innodb_old_blocks_time":"10"}

The JSON string for the parameter and its value.

ParameterGroupIdStringNopcpg-**************

The ID of the parameter template.

PlannedStartTimeStringNo2022-04-28T14:00:00Z

The earliest start time to run the task to modify the parameters of a node and apply them to specified nodes. The task runs within a specified period of time. Specify the time in the YYYY-MM-DDThh:mm:ssZ format. The time must be in UTC.

PlannedEndTimeStringNo2022-04-28T14:30:00Z

The latest start time to run the task. Specify the time in the YYYY-MM-DDThh:mm:ssZ format. The time must be in UTC.

FromTimeServiceBooleanNofalse

Specifies whether to immediately run the task. Valid values: false and true. Default value: false.

Response parameters

ParameterTypeExampleDescription
RequestIdStringEBEAA83D-1734-42E3-85E3-E25F6E******

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/?Action=ModifyDBNodesParameters
&DBClusterId=pc-**************
&DBNodeIds=pi-****************, pi-****************
&Parameters={"wait_timeout":"86","innodb_old_blocks_time":"10"}
&ParameterGroupId=pcpg-**************
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBNodesParametersResponse>
    <RequestId>EBEAA83D-1734-42E3-85E3-E25F6E******</RequestId>
</ModifyDBNodesParametersResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "EBEAA83D-1734-42E3-85E3-E25F6E******"
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameters.FormatSpecified parameters is not valid.The error message returned because a specified parameter is invalid.
400InvalidDBType.MalformedThe Specified DBType is not valid.The error message returned because the specified database type is invalid.
404InvalidDBCluster.NotFoundThe specified DBClusterId is not found.The error message returned because the specified cluster ID does not exist.

For a list of error codes, see Service error codes.