All Products
Search
Document Center

ApsaraDB for SelectDB:ModifyVirtualCluster

Last Updated:Mar 31, 2026

Modifies a virtual cluster.

Operation description

  • You can modify the primary cluster independently.

  • You can modify the standby cluster independently.

  • You can switch between the primary and standby clusters.

Warning You cannot modify both the primary and standby clusters in the same operation.

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

DBInstanceId

string

Yes

The instance ID.

selectdb-cn-7213cjv****

DBClusterId

string

Yes

The virtual cluster ID.

selectdb-vcg-b****-be

RegionId

string

Yes

The region ID.

cn-hangzhou

ActiveClusterId

string

No

The ID of the primary cluster.

selectdb-o2yg***-be

StandbyClusterId

string

No

The ID of the standby cluster.

selectdb-pu6y****-be

Response elements

Element

Type

Description

Example

object

The response body.

RequestId

string

The request ID.

06758CAB-1204-5852-A471-29C87D5C1D0F

Data

object

The returned data.

DbInstanceId

string

The instance ID.

selectdb-cn-7213cjv****

DbClusterId

string

The cluster ID.

selectdb-vcg-b****-be

Examples

Success response

JSON format

{
  "RequestId": "06758CAB-1204-5852-A471-29C87D5C1D0F",
  "Data": {
    "DbInstanceId": "selectdb-cn-7213cjv****",
    "DbClusterId": "selectdb-vcg-b****-be"
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 SystemError A system error occurred while processing your request. The system is abnormal.
400 ClusterNotSupport Current instance cluster does not support this operation. The operation is not supported in the current cluster state.
400 Forbidden User not authorized to operate on the specified resource, or this API does not support RAM. english description1
400 InvalidChargeType.NotSupport The specified parameter "ChargeType" does not meet the requirements.
403 DBClusterNotSupported The requested operation can not be performed while the cluster is not sale. The requested operation cannot be performed while the cluster is not running.
403 IncorrectDBInstanceState Current DB instance state does not support this operation. english description1
404 DBInstanceLocked The current instance lock mode does not support this operation. english description1
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 InvalidDBInstanceId.NotFound The DBInstanceId provided does not exist in our records. Instance does not exist.
404 InvalidParam Invalid parameter, please check.
404 InvalidClusterName.NotFound The specified cluster name is not available. The specified cluster name is not available

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.