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, take note of the following items:

• The instance must be in the Running (Running) or Stopped (Stopped) state and has no overdue payments.
• After you change the billing method, automatic payment is enabled by default. Make sure that you have sufficient balance in your account. Otherwise, your order becomes invalid and must be canceled. 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.
• Change the billing method from subscription to pay-as-you-go:
  • Whether you can change the billing method depends on your ECS usage.
  • 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 differences of coupon purchases are not refunded.
  • Refund rule: You can apply for only a certain quota of refund within a month, and the refund quota that is not used within the current month will not be accumulated to the next month. After you have used up the refund quota for the current month, you can only change the billing method when the next month arrives. The refund amount incurred when you change the billing method is calculated based on the following formula: Number of vCPUs × (Number of remaining days × 24 ± Number of remaining or elapsed hours).
• Change the billing method 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 a pay-as-you-go instance.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb4p****","i-bp67acfmxazb4d****"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&IncludeDataDisks=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Sample success responses

XML format

<ModifyInstanceChargeTypeResponse>
      <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
      <OrderId>20413515388****</OrderId>
      <FeeOfInstances>
            <FeeOfInstance>
                  <Fee>0</Fee>
                  <InstanceId>i-bp67acfmxazb4p****</InstanceId>
                  <Currency>CNY</Currency>
            </FeeOfInstance>
            <FeeOfInstance>
                  <Fee>0</Fee>
                  <InstanceId>i-bp67acfmxazb4d****</InstanceId>
                  <Currency>CNY</Currency>
            </FeeOfInstance>
      </FeeOfInstances>
</ModifyInstanceChargeTypeResponse>

JSON format

{
    "RequestId":"B61C08E5-403A-46A2-96C1-F7B1216DB10C",
    "OrderId":"20413515388****",
    "FeeOfInstances":
    {
        "FeeOfInstance":[
            {
                "Fee":"0",
                "InstanceId":"i-bp67acfmxazb4p****",
                "Currency":"CNY"
            },
            {
                "Fee":"0",
                "InstanceId":"i-bp67acfmxazb4d****",
                "Currency":"CNY"
            }
        ]
    }
}

Error codes

For a list of error codes, visit the API Error Center.