调用CreateDedicatedHostGroup接口创建RDS主机组。
主机组功能以集群形式批量管理实例,一个地域创建多个主机组,一个主机组包含多个主机,一个主机包含多个实例。详情请参见主机组简介。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDedicatedHostGroup |
系统规定参数。取值:CreateDedicatedHostGroup。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。可以通过接口DescribeRegions查看可用的地域ID。 |
Engine | String | 是 | MySQL |
数据库类型。唯一取值:MySQL。 |
ClientToken | String | 是 | ETnLKlblzczshOTUbOCzxxxxxxx |
用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
VPCId | String | 是 | vpc-bp1oxxxxxxx |
主机组归属的专有网络VPC ID。 |
CpuAllocationRatio | Integer | 否 | 200 |
主机组的CPU超配比。取值范围:100~300。默认值:200。 |
DiskAllocationRatio | Integer | 否 | 200 |
主机组的空间超配比。取值范围:100~200。默认值:200。 |
MemAllocationRatio | Integer | 否 | 90 |
主机组中每台主机的内存最大使用率。取值范围:0~90。默认值:90。 |
AllocationPolicy | String | 否 | Evenly |
主机组资源调度的分配策略。取值:
|
HostReplacePolicy | String | 否 | Auto |
主机故障时系统的处理策略。取值:
|
AccessKeyId | String | 否 | LTAIfCxxxxxxxxxx |
阿里云颁发给用户的访问服务所用的密钥ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DedicatedHostGroupId | String | dhg-7a9xxxxxxxx |
创建的主机组ID。 |
RequestId | String | C6592723-09E1-4248-A78E-12AB00D7A79D |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=CreateDedicatedHostGroup
&RegionId=cn-hangzhou
&Engine=MySQL
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxx
&VPCId= vpc-bp1oxxxxxxx
&<公共请求参数>
正常返回示例
XML
格式
<CreateDedicatedHostGroupResponse>
<RequestId>C6592723-09E1-4248-A78E-12AB00D7A79D</RequestId>
<DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
</CreateDedicatedHostGroupResponse>
JSON
格式
{
"RequestId":"C6592723-09E1-4248-A78E-12AB00D7A79D",
"DedicatedHostGroupId":"dhg-7a9xxxxxxxx"
}
错误码
访问错误中心查看更多错误码。