ModifyInstanceChargeType

Description

Before you call this operation, make sure that you have fully understood the billing methods and pricing schedule of ECS.

When you call this operation, note that:

• The instance must be in the running (Running) or stopped (Stopped) state and has no overdue payment.
• After you change the billing method, AutoPay is set to true. Make sure that your account has sufficient balance. Otherwise, your order becomes invalid and you have to cancel this order. If your account balance is insufficient, you can set AutoPay to false. Then, an order is generated. You can log on to the ECS console to pay for it.
• From subscription to Pay-As-You-Go:
  • Users that achieve a certain level of trust can change the billing method from subscription to Pay-As-You-Go.
  • After you change the billing method from subscription to Pay-As-You-Go, the new billing method will take effect for the entire lifecycle of the instance. The price difference is refunded to the payment account you used. Price difference of coupon purchases are not refunded.
  • Refund rule: You can only freely use a certain amount of refund within a month, and the refund that is not used within the current month will not be accumulated to the next month. After you have used up the refund amount for this month, you can only change the billing method when the next month arrives. The refund amount incurred when you change billing methods is calculated with the following formula: Number of vCPUs × (Number of remaining days × 24 ± Number of remaining or elapsed hours).
• From Pay-As-You-Go to subscription:
  • You can change all Pay-As-You-Go data disks attached to an instance to subscription ones.
  • This operation cannot be called if the automatic release time has been set for the Pay-As-You-Go instance.

Debugging

You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou 
&InstanceIds=["i-xxxxx1","i-xxxxx2"] 
&Period=1 
&PeriodUnit=Month 
&AutoPay=false 
&IncludeAllDisks=true 
&ClientToken=xxxxxxxxxxxxxx 
&<Common request parameters>

Successful response examples

XML format

<ModifyInstanceChargeTypeResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
  <OrderId>10111111111xxxxx</OrderId> 
</ModifyInstanceChargeTypeResponse>

JSON format

{
	"OrderId":"10111111111xxxxx",
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

Error codes

View error codes