Upgrades a locally redundant instance to a zone-redundant instance.
Operation description
When an instance is upgraded to a zone-redundant architecture, its storage is also upgraded to be zone-redundant. The unit price for storage changes. For more information, see Billing items and pricing.
Version requirements
The minor version of the instance must be 4.0.4 or later.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The ID of the region where the instance resides. |
cn-beijing |
| DBInstanceId |
string |
Yes |
The instance ID. |
selectdb-cn-7213cjv**** |
| MultiZone |
array<object> |
Yes |
A list of multi-zone configurations. |
|
|
object |
Yes |
Multi-zone configuration. |
||
| ZoneId |
string |
Yes |
The zone ID. |
cn-beijing-k |
| VSwitchIds |
array |
Yes |
The vSwitch ID. |
|
|
string |
Yes |
The vSwitch ID. |
vsw-bp10dbralpn4bzmgkkh8f |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
ADF42B18-43FD-5100-83A9-BE81AB70C863 |
Examples
Success response
JSON format
{
"RequestId": "ADF42B18-43FD-5100-83A9-BE81AB70C863"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | DocumentConvertFailed.ExceedFileSizeLimit | The conversion has been failed, exceed file size limit. | english description1 |
| 400 | Forbidden | User not authorized to operate on the specified resource, or this API does not support RAM. | english description1 |
| 400 | InvalidDBName | The specified database name is not allowed. | english description1 |
| 400 | CreateOrderFailed | Failed to create order. | Failed to create order. |
| 400 | InvalidZoneId.Duplicated | The zones cannot be repeated please select different zones. | The selected Availability Zone cannot be duplicated |
| 400 | InvalidZoneId.Malformed | The specified parameter "ZoneId" is not valid. | The ZoneId parameter is invalid |
| 400 | InvalidVSwitchId.Malformed | The specified parameter "VSwitchId" is not valid. | The parameter VSwitchId is invalid. |
| 400 | InvalidMultiZone.NotThreeZones | The number of zones must be three. | The number of multi-availability zones must be three. |
| 400 | MinorVersionNotSupport | The instance version does not support the current operation. | The instance version does not support the current operation. |
| 400 | ClusterNotSupport | Current instance cluster does not support this operation. | The operation is not supported in the current cluster state. |
| 400 | InvalidZoneId.Undeployed | The zone is undeployed. | The zone is undeployed. |
| 400 | InvalidOperatorType.Malformed | The specified operator type is not valid. | Invalid operation. |
| 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 |
| 403 | InstanceEngineType.NotSupport | The instance engine and type does not support operations. | english description1 |
| 403 | InvalidDBInstanceState.NotSupport | The specified instance state does't support this operation. | The instance is in a state that does not support the current operation. |
| 403 | MoneyLessThan100 | The Account Monet less Than 100. | english description1 |
| 403 | OperationDenied.DBNameAndAccountPrivilegeCount | The operation is not permitted due to count of database or account privilege. | english description1 |
| 403 | InsufficientResourceCapacity | The resource is out of usage. | Not enough resources, please try again later. |
| 403 | IncorrectDBInstanceLockMode | Current DB instance lock mode does not support this operation. | Current DB instance lock mode does not support this operation. |
| 404 | DBInstanceLocked | The current instance lock mode does not support this operation. | english description1 |
| 404 | IncorrectVswitchId | The specified parameter VSwitchId is not valid. | english description1 |
| 404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | |
| 404 | InvalidDBInstance.NotFound | The specified instance is not found. | english description1 |
| 404 | InvalidDBInstanceClass.NotFound | The specified instance classic does not exist. | english description1 |
| 404 | InvalidRegionId.NotFound | The provided RegionId does not exist in our records. | english description1 |
| 404 | QueryPrice.Failed | The inquiry failed. Contact Alibaba Cloud customer service representatives. | english description1 |
| 404 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in our records. | Instance does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.