调用CreateDedicatedHostGroup接口创建专属集群-云数据库专属集群-阿里云-云数据库专属集群(MyBase)-阿里云帮助中心

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cddc:CreateDedicatedHostGroup

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可查看地域信息获取。	cn-hangzhou
Engine	string	是	数据库引擎类型，取值： MySQL SQL Server Redis	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（默认）：均衡分配，最大化追求更稳定的系统表现，优先从未分配资源或已分配资源较少的主机中分配资源。 Intensively：紧凑分配，最大化追求更充分的资源利用率，优先从创建时间较早且已分配资源较多的主机中分配资源。	Evenly
VPCId	string	是	专属集群归属的专有网络 ID，可在专有网络控制台左侧单击专有网络查看目标专有网络 ID。	vpc-t4n7v5m6icc0a4314****
HostReplacePolicy	string	否	主机故障时系统的处理策略。取值： Auto（默认）：自动替换主机。 Manual：手动替换主机。说明仅创建数据库引擎为 MySQL 的专属集群时，您可以根据实际需求选择主机故障处理策略。其余引擎均请使用 Auto 默认值。	Auto
ClientToken	string	是	客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。该参数值只能包含 ASCII 字符，且不超过 64 个 ASCII 字符。	ETnLKlblzczshOTUbOCz*******
OpenPermission	integer	否	是否开放专属集群内的主机的 OS 权限。取值： 0：关闭。 1：开放。说明仅创建数据库引擎为 MySQL、SQL Server的专属集群时，您可以根据实际需求选择主机开放 OS 权限。其余引擎暂未提供主机开放 OS 权限功能，该参数取值默认为关闭。SQLServer 必须要指定开放权限（1）。	1
DedicatedHostGroupDesc	string	否	专属集群的名称。长度为 1~64 个字符，以大小字母或中文开头，可包含数字、下划线（_）或中划线（-）。	mysqlcluster

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	C6592723-09E1-4248-A78E-12AB00D7A79D
DedicatedHostGroupId	string	创建的专属集群 ID。	dhg-7a9********

示例

正常返回示例

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.	该地域尚未开通大客户主机组

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

变更历史

更多信息，参考变更详情。