All Products
Search
Document Center

AnalyticDB:ModifyDBCluster

Last Updated:Aug 30, 2024

Changes the specifications of an AnalyticDB for MySQL Data Warehouse Edition cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
adb:ModifyDBClusterupdate
  • DBCluster
    acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
DBClusterIdstringYes

The ID of the AnalyticDB for MySQL Data Warehouse Edition (V3.0) cluster.

am-bp1u8c0mgfg58****
DBNodeGroupCountstringNo

The number of node groups. Valid values: 1 to 200.

Note This parameter must be specified when Mode is set to Reserver.
2
DBNodeStoragestringNo

The storage capacity per node. Unit: GB.

  • Valid values when DBClusterClass is set to C8: 100 to 2000.
  • Valid values when DBClusterClass is set to C32: 100 to 8000.
Note
  • This parameter must be specified when Mode is set to Reserver.

  • The storage capacity less than 1,000 GB increases in 100 GB increments. The storage capacity greater than 1,000 GB increases in 1,000 GB increments.

200
DBNodeClassstringNo

The node specifications of the cluster. Valid values:

  • C8
  • C32
Note This parameter must be specified when Mode is set to Reserver.
C32
ModifyTypestringNo

The change type. Valid values:

  • Upgrade
  • Downgrade
Upgrade
ExecutorCountstringNo

N/A

None
RegionIdstringNo

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

cn-hangzhou
StorageResourcestringNo

N/A

None
ComputeResourcestringNo

The computing resources of the cluster. You can call the DescribeAvailableResource operation to query the computing resources that are available within a region.

Note This parameter must be specified when Mode is set to Flexible.
32Core128GBNEW
ElasticIOResourceSizestringNo

The single-node specifications of an elastic I/O unit (EIU). Valid values:

  • 8Core64GB: If you set the parameter to 8Core64GB, the specifications of an EIU are 24 cores and 192 GB memory.
  • 12Core96GB: If you set the parameter to 12Core96GB, the specifications of an EIU are 36 cores and 288 GB memory.
Note This parameter takes effect only when your cluster meets the following requirements:
  • The cluster is in elastic mode.

  • If the cluster resides in the China (Guangzhou), China (Shenzhen), China (Hangzhou), China (Shanghai), China (Qingdao), China (Beijing), or China (Zhangjiakou) region, the cluster has 16 cores and 64 GB memory or higher specifications.

  • If the cluster resides in another region, the cluster has 32 cores and 128 GB memory or higher specifications.

8Core64GB
ElasticIOResourceintegerNo

The number of EIUs. The number of EIUs that you can purchase varies based on the single-node EIU specifications.

  • If the single-node EIU specifications are 8 cores and 64 GB, you can purchase up to 32 EIUs.
  • If the single-node EIU specifications are 12 cores and 96 GB, you can purchase up to 16 EIUs.
2
DBClusterCategorystringNo

The edition of the cluster. Valid values:

  • Cluster: reserved mode for Cluster Edition.
  • MixedStorage: elastic mode for Cluster Edition.
Note If you set DBClusterCategory to Cluster, you must set Mode to Reserver. If you set DBClusterCategory to MixedStorage, you must set Mode to Flexible. Otherwise, you fail to change the specifications of the cluster.
MixedStorage
ModestringNo

The mode of the cluster. Valid values:

  • Reserver: the reserved mode.
  • Flexible: the elastic mode.
Flexible
DiskPerformanceLevelstringNo

The enhanced SSD (ESSD) performance level of the cluster. Valid values:

  • PL0
  • PL1
  • PL2
  • PL3
PL1

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

1AD222E9-E606-4A42-BF6D-8A4442913CEF
DBClusterIdstring

The cluster ID.

am-bp1u8c0mgfg58****
OrderIdstring

The order ID.

2035629****

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-12-06The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-12-06The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-09-15The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-09-14The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-09-13The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-06-27The internal configuration of the API is changed, but the call is not affectedView Change Details