ModifyInstanceChargeType

Description

Before you call this operation, make sure that you understand the billing methods and pricing schedule of ECS. For more information, see the Elastic Compute Service product page.

When you call this operation, take note of the following items:

• The instances must be in the Running (Running) or Stopped (Stopped) state, and you have no overdue payments for them.
• 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 is canceled. If your account balance is insufficient, you can set the AutoPay parameter to false to generate an unpaid order. Then, you can log on to the ECS console to pay for the order.
• Change the billing method from subscription to pay-as-you-go:
  • Your ECS usage determines whether the billing method of an instance can be changed from subscription to pay-as-you-go.
  • After you change the billing method of an instance from subscription to pay-as-you-go, the new billing method remains in effect for the remaining lifecycle of the instance. The price difference is refunded to the payment account that you used. Vouchers that have been redeemed are not refundable.
  • Refund rule: You have a quota for the total refund amount each month, and unused balance of this quota is not carried forward into the next month. After you use up the refund quota of the current month, you can change the billing method only 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 the billing method of all data disks attached to an instance from pay-as-you-go to subscription.
  • This operation cannot be called for a pay-as-you-go instance that has an automatic release time set.

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

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

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