ModifyInstanceNetworkSpec

Description

When you call this operation, note that:

• When modifying 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-data-transfer (PayByTraffic) method. You can only upgrade the bandwidth billed in the pay-by-bandwidth (PayByBandwidth) method.
  • When the outbound public bandwidth is upgraded from 0 Mbit/s, a public IP address is automatically allocated.
  • You can use the ModifyInstanceNetworkSpec operation to change the network billing method from pay-by-data-transfer (PayByTraffic) to pay-by-bandwidth (PayByBandwidth). To change the network billing method from pay-by-bandwidth (PayByBandwidth) to pay-by-data-transfer (PayByTraffic), you can use only the ECS console.
• When modifying the bandwidth configurations of a pay-as-you-go 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 automatically 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-data-transfer (PayByTraffic) to pay-by-bandwidth (PayByBandwidth).
  • You can change the bandwidth billing method from pay-by-bandwidth (PayByBandwidth) to pay-by-data-transfer (PayByTraffic).
• For an instance in a classic network, when the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s, the instance must already 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 the public bandwidth of each subscription instance for a maximum of three times. 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 the modification of bandwidth configuration succeeds, you cannot modify the bandwidth of that instance within five minutes.

Request parameters

Response parameters

Examples

Sample requests

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

Sample success responses

XML format

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

JSON format

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

Error codes

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