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

调试

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

请求参数

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

系统规定参数,取值:CreateDedicatedHost

AutoRenew String true

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

  • true:开启
  • false:不开启
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

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

DedicatedHostGroupId String dhg-6w7q18iwt5joxxxx

专属集群的ID,可在专属集群控制台的主机信息页获取。

HostClass String rds.g6.4xlarge

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

PayType String Prepaid

主机的付费类型。取值:

  • PrePaid:包年包月
  • PostPaid:按量付费
VSwitchId String vsw-bp133c8ifzxd3iv6qxxxx

虚拟交换机的ID,可在专属集群控制台的主机信息页获取。

ZoneId String cn-hangzhou-i

可用区ID,可在专属集群控制台的主机信息页获取。

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-t4nn100ddxxxxxxxx

专属集群主机ID。

OrderId Long 102565235

订单ID。

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

请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHost
&DedicatedHostGroupId=dhg-h5i4p331f509xxxx
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<CreateDedicatedHost>
      <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D3CACF</RequestId>
      <DedicateHostList>
            <DedicateHostList>
                  <DedicatedHostId>ch-t4nn100ddxxxxxxxx</DedicatedHostId>
            </DedicateHostList>
      </DedicateHostList>
      <OrderId>102565235</OrderId>
</CreateDedicatedHost>

JSON格式

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

错误码

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