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

调试

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

请求参数

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

系统规定参数。取值:CreateDedicatedHostGroup

ClientToken String ETnLKlblzczshOTUbOCz*******

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

Engine String MySQL

数据库引擎类型,取值:

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

地域ID。可调用DescribeRegions获取。

VPCId String vpc-bp1o*******

专属集群归属的专有网络VPC ID,可调用DescribeDedicatedHosts获取。

CpuAllocationRatio Integer 200

专属集群的CPU超配比,可调用DescribeDedicatedHosts获取。所有实例的CPU资源之和可以是实际CPU资源的2倍,可以最大化使用CPU资源。取值范围:100~300。默认值:200

MemAllocationRatio Integer 90

专属集群中每台主机的内存最大使用率,可调用DescribeDedicatedHosts获取。取值范围:0~90。默认值:90

DiskAllocationRatio Integer 200

专属集群的空间超配比,可调用DescribeDedicatedHosts获取。取值范围:100~300。默认值:200

AllocationPolicy String Evenly

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

  • Evenly(默认):均衡分配,最大化追求更稳定的系统表现,优先将新建数据库实例分配到更空的主机。
  • Intensively:紧凑分配,最大化追求更充分的资源利用率,优先将新建数据库实例分配到已有实例的主机。
HostReplacePolicy String Auto

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

  • Auto(默认):自动替换主机。
  • Manual:手动替换主机。
OpenPermission Integer 0

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

  • 0(默认):不开放。
  • 1:开放。
DedicatedHostGroupDesc String test1

专属集群的名称。长度为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-bp1o*******
&CpuAllocationRatio=200
&MemAllocationRatio=90
&DiskAllocationRatio=200
&AllocationPolicy=Evenly
&HostReplacePolicy=Auto
&OpenPermission=0
&DedicatedHostGroupDesc=test1
&<公共请求参数>

正常返回示例

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. 不允许操作

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