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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDedicatedHostGroup

系统规定参数。取值:CreateDedicatedHostGroup

ClientToken String ETnLKlblzczshOTUbOCz*******

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

Engine String MySQL

数据库引擎类型,取值:

  • MySQL
  • SQL Server
  • PostgreSQL
RegionId String cn-hangzhou

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

VPCId String vpc-t4n7v5m6icc0a4314****

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

CpuAllocationRatio Integer 200

专属集群的CPU超配比。

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

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

说明 取值范围: 0%~ 100%,默认取值为 100%
DiskAllocationRatio Integer 200

专属集群的空间超配比。

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

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

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

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

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

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

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

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

返回数据

名称 类型 示例值 描述
DedicatedHostGroupId String dhg-7a9********

创建的专属集群ID。

RequestId String C6592723-09E1-4248-A78E-12AB00D7A79D

请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com?Action=CreateDedicatedHostGroup
&ClientToken=ETnLKlblzczshOTUbOCz*******
&Engine=MySQL
&RegionId=cn-hangzhou
&VPCId=vpc-t4n7v5m6icc0a4314****
&<公共请求参数>

正常返回示例

XML格式

<CreateDedicatedHostGroupReponse>
  <RequestId>C6592723-09E1-4248-A78E-12AB00D7A79D</RequestId>
  <DedicatedHostGroupId>dhg-7a9********</DedicatedHostGroupId>
</CreateDedicatedHostGroupReponse>

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
404 ClustersTemplateNotFound Key account cluster is not supported for the region. 抱歉,该地域尚未开通大客户主机组!
403 Permission.NotSupport You are not authorized to perform this action. 不允许操作

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