You can call this operation to change the configuration of an AnalyticDB for MySQL 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
Action String Yes ModifyDBCluster

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

DBClusterId String Yes am-bpxxxxxxxx47

The ID of the cluster.

RegionId String No cn-hangzhou

The region ID of the cluster. You can call the DescribeRegions operation to query the most recent region list.

DBClusterCategory String No Cluster

The edition of the cluster.

  • Valid values for this parameter when the cluster is in reserved mode:
    • Basic
    • Cluster
  • When the cluster is in elastic mode, set the value to

    MixedStorage.

DBNodeGroupCount String No 2

The number of node groups. The clusters of the Cluster Edition in reserved mode are available. Valid values:

  • T8, T16, T32, and T52: 1
  • C8 and C32: 1 to 128
DBNodeClass String No C32

The specification of the node. The clusters of the Cluster Edition in reserved mode are available. Valid values:

  • Cluster Edition: C8 and C32
DBNodeStorage String No 200

The storage space of the node. This parameter is required in reserved mode. Unit: GB. Valid values:

  • T8: 100 to 500
  • T16 and T32: 100 to 2000
  • T52: 100 to 4000
  • C8: 100 to 1000
  • C32: 100 to 8000

The storage space less than 1,000 GB increases in increments of 100 GB. The storage space greater than 1,000 GB increases in increments of 1,000 GB.

Note The number of node groups and the storage space of a node must be separately upgraded and downgraded, and cannot be changed at the same time as the number of node groups or the node specifications.
ModifyType String No Upgrade

The change type of the node specifications. Valid values:

  • Upgrade
  • Downgrade
ComputeResource String No 32Core128GB

The computing resource of the cluster. This parameter is available in elastic mode.

ElasticIOResource Integer No 0

Elastic I/O resources This parameter is available in elastic mode.

StorageResource String No N/A

N/A

ExecutorCount String No N/A

N/A

Response parameters

Parameter Type Example Description
DBClusterId String am-xxxxxxxxxxxxx

The ID of the cluster.

OrderId String 2035629xxxxxx

The ID of the order.

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=ModifyDBCluster
&DBClusterId=am-bpxxxxxxxx47
&DBNodeClass=C32
&DBNodeGroupCount=2
&DBNodeStorage=200
&ModifyType=Upgrade
&<Common request parameters>

Sample success responses

XML format

<RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
<DBClusterId>am-xxxxxxxxxxxxx</DBClusterId>
<OrderId>2035629xxxxxx</OrderId>

JSON format

{
    "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
    "DBClusterId": "am-xxxxxxxxxxxxx",
    "OrderId": "2035629xxxxxx"
}

Error codes

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