CreateDedicatedHostGroup - 创建专属集群

调用CreateDedicatedHostGroup接口创建专属集群。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。可查看地域信息获取。

cn-hangzhou
Enginestring

数据库引擎类型,取值:

  • MySQL

  • SQL Server

  • Redis

MySQL
CpuAllocationRatiointeger

专属集群的 CPU 超配比。

说明 取值范围:100%~300%,默认取值为200%,代表所有实例的 CPU 资源之和可以是实际 CPU 资源的 2 倍,充分利用资源。
200
MemAllocationRatiointeger

专属集群中每台主机的内存最大使用率。

说明 取值范围:0%~100%,默认取值为100%
100
DiskAllocationRatiointeger

专属集群的空间超配比。

说明 取值范围:100%~300%,默认取值为200%,代表所有实例的空间资源之和可以是实际空间资源的 2 倍,充分利用资源。该设置对于 SQLServer 无效。
200
AllocationPolicystring

专属集群资源调度的分配策略。取值:

  • Evenly(默认):均衡分配,最大化追求更稳定的系统表现,优先从未分配资源或已分配资源较少的主机中分配资源。
  • Intensively:紧凑分配,最大化追求更充分的资源利用率,优先从创建时间较早且已分配资源较多的主机中分配资源。
Evenly
VPCIdstring

专属集群归属的专有网络 ID,可在专有网络控制台左侧单击专有网络查看目标专有网络 ID。

vpc-t4n7v5m6icc0a4314****
HostReplacePolicystring

主机故障时系统的处理策略。取值:

  • Auto(默认):自动替换主机。
  • Manual:手动替换主机。
说明 仅创建数据库引擎为 MySQL 的专属集群时,您可以根据实际需求选择主机故障处理策略。其余引擎均请使用 Auto 默认值。
Auto
ClientTokenstring

客户端生成该参数值,用于保证请求的幂等性,防止重复提交请求。该参数值只能包含 ASCII 字符,且不超过 64 个 ASCII 字符。

ETnLKlblzczshOTUbOCz*******
OpenPermissioninteger

是否开放专属集群内的主机的 OS 权限。取值:

  • 0:关闭。
  • 1:开放。
说明 仅创建数据库引擎为 MySQL、SQL Server的专属集群时,您可以根据实际需求选择主机开放 OS 权限。其余引擎暂未提供主机开放 OS 权限功能,该参数取值默认为关闭。SQLServer 必须要指定开放权限(1)。
1
DedicatedHostGroupDescstring

专属集群的名称。长度为 1~64 个字符,以大小字母或中文开头,可包含数字、下划线(_)或中划线(-)。

mysqlcluster

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

C6592723-09E1-4248-A78E-12AB00D7A79D
DedicatedHostGroupIdstring

创建的专属集群 ID。

dhg-7a9********

示例

正常返回示例

JSON格式

{
  "RequestId": "C6592723-09E1-4248-A78E-12AB00D7A79D",
  "DedicatedHostGroupId": "dhg-7a9********"
}

错误码

HTTP status code错误码错误信息描述
403Permission.NotSupportYou are not authorized to perform this action.不允许操作
404ClustersTemplateNotFoundKey account cluster is not supported for the region.该地域尚未开通大客户主机组

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