参数名称 | 类型 | 必填 | 描述 |
|---|
| Action | String | 是 | 公共参数，本接口取值：CreateDedicatedHosts。 |
| Version | String | 是 | 公共参数，本接口取值：2016-03-04。 |
| DedicatedType | String | 是 | 物理机类型 示例值：DC1/DR1/DS2/DC2/DN2 |
| Number | Int | 是 | 购买数量 示例值：1-5 |
| Name | String | 否 | 物理机名称（如果未指定，则自动生成） |
| ChargeType | String | 是 | 购买方式 示例值：Monthly/Daily |
| PurchaseTime | Int | 是 | 购买时长 示例值：当PurchaseType为Monthly的时候，必填。可选范围包括：1～9，12 |
| InstanceNameSuffix | String | 否 | 物理机名称后缀（购买多台物理机时使用） 示例值：0-999（此参数如果缺省，参数不生效；当大于1台的批量创建主机，后缀编号自动+1，例如后缀输入5，主机名输入"host"，批量3台，则生成的三台主机名分别为："host-5"、"host-6"、"host-7"；） |
| DedicatedClusterId | String | 否 | |
| Tag.N | Object | 否 | 创建的专属宿主机的标签键，N取值范围1~10。若填写了Tag.N.Value，Tag.N.Key为必填，且两个参数的N值需保持一致 示例值：支持1-128个字符，仅支持中英文字符、数字及±=._/@: |
| Key | String | 否 | 创建的专属宿主机的标签键，N取值范围1~10。若填写了Tag.N.Value，Tag.N.Key为必填，且两个参数的N值需保持一致 示例值：支持1-128个字符，仅支持中英文字符、数字及±=._/@: |
| Value | String | 否 | 创建的专属宿主机的标签值，N取值范围1~10 示例值：256个字符内，仅支持中英文字符、数字及±=._/@()[]（）【】: |
参数名称 | 类型 | 描述 |
|---|
| RequestId | String | 示例值：4567890 |
| DedicatedHostSet | Object | |
| DedicatedHostId | String | 示例值：44dcfd5b-f92b-4907-ab8b-ea7c7290b7 |
| DedicatedHostName | String | 示例值：host653 |
JSON格式
XML格式
<?xml version="1.0" encoding="UTF-8"?><CreateDedicatedHostsResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/"><DedicatedHostSet><Item><DedicatedHostId>44dcfd5b-f92b-4907-ab8b-ea7c729053b7</DedicatedHostId><DedicatedHostName>host1695758147653</DedicatedHostName></Item></DedicatedHostSet><RequestId>bd0239f5-e64c-46fb-b8dd-e3a738a48571008</RequestId></CreateDedicatedHostsResponse>
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码
错误码 | 错误信息 | Http状态码 | 描述 |
|---|
| ProductSellOutInvalid | product already sell out. | 400 | 此商品在该机房已售罄. |
| InstanceConfigureGPUInvalid | An invalid or out-of-range value was supplied for the "InstanceConfigure.GPU" parameter. | 400 | "InstanceConfigure.GPU"参数范围无效 |
| TagParameterLimitExceeded | At most 10 tags can be associated with the resource. | 400 | 资源最多关联10个标签 |
| ChargeTypeInvalidParameterValue | An invalid or out-of-range value was supplied for the "ChargeType" parameter. | 400 | “计费类型”参数的取值无效或者超出有效范围 |
| InstanceConfigureMemoryInvalid | An invalid or out-of-range value was supplied for the "InstanceConfigure.MemoryGb" parameter. | 400 | "InstanceConfigure.MemoryGb"参数的取值无效或者超出有效范围 |
| DedicatedHostCapacityNotEnough | Statistics capacity is not enough | 400 | 宿主机容量不足，请联系客服 |
| InstanceNameInvalidParameterValue | An invalid or out-of-range value was supplied for the "InstanceName" parameter. | 400 | “实例名称”参数的取值无效或者超出有效范围 |
| DataDiskGbInvalidParameterValue | An invalid or out-of-range value was supplied for the "DataDiskGb" parameter. | 400 | “数据卷容量”参数的取值无效或者超出有效范围 |
| DedicatedNumberInvalid | DedicatedNumber is invalid | 400 | 购买数量不正确，有效值为1-5正整数 |
| DedicatedModelInvalidParameterValue | 暂无 | 400 | 暂无 |
| InstanceConfigureVCPUInvalid | An invalid or out-of-range value was supplied for the "InstanceConfigure.VCPU" parameter. | 400 | "InstanceConfigure.VCPU"参数范围无效 |
| DedicatedTypeRequired | DedicatedType is required | 400 | 专属宿主机类型必填 |
| InstanceNameSuffixInvalidParameterValue | InstanceName suffix is out-of-range -1~9999 | 400 | 主机后缀名参数必须在-1~9999范围内 |
| DedicatedClusterIdInvalidParameterValue | 暂无 | 400 | 暂无 |
| AvailabilityZoneRequired | AvailabilityZone is required | 400 | 可用区必传 |
| InvalidParameter.TagKeyDuplicate | tag key duplicate | 400 | 标签key重复 |
| InstanceOrderNotInUse | The "InstanceOrder" parameter should not be used when calling directly from SDK or OpCenter. | 400 | 使用SDK或者运营平台调用不应该传递“实例订单”参数 |
纯净模式
