修改執行個體的頻寬配置。當執行個體現有網路規格不滿足要求時,可以通過修改執行個體的頻寬配置提高網路效能。

描述

調用該介面時,您需要注意:

  • 修改 訂用帳戶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 轉換網路計費方式。取值範圍:
  • PayByTraffic:按使用流量計費
AutoPay Boolean 是否自動支付。取值範圍:
  • true:變更頻寬配置後,自動扣費。當您將參數 Autopay 置為 True 時,您需要確保賬戶餘額充足,如果賬戶餘額不足會生成異常訂單,此訂單暫時不支援通過 ECS 控制台支付,只能作廢。
  • false:變更頻寬配置後,只生成訂單不扣費。如果您的賬戶餘額不足,可以將參數 AutoPay 置為 false,即取消自動支付,此時調用該介面會生成正常的未支付訂單,此訂單可登入 ECS 控制台 支付。
預設值:true
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 內部錯誤,請稍後再試。