功能介绍
本接口用于进行专属宿主机云主机订购。
URL
URL构造方法如下:
|
请求方法 |
URI |
|
POST |
/api/v2/dedicatedHost/server/order |
请求消息
请求头
|
参数名称 |
参数值 |
|
Content-Type |
application/json |
请求参数
|
参数名称 |
是否必须 |
参数类型 |
参数描述 |
|
dedicatedHostClusterId |
是 |
String |
专属宿主机集群ID |
|
name |
是 |
String |
云主机名称 |
|
imageId |
是 |
String |
云主机镜像ID |
|
cpu |
是 |
Integer |
云主机cpu大小 |
|
ram |
是 |
Integer |
云主机内存大小 |
|
password |
否 |
String |
密文(采用RSA对明文加密,公钥内容详见响应样例最后,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = : , . ? [ ] { }”范围内)(password和keypairName能且仅能填写一个) |
|
keypairName |
否 |
String |
SSH密钥名称,可通过查询密钥列表接口得出(password和keypairName能且仅能填写一个) |
|
bootVolume |
是 |
Object |
云主机系统盘请求体 |
|
bootVolume.size |
是 |
Integer |
云硬盘大小(GB), linux主机系统盘最小为20,windows主机系统盘最小为40,最大均为1024 |
|
bootVolume.volumeType |
是 |
String |
系统盘类型(highPerformance/performanceOptimization) highPerformance:高性能型系统盘 performanceOptimization:性能优化型系统盘 |
|
network |
是 |
Object |
云主机网络请求体 |
|
network.networkId |
是 |
String |
云主机网络ID |
|
network.portId |
否 |
String |
指定网卡ID |
|
securityGroupIds |
否 |
List<String> |
安全组ID集合 |
|
userData |
否 |
String |
云主机自定义数据,可输入[0, 1024]个字符 |
|
region |
是 |
String |
云主机可用区 |
|
duration |
否 |
Integer |
订购时长。按小时付费与按月后付费填写0,按月预付费填写需要订购的月数,取值范围为[1,12];该参数在按时或按月后付费时默认填写0 |
|
billingType |
否 |
String |
默认为HOUR, HOUR: 按小时 MONTH: 按月 |
请求参考示例
请求URL :
https://api-beijing-1.cmecloud.cn:8443/api/v2/dedicatedHost/server/order?AccessKey=52aee87cea39439d9b60276dde06f0b0&Timestamp=2021-07-08T18:09:02Z&Signature=14cf06334d4fcb76c029e163f91c28c21cad5e&SignatureMethod=HmacSHA1&SignatureNonce=206&SignatureVersion=V2.0
请求body:
{
"billingType": "MONTH",
"bootVolume": {
"size": 20,
"volumeType": "performanceOptimization"
},
"cpu": 2,
"dedicatedHostClusterId": "321",
"imageId": "27966b7d-1515-47ba-82c0-4e19823fb67e",
"keypairName": "ceshichuangjian",
"name": "string",
"network": {
"networkId": "2e6c7bc8-f9cd-4f09-80d5-0e107d25bb10"
},
"ram": 2,
"region": "RegionOne"
}响应消息
响应头
|
参数名称 |
参数描述 |
|
Content-Type |
返回内容的MIME类型 |
响应参数
|
参数名称 |
参数类型 |
参数描述 |
|
procedureCode |
String |
订购流程编码(POSTPAID:后付费,PREPAID:预付费) |
|
orderId |
String |
订单编码 |
|
orderExts |
List<String> |
订单项id |
响应参考示例
{
"state": "OK",
"requestId": "reqId-124a1b2efe0d48c193b310ec8ad3b18c",
"body": {
"procedureCode": "POSTPAID",
"orderId": "MOP-O-21090101007341",
"orderExts": [
"MOP-T-21090101007377"
]
}
}
公钥内容:
-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK
+nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO
5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB
-----END PUBLIC KEY-----