接口说明
订购专属版，尊享版，办公版，矩阵版云手机。
URL
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/order/zh/ordermgr/order
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
req
|
OpenApiOrderReq
|
是
|
req |
|
autoRenew
|
string
|
是
|
续订标识 是否自动续订标识，0：关闭，1：开启 |
|
duration
|
integer(int32)
|
否
|
订购时长,不填默认为1。feeType为包年时,该字段单位年(1~5年),feeType为包月时,该字段单位月(1~60个月) |
|
extendBandWidth
|
integer(int32)
|
否
|
带宽（单位：Mbps）,4专属版/8办公版/9矩阵版无需填写;尊享版默认赠送100M，可额外订购，按节点维度扩增，若额外新增订购，订购完成后当天控制台不再支持带宽扩容，价格：36元/M/月,可选范围：100~500M，并且是10的整数倍 |
|
extendStorage
|
integer(int32)
|
否
|
额外存储（单位：GB），4专属版/8办公版/9矩阵版无需填写;尊享版默认为0,填写值为单个实例额外存储，额外存储总量=当前展示值*实例个数，价格：1元/G/月,可选范围：0~512GB，并且是32的整数倍 |
|
feeType
|
integer(int32)
|
是
|
包周期类型: 1包年 2包月 |
|
fps
|
integer(int32)
|
否
|
帧率-fps, 4专属版/8办公版/9矩阵版无需填写;尊享版需填写，默认30fps,尊享版-标准版只能是30fps,专业版、专业版Pro、至尊版、旗舰版、极速版、卓越版帧率可以选择30fps、60fps |
|
imageId
|
string
|
是
|
镜像ID |
|
instanceNum
|
integer(int32)
|
是
|
订购数量 4专属版/8办公版/9矩阵版-填写范围1~1000(多少台实例) 5尊享版-填写范围1~20(多少组实例，台数=订购组数*规格路数) |
|
prepareType
|
integer(int32)
|
是
|
版本类型: 4专属版 5尊享版 8办公版 9矩阵版 |
|
regionId
|
string
|
是
|
资源池编码,例如:CIDC-RP-45 |
|
resolution
|
integer(int32)
|
否
|
分辨率-resolution, 4专属版/8办公版/9矩阵版无需填写;尊享版需填写,默认720P,专业版、专业版Pro、至尊版、旗舰版、极速版分辨率可选择720P、1080P，卓越版分辨率可选择720P、1080P、1440P(2K) |
|
specification
|
string
|
是
|
规格配置 与版本类型有关,4专属版-对应规格配置2406131734452992等 5尊享版-对应规格配置2505151142269190等 |
|
zoneId
|
string
|
是
|
可用区编码ID,例如:2011181536180511 |
请求示例
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/order/zh/ordermgr/order{
"regionId":"CIDC-RP-45",
"zoneId":"2011181536180511",
"prepareType":"4",
"duration":1,
"feeType":"2",
"specification":"2406131734452992",
"instanceNum":1,
"imageId":"1925076257413328897",
"autoRenew":"0"
}返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
OpenApiOrderResp
|
响应体 |
|
orderBatchNo
|
string
|
订单批次编号MOP-O-XXX |
|
productList
|
<object> array
|
订单详细信息，其中tradeId为订单号MOP-T-XXX |
|
errorCode
|
string
|
错误编码 |
|
errorMessage
|
string
|
错误信息 |
|
requestId
|
string
|
请求id |
|
state
|
string
|
状态值 |
返回示例
{
"errorCode":"00000000",
"errorMessage":"请求成功",
"requestId":"b755f645-34cc-4743-83b4-ab53901dc9fd",
"state":"OK",
"body":{
"orderBatchNo":"MOP-O-26051631919220",
"productList":[
{
"endDate":"2026-06-16 13:21:08",
"sequenceId":1,
"tradeId":"MOP-T-26051617507192"
}
]
}
}