云主机计费方式变更

接口说明

本接口用于云主机计费方式变更。
说明:

  1. 政企集团客户与省集团客户的云主机计费方式可支持:按量转包月、按量转包年、包月转按量、包月转包年。
  2. 互联网客户的云主机计费方式可支持:包月转包年、包月转按量、按量转包月、按量转包年。
  3. 目标实例的状态必须为运行中或者已停止,并且无欠费的情况下才能修改计费方式。
  4. billingType参数可选按量(HOUR)、按年(YEAR)、按月(MONTH)。

计费:

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

推荐使用API Explorer调试

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

URL

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/billingType

请求参数

Body

参数名称
类型
必填
描述
changeBillingTypeReq
ChangeBillingTypeReq
是

云主机计费方式变更请求体。

billingType
string
是

计费方式。
HOUR:按量
MONTH:按月
YEAR:按年

duration
integer(int32)
否

计费方式变更时长(月/年),单位由billingType指定。
取值范围:

  1. billingType = HOUR 时:无需填写该参数,默认为0;
  2. billingType = MONTH 时:政企集团或省集团客户取值范围为[0,60],如果取值为0,会设置成订购一个月并开启自动续订,1-60表示具体订购的月数; 互联网客户取值范围为[1,12],1-12表示具体订购的月数;
  3. billingType = YEAR 时:包年付费填写需要订购的年数,取值范围为[1,5]。
serverId
string
是

云主机ID,可通过主机列表详情接口获取。

请求示例

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/billingType
{
	"body":{
		"billingType":"MONTH",
		"duration":1,
		"serverId":"7dx1fc06-31b8-4231-7643-7aadd6gdx0f1"
	}
}

返回参数

返回码: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

签名值

WeiXinAppId
string

微信公众号ID/应用ID

payLink
string

支付链接

procedureCode
enum(PREPAID,INTERNALAPPROVAL,POSTPAID)

付费类型。PREPAID:预付费,INTERNALAPPROVAL:内部审批,POSTPAID:后付费

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-51c470a8d102szdc684f5-be7d9795-7",
	"state":"OK",
	"body":{
		"procedureCode":"POSTPAID",
		"orderId":"MOP-O-24051672157671",
		"orderExts":[
			"MOP-T-24057652418477",
			"MOP-T-24051642825479"
		],
		"orderExtTypes":[
			"vm",
			"highPerformance"
		],
		"paymentInfo":null,
		"resourceRemind":null
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。