ModifyInstanceNetworkSpec

Description

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

• As of November 27, 2020, the peak bandwidth available when you create ECS instances or when you change the configurations of ECS instances is subject to the throttling policy in your account. To increase the peak bandwidth, submit a ticket. The following throttling policies apply:
  • In a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
  • In a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
• If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a subscription (PrePaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, a public IP address is automatically assigned to the instance.
• If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a pay-as-you-go (PostPaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, no public IP address is assigned to the instance. You must call the AllocatePublicIpAddress operation to assign a public IP address to the instance.
• An instance in the classic network must be in the Stopped state before you can upgrade its outbound public bandwidth (InternetMaxBandwidthOut) from 0 Mbit/s.
• After the bandwidth is upgraded, AutoPay is set to true 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. In this case, when you call the ModifyInstanceNetworkSpec operation, an unpaid order is generated. Then, you can log on to the ECS console to pay for the order.
• You can downgrade the public bandwidth of each subscription instance a maximum of three times. A maximum of three refunds for price difference can be made.
• The price difference is 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 again within five minutes.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&InstanceId=i-bp67acfmxazb4p****
&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>123457890</OrderId>
</ModifyInstanceNetworkSpecResponse>

JSON format

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

Errors codes

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