调用CreateDedicatedHost接口添加专属集群主机。

调试

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

请求参数

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

系统规定参数,取值:CreateDedicatedHost

AutoRenew String true

是否开启自动续费功能。取值:

  • true(默认):开启。
  • false:不开启。
ClientToken String ETnLKlblzczshOTUbOCzSBZH8****

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

DedicatedHostGroupId String dhg-6w7q18iwt5jo****

专属集群的ID,可调用CreateDedicatedHostGroup获取。

HostClass String rds.g6.4xlarge

主机的规格,您可在专属集群的主机信息页获取主机规格。

PayType String Prepaid

主机的付费类型。取值:

  • PrePaid(默认):包年包月。
  • PostPaid:按量付费。
VSwitchId String vsw-bp133c8ifzxd3iv6q****

虚拟交换机的ID,可调用DescribeDedicatedHosts获取。

ZoneId String cn-hangzhou-i

可用区ID,可调用DescribeDedicatedHosts获取。

RegionId String cn-hangzhou

地域ID。可调用DescribeRegions获取。

HostName String test

主机的名称。长度为1~64个字符,以大小字母或中文开头,可包含数字、下划线(_)或中划线(-)。

Period String Month

指定主机的预付费类型。取值:

  • Year:包年。
  • Month:包月。
说明 PayType参数为PrePaid时 时,本参数才可用且必须传入。
UsedTime String 1

指定购买时长。取值:

  • 当参数Period=Year时,UsedTime取值为1~9
  • 当参数Period=Month时,UsedTime取值为123
说明 付费类型为Prepaid时,本参数才可用且必须传入。

返回数据

名称 类型 示例值 描述
DedicateHostList Array of DedicateHostList

专属集群主机列表。

DedicateHostList
DedicatedHostId String ch-bp108dki3wdl6****

专属集群主机ID。

OrderId Long 102565235

订单ID。

RequestId String C860658E-68A6-46C1-AF6E-3AE7C4D3****

请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHost
&AutoRenew=true
&ClientToken=ETnLKlblzczshOTUbOCzSBZH8****
&DedicatedHostGroupId= dhg-6w7q18iwt5jo****
&HostClass=rds.g6.4xlarge
&VPCId=vpc-bp1o*******
&PayType=Prepaid
&VSwitchId=vsw-bp133c8ifzxd3iv6q****
&ZoneId=cn-hangzhou-i
&RegionId=cn-hangzhou
&HostName=test
&Period=Month
&UsedTime=1
&<公共请求参数>

正常返回示例

XML格式

<CreateDedicatedHostResponse>
  <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D3****</RequestId>
  <DedicateHostList>
        <DedicateHostList>
              <DedicatedHostId> ch-bp108dki3wdl6****</DedicatedHostId>
        </DedicateHostList>
  </DedicateHostList>
  <OrderId>102565235</OrderId>
</CreateDedicatedHostResponse>

JSON格式

{"RequestId":"C860658E-68A6-46C1-AF6E-3AE7C4D3****",
"DedicateHostList":{
    "DedicateHostList":[{
        "DedicatedHostId":" ch-bp108dki3wdl6****"}]},
        "OrderId":"102565235"}

错误码

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