修改執行個體的頻寬配置。當執行個體現有網路規格不滿足要求時,可以通過修改執行個體的頻寬配置提高網路效能。
描述
調用該介面時,您需要注意:
-
修改 訂用帳戶(
PrePaid
)執行個體的頻寬配置時:-
可以升級或者降配計費方式為 按使用流量(
PayByTraffic
)的頻寬。 -
公網出頻寬(
InternetMaxBandwidthOut
)從 0 Mbps 升級到一個非零值時會自動分配一個公網 IP。
-
-
修改 隨用隨付(
PostPaid
)執行個體的頻寬配置時:-
可以升級或者降配頻寬。
-
公網出頻寬(
InternetMaxBandwidthOut
)從 0 Mbps 升級到一個非零值時不會自動分配公網 IP,您需要調用 AllocatePublicIpAddress 為執行個體分配公網 IP。
-
-
對於經典網路(Classic)類型執行個體,當 公網出頻寬(
InternetMaxBandwidthOut
)從 0 Mbps 升級到一個非零值時,執行個體必須處於 已停止(Stopped
)狀態。 -
升級頻寬後,預設自動扣費,您需要確保賬戶餘額充足,如果賬戶餘額不足會生成異常訂單,此訂單暫時不支援通過 ECS 控制台支付,只能作廢。
如果您的賬戶餘額不足,可以將參數
AutoPay
置為false
,即取消自動支付,此時調用該介面會生成正常的未支付訂單,此訂單可登入 ECS 控制台 支付。 -
單個執行個體每成功操作一次,5分鐘內不能繼續操作。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:ModifyInstanceNetworkSpec |
InstanceId | String | 是 | 需要修改網路設定的執行個體 ID。 |
InternetMaxBandwidthOut | Integer | 否 | 公網出頻寬最大值,單位為 Mbps(Megabit per second)。取值範圍:[0, 100] |
InternetMaxBandwidthIn | Integer | 否 | 設定公網入頻寬最大值,單位為 Mbps(Megabit per second)。取值範圍:[1, 200] |
NetworkChargeType | String | 否 | 轉換網路計費方式。取值範圍:
|
AutoPay | Boolean | 否 | 是否自動支付。取值範圍:
|
ClientToken | String | 否 | 用於保證請求的等冪性。由用戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性。 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
RequestId | String | 請求ID |
OrderId | Long | 生成的訂單ID |
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&RegionId=cn-hangzhou
&InstanceId=i-xxxxx1
&InternetMaxBandwidthOut=10
&ClientToken=xxxxxxxxxxxxxx
&<公共請求參數>
返回樣本
XML 格式
<ModifyInstanceNetworkSpecResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceNetworkSpecResponse>
JSON 格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
Account.Arrearage | Your account has an outstanding payment. | 400 | 帳號已經欠費。 |
DecreasedBandWidthNotAllowed | A higher bandwidth than the current one is required. | 400 | 新頻寬不能低於已有頻寬。 |
InvalidInstance.UnpaidOrder | The specified instance has unpaid order. | 400 | 當前執行個體有未支付的訂單。 |
InvalidInstanceStatus.NotStopped | The specified Instance status is not Stopped. | 400 | 執行個體未處於停止狀態。 |
InvalidInternetChargeType.ValueNotSupported | The specified InternetChargeType is invalid. | 400 | 指定的 InternetChargeType 不存在。 |
InvalidInternetMaxBandwidthIn.ValueNotSupported | The specified InternetMaxBandwidthIn is beyond the permitted range. | 400 | 指定的 InternetMaxBandwidthIn 超出取值範圍。 |
InvalidInternetMaxBandwidthOut.ValueNotSupported | The specified InternetMaxBandwidthOut is beyond the permitted range. | 400 | 指定的 InternetMaxBandwidthOut 超出取值範圍。 |
MissingParameter | The input parameter “InstanceId” that is mandatory for processing this request is not supplied. | 400 | 缺少 InstanceId 值 |
OperationDenied | Specified instance is in VPC. | 400 | VPC 網路執行個體不支援該操作。 |
ChargeTypeViolation | The operation is not permitted due to billing method of the instance. | 403 | 當前執行個體的付費類型不支援此操作。 |
IncorrectInstanceStatus | The current status of the instance does not support this operation. | 403 | 該執行個體目前的狀態不支援此操作。 |
InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 403 | 執行個體到期或者欠費(是指該執行個體是訂用帳戶或者按量欠費的情況)。 |
InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | 403 | 該執行個體目前被 安全控制,拒絕操作。 |
InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 403 | 賬戶餘額不足。 |
OperationDenied | The operation is denied due to the instance is PrePaid. | 403 | 訂用帳戶執行個體不支援此操作。 |
InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 404 | 指定的執行個體 ID 不存在。 |
InternalError | The request processing has failed due to some unknown error, exception or failure. | 500 | 內部錯誤,請稍後再試。 |