ModifyInstanceNetworkSpec

Description

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

• When you modify the bandwidth configurations of a subscription (PrePaid) instance, you can perform the following operations:
  • You can upgrade or downgrade the bandwidth billed in the pay-by-traffic (PayByTraffic) method. You can only upgrade the bandwidth billed in the pay-by-bandwidth (PayByBandwidth) method.
  • When you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) from 0 Mbit/s, a public IP address will be assigned to the instance.
  • You can call the ModifyInstanceNetworkSpec operation to change the bandwidth billing method from pay-by-traffic (PayByTraffic) to pay-by-bandwidth (PayByBandwidth).
  • You can use only the ECS console to change the bandwidth billing method from pay-by-bandwidth (PayByBandwidth) to pay-by-traffic (PayByTraffic).
• When you modify the bandwidth configurations of a pay-as-you-go (PostPaid) instance, you can perform the following operations:
  • You can upgrade or downgrade the bandwidth.
  • When the outbound public bandwidth is upgraded from 0 Mbit/s, no public IP address is allocated. You must call the AllocatePublicIpAddress operation to allocate a public IP address to the instance.
  • You can change the bandwidth billing method from pay-by-traffic (PayByTraffic) to pay-by-bandwidth (PayByBandwidth).
  • You can change the bandwidth billing method from pay-by-bandwidth (PayByBandwidth) to pay-by-traffic (PayByTraffic).
• For an instance in the classic network, when the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s, the instance must be in the Stopped state.
• After the bandwidth is upgraded, AutoPay is set to true by default. 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 the AutoPay parameter to false to generate an unpaid order. Then, you can log on to the ECS console to pay for the order.
• You can downgrade the public bandwidth of each subscription instance for a maximum of three times. Therefore, a maximum of three refunds for price difference can be made.
• The price difference will be refunded to the payment account you used. Used coupons cannot be refunded.
• Each time a modification of bandwidth configurations succeeds, you cannot modify the bandwidth of the instance within five minutes.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&InstanceId=i-bp67acfmxazb4ph***
&InternetMaxBandwidthOut=10
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Sample success responses

XML format

<ModifyInstanceNetworkSpecResponse>
        <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
        <OrderId>1111111111111111111111110</OrderId>
</ModifyInstanceNetworkSpecResponse>

JSON format

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "OrderId": "1111111111111111111111110"
}

Error codes

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