接口说明
本接口仅适用于特殊场景使用，请谨慎使用。创建时网络参数portType字段如果设置为1，后续该云主机在调用云主机关机（shelve）接口后，该网卡资源会进行释放；该接口支持按时、按月后付费订购云主机。密钥BEGIN PUBLIC KEY-----MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB-----END PUBLIC KEY-----
注意事项
- 由于海光芯片与Windows系统存在已知的兼容性差异，使用此组合可能导致性能未达最优或偶发不稳定，如启动阶段蓝屏、系统崩溃等问题。建议您在生产部署业务前充分进行兼容性测试。
URL
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/server/cloudComputer/order
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
cloudComputerCreateReq
|
DedicatedHostServerCreateForCloudComputerReq
|
是
|
云电脑云主机创建请求体 |
|
billingType
|
enum(MONTH,HOUR)
|
否
|
付费方式，默认为按时 |
|
bootVolume
|
云主机系统盘请求体
|
是
|
系统盘请求体 |
|
size
|
integer(int32)
|
是
|
云硬盘大小（GB），Linux主机系统盘最小为20，Windows主机系统盘最小为40，最大均为1024 |
|
volumeType
|
enum(highPerformance,performanceOptimization,highPerformanceyc,performanceOptimizationyc)
|
是
|
系统盘类型，highPerformance：高性能型系统盘 performanceOptimization：性能优化型系统盘 highPerformanceyc: 高性能-云创 performanceOptimizationyc：性能优化型-云创 |
|
cpu
|
integer(int32)
|
是
|
CPU大小 |
|
dataVolumes
|
<云主机数据盘请求体> array
|
否
|
数据盘请求体 |
|
isShare
|
boolean
|
否
|
是否为共享数据盘,默认为非共享盘 |
|
resourceType
|
enum(capebs,ssd,ssdebs,capebsyc,ssdyc,ssdebsyc,capebszx)
|
是
|
数据盘类型，capebs：容量型数据盘；ssd：高性能型数据盘；ssdebs：性能优化型数据盘；capebsyc：容量型数据盘-云创；ssdyc：高性能型数据盘-云创；ssdebsyc：性能优化型数据盘-云创；capebszx：容量型专享版数据盘 |
|
size
|
integer(int32)
|
是
|
数据盘大小（G），大小需在[10,32768]间 |
|
dedicatedHostClusterId
|
string
|
是
|
专属宿主机集群ID |
|
duration
|
integer(int32)
|
否
|
订购时长，按小时付费与按月后付费填写0；该参数在按时或按月后付费时默认填写0 |
|
homotype
|
boolean
|
否
|
是否创建与宿主机同类型云主机。仅用于GPU宿主机创建普通云主机场景，默认为true，即GPU宿主机创建GPU云主机 |
|
imageId
|
string
|
是
|
镜像ID |
|
keypairName
|
string
|
否
|
云主机密钥对，可通过查询密钥列表接口得出（password和keypairName能且仅能填写一个） |
|
name
|
string
|
是
|
云主机名称，云主机名称应为5-59位的英文字母、数字和'-'组成，'-'不能在名称的开头或末尾 |
|
network
|
云主机创建网络请求体
|
是
|
虚拟机网络信息 |
|
networkId
|
string
|
否
|
指定网络ID |
|
portType
|
integer(int32)
|
否
|
网卡类型，可传0或1，0表示普通云主机网卡，1表示云电脑网卡，云电脑网卡在调用关机释放资源接口后，网卡资源会进行释放 |
|
password
|
string
|
否
|
云主机密码，密文（采用RSA对明文加密，公钥内容详见接口说明，用户可用该公钥自行加密明文得到密文。明文8-16位字符，同时包括数字、大小写字母和特殊字符，其中特殊字符最多不能超过3个，且需要在“~ @ # $ % * _ - + = : , . ? [ ] { }”范围内）（password和keypairName能且仅能填写一个） |
|
ram
|
integer(int32)
|
是
|
ram大小 |
|
region
|
string
|
是
|
可用区，可通过查询属地的可用区信息获取。 |
|
securityGroupIds
|
<string> array
|
否
|
虚拟机所属安全组 |
|
userData
|
string
|
否
|
用户自定义脚本，可输入[0, 1024]个字符 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/server/cloudComputer/order{
"billingType":"string",
"bootVolume":{
"size":20,
"volumeType":"string"
},
"dataVolumes":[
{
"isShare":"false",
"resourceType":"string",
"size":20
}
],
"cpu":2,
"dedicatedHostClusterId":"string",
"duration":0,
"homotype":"true",
"imageId":"string",
"keypairName":"string",
"name":"string",
"network":{
"networkId":"string",
"portType":1
},
"password":"string",
"ram":2,
"region":"string",
"securityGroupIds":[
"string"
],
"userData":"string"
}返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
云主机订购成功返回体
|
请求成功时返回的数据 |
|
orderExts
|
<string> array
|
订单项ID |
|
orderId
|
string
|
订单ID |
|
paymentInfo
|
预付费申请详情
|
支付信息 |
|
ActivityCode
|
string
|
交易代码 |
|
BusiType
|
string
|
业务类型 |
|
BusinessChannels
|
string
|
移动云全网渠道编码 |
|
CerID
|
string
|
证书标识串 |
|
ChargeMoney
|
string
|
充值金额 |
|
CustomParam
|
string
|
商户自定义参数 |
|
CustomerNumber
|
string
|
客户编码 |
|
HomeProv
|
string
|
归属省份 |
|
IDType
|
string
|
中国移动用户标识类型 |
|
IDValue
|
string
|
中国移动用户号码 |
|
NotifyURL
|
string
|
订单结果通知URL |
|
OrderMoney
|
string
|
订单总金额 |
|
OrderNo
|
string
|
订单号 |
|
Payment
|
string
|
用户支付金额 |
|
ProductDesc
|
string
|
产品描述 |
|
ProductID
|
string
|
产品编号 |
|
ProductName
|
string
|
产品名称 |
|
ProductURL
|
string
|
商品展示网址 |
|
ReqChannel
|
string
|
请求方渠道编码 |
|
ReturnURL
|
string
|
支付成功跳转返回页面URL |
|
SignValue
|
string
|
签名值 |
|
TimeoutExpress
|
string
|
该笔订单允许的最晚付款时间 |
|
WeiXinAppId
|
string
|
微信公众号ID/应用ID |
|
payLink
|
string
|
支付链接 |
|
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 |
返回示例
{
"body":{
"orderExts":[
"string"
],
"orderId":"string",
"paymentInfo":{
"ActivityCode":"string",
"BusiType":"string",
"BusinessChannels":"string",
"CerID":"string",
"ChargeMoney":"string",
"CustomParam":"string",
"CustomerNumber":"string",
"HomeProv":"string",
"IDType":"string",
"IDValue":"string",
"NotifyURL":"string",
"OrderMoney":"string",
"OrderNo":"string",
"Payment":"string",
"ProductDesc":"string",
"ProductID":"string",
"ProductName":"string",
"ProductURL":"string",
"ReqChannel":"string",
"ReturnURL":"string",
"SignValue":"string",
"TimeoutExpress":"string",
"WeiXinAppId":"string",
"payLink":"string"
},
"procedureCode":"string"
},
"errorCode":"string",
"errorMessage":"string",
"errorParams":[
"string"
],
"requestId":"string",
"state":"string"
}