ModifyInstanceNetworkSpec

Description

Modifies the bandwidth configuration of your ECS instance. If the network specification of your ECS instance is not suitable for your business scale, you can change the bandwidth configuration accordingly. When you call this interface, consider the following:

• When you change the bandwidth configuration of a Subscription instance, consider the following:

  • The configuration of bandwidth billed by PayByTraffic can be upgraded or downgraded.

  • An Internet IP is automatically assigned to an ECS instance when its bandwidth configurations is upgraded from zero Mbps.

• When you change the bandwidth configuration of a Pay-As-You-Go instance, consider the following:

  • The bandwidth configuration can be upgraded or downgraded.

  • The Internet IP is not assigned to an ECS instance when its bandwidth configurations is upgraded from zero Mbps. However, you can call AllocatePublicIpAddress to assign an Internet IP for a Pay-As-You-Go instance.

• The parameters InternetMaxBandwidthIn and InternetMaxBandwidthOut can only be modified when the instance is in the Stopped or Running status.

• After you upgrade the bandwidth configuration for a Classic network instance from zero Mbps, the instance must be restarted to make the change effective.

• Before going ahead with an upgrade, you must make sure that you have registered a valid credit card, once you upgrade the bandwidth configuration, auto-payment is initiated. If the payment is unsuccessful, an abnormal order is returned and can only be nullified.
  If your registered credit card is invalid, you can set the AutoPay parameter to false to cancel the automatic bill payment. Thus, an unpaid order is returned and you can complete the order by making the payment in the ECS console.

• The bandwidth cannot be changed again within five minutes after the action is performed.

Request parameters

Response parameters

All parameters are common response parameters. For more information, see Common parameters.

Examples

Request example

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&InstanceId=i-23nn22421
&InternetMaxBandwidthOut=20
&<Common Request Parameters>

Response example

XML format

<ModifyInstanceNetworkSpecResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</ModifyInstanceNetworkSpecResponse>

JSON format

{
    "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}