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

调试

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

请求参数

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

系统规定参数,取值:CreateDedicatedHost

AutoRenew String true

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

  • true:开启。
  • false:不开启。
ClientToken String ETnLKlblzczshOTUbOCzSBZH8****

客户端生成该参数值,用于保证请求的幂等性,防止重复提交请求。该参数值只能包含ASCII字符,且不超过64个ASCII字符。

DedicatedHostGroupId String dhg-6w7q18iwt5jo****

目标专属集群ID,可通过专属集群控制台集群列表获取。

HostClass String rds.g6.4xlarge

主机的规格。单击主机规格详情查看支持的主机规格。

PayType String Prepaid

主机的付费类型。取值为PrePaid(包年包月)。

VSwitchId String vsw-bp133c8ifzxd3iv6q****

虚拟交换机的ID,可通过专有网络控制台查看目标虚拟机ID。

ZoneId String cn-hangzhou-i

可用区ID,可调用地域信息获取。

RegionId String cn-hangzhou

主机所在专属集群地域ID。可查看地域信息获取。

HostName String test

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

Period String Month

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

  • Year:包年。
  • Month:包月。
  • Week:包周。
UsedTime String 1

指定购买时长。取值:

  • 当参数Period=Year时,UsedTime取值为1~5
  • 当参数Period=Month时,UsedTime取值为1~9
  • 当参数Period=Week时,UsedTime取值为123

返回数据

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

专属集群主机列表。

DedicateHostList
DedicatedHostId String ch-bp108dki3wdl6****

专属集群主机ID。

OrderId Long 102565235

订单ID。

RequestId String C860658E-68A6-46C1-AF6E-3AE7C4D32375

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

JSON格式

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

错误码

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