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

调试

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

请求参数

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

系统规定参数。取值：CreateDedicatedHostGroup。

RegionId String 是 cn-hangzhou

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

Engine String 是 MySQL

数据库引擎类型，取值：

  • MySQL
  • SQL Server
  • Redis
CpuAllocationRatio Integer 否 200

专属集群的CPU超配比。

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

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

说明 取值范围：0%~100%，默认取值为100%。
DiskAllocationRatio Integer 否 200

专属集群的空间超配比。

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

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

  • Evenly（默认）：均衡分配，最大化追求更稳定的系统表现，优先从未分配资源或已分配资源较少的主机中分配资源。
  • Intensively：紧凑分配，最大化追求更充分的资源利用率，优先从创建时间较早且已分配资源较多的主机中分配资源。
VPCId String 是 vpc-t4n7v5m6icc0a4314****

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

HostReplacePolicy String 否 Auto

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

  • Auto（默认）：自动替换主机。
  • Manual：手动替换主机。
说明 仅创建数据库引擎为MySQL的专属集群时，您可以根据实际需求选择主机故障处理策略。其余引擎均请使用Auto默认值。
ClientToken String 是 ETnLKlblzczshOTUbOCz*******

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

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String C6592723-09E1-4248-A78E-12AB00D7A79D

请求ID。
DedicatedHostGroupId String dhg-7a9********

创建的专属集群ID。

示例

请求示例

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

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
403 Permission.NotSupport You are not authorized to perform this action. 不允许操作

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