调用CreateDedicatedHost接口添加RDS主机。

主机组功能以集群形式批量管理实例,一个地域创建多个主机组,一个主机组包含多个主机,一个主机包含多个实例。详情请参见主机组简介

调试

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

请求参数

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

系统规定参数。取值:CreateDedicatedHost

DedicatedHostGroupId String dhg-7a9xxxxxxxx

主机组ID。

ZoneId String cn-hangzhou-b

主机所属的可用区ID。可以通过接口DescribeRegions查看。

AutoRenew String true

实例是否自动续费。取值:true | false

HostClass String ecs.i2.16xlarge

主机规格。当前唯一取值:ecs.i2.16xlarge

说明 64核CPU,512GB内存,14000GB存储空间。
HostCount Integer 1

添加主机个数。默认值:1

PayType String Prepaid

付费类型。当前仅支持包年包月,唯一取值:Prepaid

VSwitchId String vsw-bpxxxxxxx

虚拟交换机ID。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

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

RegionId String cn-hangzhou

地域ID。可以通过接口DescribeRegions查看可用的地域ID。

Period String Month

指定实例为包年或者包月。取值:

  • Year:包年
  • Month:包月
说明 当参数PayType=Prepaid时该参数必传。
UsedTime String 1

指定包年或包月的时长。

  • 当参数PeriodMonth时,UsedTime取值范围为1~9
  • 当参数PeriodYear时,UsedTime取值范围为1~5
HostName String testHost1

主机名。不输入则系统默认用主机ID作为主机名。

AccessKeyId String LTAIfCxxxxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
DedicateHostList

添加主机列表。

DedicateHostList

添加主机列表。

DedicatedHostId String i-bpxxxxxxx

创建的主机ID。

OrderId Long 10586547

订单ID。

RequestId String AB44DC0A-7E77-442A-97A9-C6418694CB22

请求ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=CreateDedicatedHost
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&ZoneId=cn-hangzhou-b
&AutoRenew=true
&HostClass=ecs.i2.16xlarge
&HostCount=1
&PayType=Prepaid
&VSwitchId=vsw-bpxxxxxxx
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<CreateDedicatedHostResponse>
  <RequestId>AB44DC0A-7E77-442A-97A9-C6418694CB22</RequestId>
  <OrderId>10586547</OrderId>
  <DedicateHostList>
        <DedicateHostList>
              <DedicatedHostId>i-bpxxxxxxx</DedicatedHostId>
        </DedicateHostList>
  </DedicateHostList>
</CreateDedicatedHostResponse>

JSON 格式

{
	"OrderId":10586547,
	"RequestId":"AB44DC0A-7E77-442A-97A9-C6418694CB22",
	"DedicateHostList":{
		"DedicateHostList":[
			{
				"DedicatedHostId":"i-bpxxxxxxx"
			}
		]
	}
}

错误码

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