创建虚拟集群。
接口说明
只有同城冗余的实例支持此操作,且需要满足以下条件:
-
实例内核小版本大于等于 4.0.7。
-
主备集群位于不同可用区。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DBInstanceId |
string |
是 |
实例 ID。 |
selectdb-cn-7213cjv**** |
| RegionId |
string |
是 |
地域 ID。 |
cn-hangzhou |
| ClusterName |
string |
是 |
实例名称。命名规则为:必须字母开头,最多 64 个字符,可以使用字母(大小写不敏感)、数字以及下划线(_),不能包含连续两个及以上的下划线(_),且同一个实例下集群名称不能重复。 |
vcg_demo |
| ActiveClusterId |
string |
是 |
主集群 ID。 |
selectdb-cn-7213cjv**** -be |
| StandbyClusterId |
string |
是 |
备集群 ID。 |
selectdb-26a3cjv**** -be |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
5ED62C81-9948-5612-81E1-EA3853752306 |
| Data |
object |
返回数据。 |
|
| DbInstanceId |
string |
实例 ID。 |
selectdb-cn-7213cjv**** |
| DbClusterId |
string |
集群 ID。 |
selectdb-cn-7213cjv2ez-be |
示例
正常返回示例
JSON格式
{
"RequestId": "5ED62C81-9948-5612-81E1-EA3853752306",
"Data": {
"DbInstanceId": "selectdb-cn-7213cjv****",
"DbClusterId": "selectdb-cn-7213cjv2ez-be"
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | SystemError | A system error occurred while processing your request. | 系统异常。 |
| 400 | ClusterNotSupport | Current instance cluster does not support this operation. | 当前集群状态不支持该操作。 |
| 400 | Forbidden | User not authorized to operate on the specified resource, or this API does not support RAM. | 子账号权限不足,请先获取授权。 |
| 400 | InvalidChargeType.NotSupport | The specified parameter "ChargeType" does not meet the requirements. | 当前计费类型不支持此操作。 |
| 400 | InvalidDBName.Duplicate | Specified DB name already exists in the This instance. | 新建集群名称重复。 |
| 400 | InvalidClusterName.Format | Specified ClusterName is not valid. It can not be empty string. | 输入的集群名称参数不合法。 |
| 400 | MinorVersionNotSupport | The instance version does not support the current operation. | 实例版本不支持当前操作。 |
| 403 | DBClusterNotSupported | The requested operation can not be performed while the cluster is not sale. | 当集群未运行时,无法执行请求的操作。 |
| 403 | IncorrectDBInstanceState | Current DB instance state does not support this operation. | 当前实例状态不支持此操作。 |
| 403 | OperationDenied.VirtualClusterBound | The operation is not permitted due to it has been bound to a virtual cluster. | 操作不允许,因为已绑定到虚拟集群。 |
| 404 | DBInstanceLocked | The current instance lock mode does not support this operation. | 操作失败,当前实例已锁定。 |
| 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. | SelectDB实例不存在。 |
| 404 | InvalidParam | Invalid parameter, please check. | 无效参数,请检查。 |
| 404 | InvalidClusterName.NotFound | The specified cluster name is not available. | 指定的集群名称不可用 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。