接口说明
本接口用于进行专属宿主机云主机订购。该接口支持按时、按月后付费订购云主机。
注意事项
- 由于海光芯片与Windows系统存在已知的兼容性差异,使用此组合可能导致性能未达最优或偶发不稳定,如启动阶段蓝屏、系统崩溃等问题。建议您在生产部署业务前充分进行兼容性测试。
URL
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/server/order
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
dedicatedHostServerCreateReq
|
DedicatedHostServerCreateReq
|
是
|
dedicatedHostServerCreateReq |
|
billingType
|
enum(MONTH,YEAR,HOUR)
|
否
|
付费方式 |
|
bootVolume
|
云主机系统盘请求体
|
是
|
系统盘请求体 |
|
size
|
integer(int32)
|
是
|
大小(GB) |
|
volumeType
|
enum(local,capacity,highPerformance,performanceOptimization)
|
是
|
系统盘类型 |
|
cpu
|
integer(int32)
|
是
|
CPU大小 |
|
dedicatedHostClusterId
|
string
|
是
|
专属宿主机集群ID |
|
duration
|
integer(int32)
|
否
|
订购时长 |
|
imageId
|
string
|
是
|
镜像ID |
|
keypairName
|
string
|
否
|
云主机密钥对 |
|
name
|
string
|
是
|
云主机名称 |
|
network
|
云主机网络请求体
|
是
|
虚拟机网络信息 |
|
networkId
|
string
|
是
|
指定网络ID |
|
portId
|
string
|
否
|
指定网卡 |
|
password
|
string
|
是
|
云主机密码 |
|
ram
|
integer(int32)
|
是
|
ram大小 |
|
region
|
string
|
是
|
可用区,可通过查询属地的可用区信息获取。 |
|
securityGroupIds
|
<string> array
|
否
|
虚拟机所属安全组 |
|
userData
|
string
|
否
|
用户自定义脚本 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/server/order
{
"billingType":"string",
"bootVolume":{
"size":10,
"volumeType":"string"
},
"cpu":2,
"dedicatedHostClusterId":"string",
"duration":0,
"imageId":"string",
"keypairName":"string",
"name":"string",
"network":{
"fixedIp":"string",
"networkId":"string",
"portId":"string"
},
"password":"string",
"ram":2,
"region":"string",
"securityGroupIds":[
"string"
],
"userData":"string"
}
返回参数
返回码:200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
专属宿主机云API订购返回体
|
请求成功时返回的数据 |
|
orderExts
|
<string> array
|
订单项ID |
|
orderId
|
string
|
订单ID |
|
procedureCode
|
enum(PREPAID,INTERNALAPPROVAL,POSTPAID)
|
付费类型 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码,返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
返回码:200
OK
{
"body":{
"orderExts":[
"string"
],
"orderId":"string",
"procedureCode":"string"
},
"errorCode":"string",
"errorMessage":"string",
"errorParams":[
"string"
],
"requestId":"string",
"state":"string"
}