调用ModifyInstanceChargeType更换一台或者多台ENS实例的计费方式。支持在实例级后付费实例和包年包月实例间相互转换,同时针对实例级后付费实例可以将随实例创建的后付费云盘转换为包年包月云盘。
接口说明
请确保在使用该接口前,已充分了解 ENS 产品的收费方式和价格。
目标实例的状态必须为运行中或者已停止,并且无欠费的情况下才能修改计费方式。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ens:ModifyInstanceChargeType | update | *Instance acs:ens:*:{#accountId}:instance/{#InstanceId} |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceIds | array | 是 | 实例 ID 列表。 | |
string | 是 | 实例 ID。 | i-5xlrc9wdeo3xxxxxx | |
InstanceChargeType | string | 是 | 实例需要修改的目标计费方式。取值: PrePaid:将实例级后付费实例转换为包年包月实例。 PostPaid:将包年包月实例转换为实例级后付费实例(默认值)。 | PostPaid |
AutoRenew | boolean | 否 | 实例级后付费转为包年包月的时候是否开启自动续费。取值: true:自动续费。 false:不自动续费(默认值)。 | false |
Period | string | 否 | 实例级后付费转为包年包月的时候的包年包月时长,如果是此场景下该字段必填。取值: 如果 PeriodUnit 取值为 Day 时,则 Period 仅可设置为 3。 如果 PeriodUnit 取值为 Month 时,则 Period 可设置为 1-9,12。 | 1 |
PeriodUnit | string | 否 | 实例级后付费转为包年包月的时候的购买资源的时长单位,如果是此场景下该字段必填。取值: Month:按月购买。 Day:按天购买。 | Month |
IncludeDataDisks | boolean | 否 | 实例级后付费转为包年包月的时候是否将随实例创建的所有按量付费数据盘一起转换为包年包月数据盘。取值: true:是。 false:否(默认值)。 | true |
AutoPay | boolean | 否 | 实例级后付费转为包年包月的时候是否自动支付。取值: true:自动支付,您需要确保账户余额充足。 false:只生成订单不扣费(默认值)。 | false |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "E2CE5821-7A18-5F7B-A18A-1C751B933D2A",
"InstanceIds": [
"i-5xu1chy7ckxxxx"
],
"OrderId": 0
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | VALIDATE.MODULE.FAILED | Required module is not selected. | 必选模块未选中。 |
400 | ens.interface.error | Failed to call API. | 接口调用发生异常。 |
400 | OrderFailed | Order failed, please try again. | 订单失败请重试 |
400 | SystemUseCouponFailed | Failed to use coupon. | 使用代金券失败 |
400 | SystemUseStoredCardFailed | Failed to use stored value card. | 使用储值卡失败 |
400 | System.SystemError | system error. | 后端系统错误 |
400 | SystemCanRefundCheckFailed | The business rule check of the cloud product fails, and this order cannot be refunded. | 云产品业务规则检查不通过,本订单无法申请退款 |
400 | SystemOtsSystem | ots storage error. | ots存储错误 |
400 | SystemQueryImmortalError | Failed to call Juxiange. | 调用聚仙阁失败 |
400 | SystemQueryInstanceInfoFailed | Failed to find instance information. | 查找实例资源信息失败 |
400 | SystemResellerPayCalRefundUnitError | Ecological payment channel calculation unsubscribe information error. | 生态支付渠道计算退订信息错误 |
400 | SystemSaleValidateFailed | Sales Expression Validation System Error. | 销售表达式校验系统错误 |
400 | SystemTransferDeleteOldResourceFailed | Failed to delete the transferred instance in the transfer order. | 过户订单逻辑删除已过户实例失败 |
400 | SystemUnSupportOperationType | Unsupported operation type. | 不支持的操作类型 |
400 | RiskRiskControlRejection | Risk Control Rejection. | 风险控制拒绝 |
400 | AuthRamAuthFailed | ram sub-account authentication failed. | RAM子账号鉴权失败。 |
400 | CommodityInvalidComponent | The module you purchased is illegal, please re-select. | 你购买的模块非法,请重新选择 |
400 | CommodityInvalidItemCode | Specification code illegal. | 规格code非法 |
400 | PriceHsfTimeoutError | Time out when calling the request for quotation interface. | 调用询价接口超时 |
400 | PricePatingConfigError | Inquiry related goods configuration error. | 询价相关商品配置错误 |
400 | PricePricingPlanResultNotFound | Pricing plan price result not found. | 定价计划价格结果没有找到 |
400 | PriceRatingGetRatingpricingPlan | Obtain a valid pricing plan exception. | 得到有效定价计划异常 |
400 | OrderAbnormalResourceStatusForRenew | Invalid resource status for renewal. | 续费资源状态非法 |
400 | OrderAccountStatusIllegal | Illegal account status. | 账号状态非法 |
400 | OrderArrearage | User Arrears. | 用户欠费 |
400 | OrderBidUserOrderForbidden | Bid users cannot buy on the official website. | bid用户不能在官网购买 |
400 | OrderCaptureFailed | The paid order of the instance has not been deducted successfully. | 实例的已支付订单未扣款成功 |
400 | OrderExistsReleasedInstances | There are already released instances. | 存在已经释放的实例 |
400 | OrderGroupOrderSizeOverflow | The quantity of bound combined payment order exceeds the limit. | 绑定合并支付订单数量超限 |
400 | OrderHomeCurrencyCanNotDowngrade | Users in current currency cannot downgrade. | 本币用户不能降配 |
400 | OrderHomeCurrencyCanNotUpgradeByValueTransfer | Users of current currency cannot upgrade through residual value transfer. | 本币用户不能通过剩余价值转移的方式升级 |
400 | OrderInstanceHasInactiveChange | Instances exist temporary upgrade. | 实例存在临时升级 |
400 | OrderInstHasUnpaidOrder | The instance has an unpaid order. | 实例有未支付订单 |
400 | OrderInstHasUnsettledBills | The instance has an unsettled bill. | 实例有未结算账单 |
400 | OrderLatestOrderIsHandling | Recent order is being processed, please try again later. | 最近的订单正在处理中,请稍候重试 |
400 | OrderMainOrderSizeOverflow | The quantity of the main order exceeds the limit. | 主订单数量超限 |
400 | OrderMissingModuleInfoError | Module parameter not specified. | 未指定模块参数 |
400 | OrderNoRealNameAuthentication | No real-name authentication. | 未实名认证 |
400 | OrderNotFound | The specified order information is not found. | 未查询到指定的订单信息 |
400 | OrderOpend | You have activated this product. | 您已开通该产品 |
400 | OrderPeriodInvalid | Illegal order cycle. | 订购周期非法 |
400 | OrderQuantityInvalid | Illegal quantity ordered. | 订购数量非法 |
400 | OrderQueryInstanceError | Query instance error. | 查询实例错误 |
400 | OrderQueryInstanceNotExists | Instance data does not exist. | 实例数据不存在 |
400 | OrderQueryOrderExchangeRateFail | Failed to query order exchange rate information. | 查询订单汇率信息失败 |
400 | OrderQueryUserSettleInfoFail | Failed to query user settlement information. | 查询用户结算信息失败 |
400 | OrderQuotaExceeded | Quantity exceeds limit. | 数量超出额度限制 |
400 | OrderSysConstraintInvalid | System constraint check failed. | 系统约束校验失败 |
400 | OrderSysConstraintInvalid | The pre-verification of the order failed, please re-match or contact the product. | 下单前置校验失败,请重新选配,或者联系产品 |
400 | OrderTradeCompleteSettleInfoFail | Failed to complete the order settlement currency amount information. | 补全订单结算币种金额信息失败 |
400 | TradeTradeOrderAfterPayCheckError | You have already paid for the subsequent orders of this instance. The current order has been automatically voided and you cannot pay any more. | 您已支付此实例的后续订单,当前订单已自动作废,您不可再支付 |
400 | PurchaseExistRenewchangeProd | There is a renewal change subscription that has not yet taken effect. | 存在未生效的续费变配订购 |
400 | PurchaseExistToBeValidProdRuleError | Currently, there are temporary orders that are not in effect, and the upgrade operation cannot be performed. | 当前有未生效的临时订购,不能进行升级操作 |
400 | PurchaseExistToBeValidRenewChangeProdRuleError | Currently, there is an uneffective renewal change subscription, and temporary upgrade operation cannot be performed. | 当前有未生效续费变配订购,不能进行临时升级操作 |
400 | PurchaseExistValidProdRuleError | Currently, there is a temporary order in effect, and operations such as upgrade/downgrade/expansion/pre-transfer cannot be performed. | 当前有生效中的临时订购,不能进行升级/降配/扩容/预转后等操作 |
400 | ProductInstanceReleased | Instance released. | 实例已释放 |
400 | ProductInstanceTypeNotSupported | The instance type is not supported. | 实例类型不支持 |
400 | PatRiskRejectForTradeData | Payment order problem leads to risk control rejection. | 支付订单问题导致风控拒绝 |
400 | PayAccountBookNotExist | There is no insufficient account balance in the account book, please retry after recharging. | 账本不存在 账户余额不足,请充值后重试 |
400 | PayAmountLimitExceeded | Payment limit exceeded, please resubmit. | 超出支付限额,请重新提交 |
400 | PayBeforePayRiskRuleValidateFailed | The payment was blocked by risk control, and the payment failed. | 该笔支付被风险控制拦截,支付失败 |
400 | PayCounponNotExist | Counpon does not exist. | 代金券不存在 |
400 | PayCouponAmountNotEnough | Insufficient voucher balance or expired. | 代金券余额不足或已过期 |
400 | PayCouponNotMeetConsumptionRule | The coupon does not meet the conditions for use. | 代金券不满足使用条件 |
400 | PayCurrencyInconsistency | Currency mismatch. | 币种不匹配 |
400 | PayCurrencyNotSupported | Currency not supported. | 币种不支持 |
400 | PayForbiddenNoReasonFefund | Banned five days no reason refund. | 禁止五天无理由退款 |
400 | PayHsfTimeoutError | Call payment system timeout. | 调用支付系统超时 |
400 | PayInsufficientBalance | Account balance is insufficient, please recharge and try again. | 账户余额不足,请充值后重试 |
400 | PayInvalidCreditCard | Invalid credit card. | 信用卡无效 |
400 | PayInvalidPayMethod | Illegal payment method. | 支付方式非法 |
400 | PayMegrePayOrderHasThanOneChagreChannel | Payment failed, please retry or submit work order feedback. | 支付失败,请重试或提交工单反馈 |
400 | PayNoCreditCard | No valid payment method, please check the payment method and try again. | 没有有效支付方式,请检查支付方式后重试 |
400 | PayOrderPayTimeInvalid | Order effective time is invalid. | 订单生效时间无效 |
400 | PayPartRefundNotSupport | Not Capture, no partial refund. | 未Capture,不能部分退款 |
400 | PayPayChannelPayOrderInvalidStatus | Illegal status of payment order in payment channel. | 支付渠道支付订单状态非法 |
400 | PayPayChannelPayOrderNotExist | Payment channel payment order does not exist. | 支付渠道支付订单不存在 |
400 | PayPayerAccountIllegal | Illegal payment account. | 支付账户非法 |
400 | PayPayFailedParentRelationchanged | If the financial custody relationship changes, please void the order and place a new order for payment. | 财务托管关系发生变化,请作废订单并重新下单支付 |
400 | PayPayForbidUserCoupon | Coupon prohibited for orders. | 订单禁止使用代金券 |
400 | PayQueryAvailableAmountFailed | Failed to query user availability, please try again later. | 查询用户可用金失败,请稍后重试 |
400 | PayQueryAvailableEnduserAmountFailed | Failed to query the availability of quota direct customer main user, please try again later. | 查询quota直客主用户可用金失败,请稍后重试 |
400 | PayQueryParentRelationshipFailed | Failed to query current user hosting relationship, please try again later. | 查询当前用户托管关系失败,请稍后重试 |
400 | PayQueryPayChangeChannelNotEqual | Multi-order payment channels are inconsistent, please check whether the original order data payment channel is correct. | 多订单支付渠道不一致,请检查原订单数据支付渠道是否正确 |
400 | PayRefundFailed | Accumulated refund amount exceeds payment order amount. | 累计退款金额超过支付单金额 |
400 | PayResellerPayGetUrlError | Order payment failed, please try again later. | 订单支付失败,请稍后重试 |
400 | PayRiskRejectForPayerAccount | Payment account problem leads to risk control rejection. | 支付账户问题导致风控拒绝 |
400 | PayStoredCardNotExist | Stored value card does not exist. | 储值卡不存在 |
400 | PaySystemError | Error calling payment system. | 调用支付系统错误 |
400 | PayTaxCalcFailed | Failed to get user tax address. | 获取用户计税地址失败 |
400 | PayWithholdingAgreementIllegal | Withholding Agreement Status Illegal. | 代扣协议状态非法 |
400 | AccountAliyunAccountFrozen | Alibaba Cloud account is frozen. | 阿里云账号被冻结 |
400 | AccountAliyunAccountNotExist | Alibaba Cloud account does not exist. | 阿里云账号不存在 |
400 | RefundRefundInstanceNotFound | Unable to find instance information. | 无法查到实例信息 |
400 | RefundRefundNoValidProd | Refund is not available to unsubscribe. | 退款无可退订购 |
400 | RefundRefundParamInvalid | Abnormal refund parameter. | 退款参数异常 |
400 | RefundRefundQueryOrderFail | Failed to query order for refund field. | 退款域查询订单失败 |
400 | SystemConcurrentOperate | Concurrent operation causes failure. | 并发操作导致失败 |
400 | PricePricingPlanNotFound | Pricing plan tree not found. | 定价计划树没有找到 |
400 | OrderInstanceHasTempUpgrade | Instances exist temporary upgrade. | 实例存在临时升级 |
400 | PayQueryParentRelationchangedFailed | The financial custody relationship may change, please refresh and pay again. | 财务托管关系可能发生变化,请刷新后重新支付 |
400 | PayforCreditPayInsufficientBalance | Insufficient quota, please contact your channel partner to increase the quota. | 额度不足,请联系您的渠道合作伙伴提升额度 |
400 | PayforAccountMoneyValidateError | The available amount of your channel partner's account is insufficient, please contact your channel partner to recharge in time. | 您的渠道合作伙伴的账号可用金额不足,请联系您的渠道合作伙伴及时充值 |
400 | BasicInfoUncompleted | You have not completed your basic personal information. Please complete the information and re-operate it. | 您未完善个人基本信息,请完善信息后重新操作 |
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. | - |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-08-19 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-06-13 | OpenAPI 错误码发生变更 | 查看变更详情 |