接口说明
本接口用于续订云主机。
说明:
- 只支持操作包年包月实例,不支持操作按量付费实例。
- 续订时请确保账户余额充足。
- 仅包年云主机可选择到期以包月或按量的计费方式进行续订。
计费:
- 续订实例会涉及资源计费,建议您提前了解云服务器 ECS 的计费方式。更多详情,请参见云主机计费规则。
- 请妥善保管AccessKey,以防通过接口产生不知情订购资费。
URL
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/renew
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
renewServerReq
|
RenewServerReq
|
是
|
续订云主机请求体。 |
|
billingType
|
string
|
否
|
续订变更要转的计费方式,填入内容:TURN_MONTH:到期转包月;TURN_AMOUNT:到期转按量。 |
|
duration
|
integer(int32)
|
是
|
续订时长(月/年),包年到期转按量非必填,其他都必填。 |
|
serverId
|
string
|
是
|
云主机ID,可通过主机列表详情接口获取。 |
请求示例
PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/renew
{
"body":{
"duration":2,
"serverId":"72dse2f9-23e5-4fca-xs3a-4f416d5188ae"
}
}
返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
ServerApiCreateOrderResp
|
请求成功时返回的数据 |
|
orderExtTypes
|
<enum(vm,performanceOptimization,highPerformance,capebs,ssdebs,ssd,bandwidth,ip)> array
|
订单项类型,vm(云主机),performanceOptimization(性能优化型系统盘),highPerformance(高性能型系统盘),capebs(容量型云硬盘),ssdebs(性能优化型云硬盘),ssd(高性能型云硬盘),bandwidth(带宽),ip(公网ip) |
|
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
|
支付链接,paymentInfo节点下的所有以大写字母开头的参数,即序号为5.3~5.24的参数,用post+form表单的形式跳转到此链接 |
|
procedureCode
|
enum(PREPAID,INTERNALAPPROVAL,POSTPAID)
|
付费类型。PREPAID:预付费,INTERNALAPPROVAL:内部审批,POSTPAID:后付费 |
|
resourceRemind
|
string
|
资源波动提示 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码;返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
{
"requestId":"reqId-009623s4a556322e0d840-a7716046-1",
"state":"OK",
"body":{
"procedureCode":"POSTPAID",
"orderId":"MOP-O-24024375637619",
"orderExts":[
"MOP-T-24051531418443",
"MOP-T-24051642476345"
],
"orderExtTypes":[
"vm",
"highPerformance"
],
"paymentInfo":null,
"resourceRemind":null
}
}