调用CreateDedicatedHostGroup接口创建专属集群。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID。可查看地域信息获取。 | cn-hangzhou |
Engine | string | 是 | 数据库引擎类型,取值:
| MySQL |
CpuAllocationRatio | integer | 否 | 专属集群的 CPU 超配比。 说明
取值范围:100%~300%,默认取值为200%,代表所有实例的 CPU 资源之和可以是实际 CPU 资源的 2 倍,充分利用资源。
| 200 |
MemAllocationRatio | integer | 否 | 专属集群中每台主机的内存最大使用率。 说明
取值范围:0%~100%,默认取值为100%。
| 100 |
DiskAllocationRatio | integer | 否 | 专属集群的空间超配比。 说明
取值范围:100%~300%,默认取值为200%,代表所有实例的空间资源之和可以是实际空间资源的 2 倍,充分利用资源。该设置对于 SQLServer 无效。
| 200 |
AllocationPolicy | string | 否 | 专属集群资源调度的分配策略。取值:
| Evenly |
VPCId | string | 是 | 专属集群归属的专有网络 ID,可在专有网络控制台左侧单击专有网络查看目标专有网络 ID。 | vpc-t4n7v5m6icc0a4314**** |
HostReplacePolicy | string | 否 | 主机故障时系统的处理策略。取值:
说明
仅创建数据库引擎为 MySQL 的专属集群时,您可以根据实际需求选择主机故障处理策略。其余引擎均请使用 Auto 默认值。
| Auto |
ClientToken | string | 是 | 客户端生成该参数值,用于保证请求的幂等性,防止重复提交请求。该参数值只能包含 ASCII 字符,且不超过 64 个 ASCII 字符。 | ETnLKlblzczshOTUbOCz******* |
OpenPermission | integer | 否 | 是否开放专属集群内的主机的 OS 权限。取值:
说明
仅创建数据库引擎为 MySQL、SQL Server的专属集群时,您可以根据实际需求选择主机开放 OS 权限。其余引擎暂未提供主机开放 OS 权限功能,该参数取值默认为关闭。SQLServer 必须要指定开放权限(1)。
| 1 |
DedicatedHostGroupDesc | string | 否 | 专属集群的名称。长度为 1~64 个字符,以大小字母或中文开头,可包含数字、下划线(_)或中划线(-)。 | mysqlcluster |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "C6592723-09E1-4248-A78E-12AB00D7A79D",
"DedicatedHostGroupId": "dhg-7a9********"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Permission.NotSupport | You are not authorized to perform this action. | 不允许操作 |
404 | ClustersTemplateNotFound | Key account cluster is not supported for the region. | 该地域尚未开通大客户主机组 |
访问错误中心查看更多错误码。