Use ModifyDBCluster to change cluster specifications - AnalyticDB - Alibaba Cloud - AnalyticDB

Upgrades or downgrades the specifications of an AnalyticDB for MySQL Data Warehouse Edition (V3.0) cluster.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

adb:ModifyDBCluster

update

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

None

Request parameters

Parameter	Type	Required	Description	Example
DBClusterId	string	Yes	The ID of the AnalyticDB for MySQL Data Warehouse Edition (V3.0) cluster.	am-bp1u8c0mgfg58****
DBNodeGroupCount	string	No	The number of node groups. Valid values: 1 to 200. Note This parameter must be specified when Mode is set to Reserver.	2
DBNodeStorage	string	No	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. Storage capacity below 1,000 GB increases in 100 GB increments. Storage capacity of 1,000 GB or more increases in 1,000 GB increments.	200
DBNodeClass	string	No	The node specifications of the cluster. Valid values: C8 C32 Note This parameter must be specified when Mode is set to Reserver.	C32
ModifyType	string	No	The change type. Valid values: Upgrade Downgrade	Upgrade
ExecutorCount	string	No	N/A	None
RegionId	string	No	The region ID of the cluster. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
StorageResource	string	No	N/A	None
ComputeResource	string	No	The computing resources of the cluster. You can call the DescribeAvailableResource operation to query available computing resources in a region. Note This parameter must be specified when Mode is set to Flexible.	32Core128GBNEW
ElasticIOResourceSize	string	No	The single-node specifications of an elastic I/O unit (EIU). Valid values: 8Core64GB: specifies EIU specifications of 24 cores and 192 GB memory. 12Core96GB: specifies EIU specifications of 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
ElasticIOResource	integer	No	The number of EIUs. The maximum number 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
DBClusterCategory	string	No	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, the specification change fails.	MixedStorage
Mode	string	No	The mode of the cluster. Valid values: Reserver: the reserved mode. Flexible: the elastic mode.	Flexible
DiskPerformanceLevel	string	No	The Enterprise SSD (ESSD) performance level of the cluster. Valid values: PL0 PL1 PL2 PL3	PL1

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	1AD222E9-E606-4A42-BF6D-8A4442913CEF
DBClusterId	string	The cluster ID.	am-bp1u8c0mgfg58****
OrderId	string	The order ID.	2035629****

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.