续订云主机

接口说明

本接口用于续订云主机。
说明:

  1. 只支持操作包年包月实例,不支持操作按量付费实例。
  2. 续订时请确保账户余额充足。
  3. 仅包年云主机可选择到期以包月或按量的计费方式进行续订。

计费:

  1. 续订实例会涉及资源计费,建议您提前了解云服务器 ECS 的计费方式。更多详情,请参见云主机计费规则。
  2. 请妥善保管AccessKey,以防通过接口产生不知情订购资费。

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

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"
	}
}

返回参数

返回码:200
OK
参数名称
类型
描述
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

返回示例

返回码:200
OK
{
	"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
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。