CreateVirtualCluster - 创建虚拟集群

创建虚拟集群。

接口说明

只有同城冗余的实例支持此操作,且需要满足以下条件:

  • 实例内核小版本大于等于 4.0.7。

  • 主备集群位于不同可用区。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

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. 指定的集群名称不可用

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情