調整一台 隨用隨付 執行個體的執行個體規格和公網頻寬大小。

描述

調用該介面時，您需要注意：

  • 執行個體必須處於無欠費狀態。
  • 執行個體狀態必須為 運行中（Running）或者 已停止（Stopped）時才能調節公網頻寬大小。
  • 升級或者降低 隨用隨付 執行個體規格前，您可以通過 DescribeResourcesModification 查詢當前執行個體支援變配的執行個體規格。
  • 執行個體狀態必須為 已停止（Stopped）時才能變更執行個體規格。
  • 單次只能升級單項配置，即單次只能修改執行個體規格，或者只能調整公網頻寬大小。
  • 單台執行個體每成功操作一次，5分鐘內不能繼續操作。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ModifyInstanceSpec
InstanceId String 是 指定的執行個體 ID。
InstanceType String 否 執行個體規格。更多詳情，請參閱 執行個體規格類型系列，也可以調用 DescribeInstanceTypes介面獲得最新的規格表。
InternetMaxBandwidthOut Integer 否 公網出頻寬最大值，單位為 Mbps (Megabit per second)。取值範圍：
  • 按使用流量計費：[0, 100]
InternetMaxBandwidthIn Integer 否 公網入頻寬最大值，單位為 Mbps (Megabit per second)。取值範圍：
  • 按使用流量計費：[1, 200]
ClientToken String 否 用於保證請求的等冪性。由用戶端生成該參數值，要保證在不同請求間唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱 如何保證等冪性。

返回參數

全是公共返回參數。參閱 公共返回參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ModifyInstanceSpec
&InstanceId=i-xxxxx1
&InstanceType=ecs.s1.large
&InternetMaxBandwidthOut=10
&InternetMaxBandwidthIn=100
&ClientToken=xxxxxxxxx
&<公共請求參數>
返回樣本

XML 格式

<ModifyInstanceSpecResponse>
   <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceSpecResponse>
JSON 格式 
{
   "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心 。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
Account.Arrearage Your account has an outstanding payment. 400 帳號已經欠費。
DependencyViolation.InstanceType The current InstanceType cannot be changed to the specified InstanceType. 400 當前執行個體規格不允許變更到指定的執行個體規格。
IdempotenceParamNotMatch Request uses a client token in a previous request but is not identical to that request. 400 與相同 ClientToken 的請求參數不符合。
InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. 400 ClientToken 參數值不合法，不能包含ASCII以外的字元。
InvalidInstance.UnpaidOrder The specified instance has unpaid order. 400 當前執行個體有未支付的訂單。
InvalidInstanceType.ValueNotSupported The specified InstanceType is not supported. 400 指定的 InstanceType 不合法（超出可選範圍）。
InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. 400 指定的 InstanceType 未授權使用。
InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. 400 指定的 InternetChargeType 不存在。
InvalidParameter The specified parameter InternetMaxBandwidthOut is not valid. 400 指定的 InternetMaxBandwidthOut 不合法（不是數字或超出取值範圍）。
InvalidParameter.Bandwidth The specified parameter Bandwidth is not valid. 400 指定的公網頻寬值不合法。
InvalidParameter.Conflict The specified image does not support the specified instance type. 400 指定執行個體的 InstanceType 不允許使用該鏡像。
InvalidParameter.Mismatch Too many parameters in one request. 400 請求參數過多。
InvalidStatus.ValueNotSupported The current status of the resource does not support this operation. 400 當前的執行個體狀態不支援此操作。
InvalidStatus.ValueNotSupported The instance cannot be modified in the specified status. 400 當前的執行個體狀態不支援此操作。
OperationDenied The specified instance is in VPC. 400 該執行個體的網路類型為專有網路。
Price.PricePlanResultNotFound The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid. 400 請求參數 InternetMaxBandwidthIn 或 InternetMaxBandwidthOut 不合法。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 操作過於頻繁。
InvalidInstanceStatus.NotStopped The specified Instance status is not stopped. 400 執行個體未處於停止狀態。
CategoryViolation The specified instance does not support this operation because of its disk category. 403 當前執行個體的磁碟類型不支援此操作。
ChargeTypeViolation The operation is not permitted due to charge type of the instance. 403 當前執行個體的付費類型不支援此操作。
ImageNotSupportInstanceType The specified image does not support the specified InstanceType. 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 賬戶餘額不足。
LastTokenProcessing The last token request is processing. 403 上一次請求還在處理中。
OperationDenied The instance is out of usage. 403 該執行個體庫存不足，請選擇其他執行個體。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。
InternalError The request processing has failed due to some unknown error, exception or failure. 500 內部錯誤。
InvalidAction The specified action is not valid. 500 當前操作無效。