接口说明
修改实例的计费模式。
使用须知：
-
创建实例会涉及资源计费，建议您提前了解云服务器 ECS 的计费方式。
-
请妥善保管AccessKey，以防通过接口产生不知情订购资费。
注意事项：
-
目标实例的状态必须为运行中或者已停止，并且无欠费的情况下才能修改计费方式。
-
chargeMode参数可选按量（HOUR）、包年（YEAR)、包月(MONTH)。
-
专属宿主机上实例不支持。
-
弹性裸金属暂不支持按量计费。
-
支持同步变更实例绑定的带宽和数据盘，但需满足以下条件：
-
带宽、数据盘的计费方式需与实例相同。
-
开启同步变更将变更所有满足变更条件的带宽和数据盘资源，不支持指定资源。
-
边缘云实例不支持。
-
URL
POST https://ecloud.10086.cn/api/openapi-instance/v4/modify-charge-mode
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
instanceModifyChargeModeReq
|
InstanceModifyChargeModeReq
|
是
|
instanceModifyChargeModeReq |
|
relatedResourcesChange
|
RelatedResourcesChange
|
否
|
关联资源变更参数。 |
|
changeBandwidth
|
boolean
|
否
|
是否同步变更关联带宽计费方式，开启后关联共享带宽将同步变更。取值范围：
默认值：false。 |
|
changeDataVolume
|
boolean
|
否
|
是否同步变更关联数据盘计费方式，开启后关联共享盘将同步变更。取值范围：
默认值：false。 |
|
instanceId
|
string
|
是
|
实例ID。 |
|
chargeMode
|
string
|
是
|
计费方式。HOUR：按量, MONTH：包月, YEAR：包年。 |
|
duration
|
integer(int32)
|
否
|
计费方式变更时长(月/年)。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-instance/v4/modify-charge-mode{
"chargeMode":"MONTH",
"duration":1,
"instanceId":"7dx1fc06-31b8-4231-7643-7aadd6gdx0f1",
"unchangedResources":{
"changeBandwidth":true,
"changeDataVolume":true
}
}返回参数
|
参数名称
|
类型
|
描述
|
|
body
|
InstanceOrderInfoWithRelated
|
请求成功时返回的数据。 |
|
orderExts
|
<OrderExt> array
|
订单项ID。 |
|
orderExtType
|
string
|
订单类型。vm(实例)，highPerformance(高性能型系统盘)，performanceOptimization(性能优化型系统盘)。 |
|
subOrderId
|
string
|
订单项ID。 |
|
orderId
|
string
|
订单ID。 |
|
paymentInfo
|
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)
|
付费类型。 |
|
unchangedResources
|
<UnchangedResource> array
|
未完成变更的关联资源信息。 |
|
message
|
string
|
未变更的原因。 |
|
resourceId
|
string
|
资源ID。 |
|
resourceType
|
string
|
资源类型。 |
|
errorCode
|
string
|
统一错误码。 |
|
errorMessage
|
string
|
页面国际化错误提示。 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数。 |
|
requestId
|
string
|
每个请求的序列号。 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码。返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN。 |
返回示例
{
"requestId":"reqId-b9cef50843b84020a721552bf2e2191d",
"state":"OK",
"body":{
"orderId":"MOP-O-26062424580404",
"orderExts":[
{
"subOrderId":"MOP-T-26062411186614",
"orderExtType":"vm"
},
{
"subOrderId":"MOP-T-26062411186616",
"orderExtType":"extremePerformanceL1yc"
},
{
"subOrderId":"MOP-T-26062411186618",
"orderExtType":"bandwidth"
},
{
"subOrderId":"MOP-T-26062411186620",
"orderExtType":"essdycl1"
}
],
"procedureCode":"POSTPAID",
"unchangedResources":[
{
"resourceId":"2bfab143-a548-4cc8-b0f9-eccc3db2f8ae",
"resourceType":"cbwp",
"message":"带宽【2bfab143-a548-4cc8-b0f9-eccc3db2f8ae】与当前实例计费方式不同。"
},
{
"resourceId":"757aee6d-a14e-46fa-87c4-95aaeeab4ae1",
"resourceType":"essdycl1",
"message":"数据盘【757aee6d-a14e-46fa-87c4-95aaeeab4ae1】与当前实例计费方式不同。"
}
]
}
}