ModifyInstanceNetworkSpec

Description

When you call this operation, note that:

• When modifying the bandwidth configurations of a prepaid instance, you can perform the following operations:
  • When outbound bandwidth to the Internet is upgraded from 0 Mbit/s to a non-zero value, a public IP address is automatically allocated.
  • You can use this API to change the bandwidth billing method from PayByTraffic to PayByBandwidth. You can use ECS console to change the bandwidth billing method from PayByTraffic to PayByBandwidth.
• When modifying the bandwidth configurations of a postpaid instance, you can perform the following operations:
  • You can upgrade or downgrade the bandwidth.
  • When outbound bandwidth to the Internet is upgraded from 0 Mbit/s to a non-zero value, a public IP address is automatically allocated. You need to call AllocatePublicIpAddress to assign a public IP address to an instance.
• For a classic instance, when outbound bandwidth to the Internet is upgraded from 0 Mbit/s to a non-zero value, 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 a normal order. Then, you can log on to the ECS console to pay for the order.
• You can downgrade instance type for each prepaid instance three times at most, because the refund of price difference cannot exceed three times.
• The price difference will be refunded to your original form of payment. Used coupons cannot be refunded.
• Each time a downgrade operation is successful, you cannot perform another operation on that instance within five minutes.

Debugging

You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&RegionId=cn-hangzhou 
&InstanceId=i-xxxxx1
&InternetMaxBandwidthOut=10
&ClientToken=xxxxxxxxxxxxxx
&<Common request parameters>

Successful response examples

XML format

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

JSON format

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

Error codes

View error codes