升級或者降低預付費(訂用帳戶)執行個體規格。

描述

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

  • 執行個體必須處於 已停止Stopped)狀態。
  • 執行個體欠費時,無法修改執行個體規格。
  • 升級或者降低執行個體規格前,您可以通過 DescribeResourcesModification 查詢當前執行個體支援變配的執行個體規格。
  • 降低執行個體規格後,新執行個體規格將覆蓋執行個體的整個生命週期。您會收到降低前後的執行個體規格價格差退款,退還到您的原付款渠道中,已使用的代金券將不退回。
  • 單台執行個體每成功操作一次,五分鐘內不能繼續操作。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ModifyPrepayInstanceSpec
InstanceId String 執行個體ID。
RegionId String 執行個體所屬的地域ID。您可以調用DescribeRegions查看最新的阿里雲地域列表。
InstanceType String 需要變配的目標執行個體規格。更多詳情,請參閱 執行個體規格類型系列,也可以調用 DescribeInstanceTypes介面獲得最新的規格表。
OperatorType String 操作類型。取值範圍:
  • upgrade:升級執行個體規格
  • downgrade:降配執行個體規格

預設值:upgrade

當參數OperatorType被置為upgrade時,請確保您的賬戶餘額充足。

AutoPay Boolean 是否自動支付。取值範圍:
  • true:自動支付。您需要確保賬戶餘額充足,如果賬戶餘額不足會生成異常訂單,只能作廢訂單。
  • false:只生成訂單不扣費。如果您的賬戶餘額不足,會生成正常的未支付訂單,此訂單可登入 ECS管理主控台 支付。
預設值:true

當參數OperatorType被置為downgrade時,將忽略參數AutoPay

SystemDisk.Category String 更換系統盤類型。該參數只有在從 已停售的執行個體規格 升級到 正常售賣的執行個體規格類型系列,並將非I/O優化執行個體規格升級為I/O優化執行個體規格時有效。取值範圍:
  • cloud_efficiency:高效雲端碟
  • cloud_ssd:SSD雲端碟
MigrateAcrossZone Boolean 是否支援跨叢集升級執行個體規格。

預設值:False

當參數MigrateAcrossZone取值為True時,一旦您根據返回資訊升級了雲伺服器,請留意以下注意事項:

  • 經典網路類型執行個體:
    • 對於 已停售的執行個體規格,非I/O優化執行個體變配到I/O優化執行個體時,執行個體私網IP地址、磁碟裝置名稱和軟體授權碼會發生變化。對於Linux執行個體,普通雲端碟(cloud)會被識別為xvda或者xvdb等,高效雲端碟(cloud_efficiency) 和 SSD雲端碟(cloud_ssd)會被識別為vda或者vdb等。
    • 對於正常售賣的執行個體規格類型系列,執行個體的私網IP地址會發生變化。
  • Virtual Private Cloud類型執行個體:

    對於 已停售的執行個體規格,非I/O優化執行個體變配到I/O優化執行個體時,雲伺服器磁碟裝置名稱和軟體授權碼會發生變化。Linux 執行個體的普通雲端碟(cloud)會被識別為xvda或者xvdb等,高效雲端碟(cloud_efficiency) 和SSD雲端碟(cloud_ssd)會被識別為vda或者vdb等。

ClientToken String

保證請求等冪性。從您的用戶端生成一個參數值,確保不同請求間該參數值唯一。只支援ASCII字元,且不能超過64個字元。更多詳情,請參閱 如何保證等冪性

返回參數

名稱 類型 描述
OrderId Long 生成的訂單ID

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ModifyPrepayInstanceSpec
&RegionId=cn-hangzhou
&InstanceId=i-xxxxx1
&InstanceType=ecs.s1.large
&AutoPay=true
&OperatorType=upgrade
&ClientToken=xxxxxxxxxxxxxx
&<公共請求參數>
返回樣本

XML格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
Account.Arrearage Your account has an outstanding payment. 400 賬戶已經欠費。
IdempotenceParamNotMatch Request uses a client token in a previous request but is not identical to that request. 400 與相同ClientToken的請求參數不符合。
InvalidBillingMethod.ValueNotSupported The operation is not permitted due to an invalid billing method of the instance. 400 執行個體付費類型不合法。
InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. 400 ClientToken參數值不合法,不能包含ASCII以外的字元。
InvalidInstance.UnpaidOrder The specified Instance has unpaid order. 400 當前執行個體有未支付的訂單。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 400 指定的執行個體ID不存在。
InvalidInstanceId.Released The specified Instance has been released. 400 指定執行個體已被釋放。
InvalidInstanceType.ValueNotSupported The specified InstanceType is not supported. 400 指定的InstanceType不合法(超出可選範圍)。
InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. 400 指定的InstanceType未授權使用。
MissingParameter.InstanceIdNotSupported The InstanceId should not be null. 400 InstanceId不能為空。
MissingParameter.RegionId The RegionId should not be null. 400 RegionId 不能為空。
OrderCreationFailed Order creation failed, please check your params and try it again later. 400 建立訂單失敗。
Throttling You have made too many requests within a short time; your request is denied due to request throttling. 400 操作過於頻繁。
ImageNotSupportInstanceType The specified image does not support the specified InstanceType. 403 指定鏡像不支援該執行個體類型。
InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. 403 賬戶餘額不足。
InvalidBillingMethod The specified billing method is invalid. 403 指定的付費類型不存在。
InvalidUser.PassRoleForbidden The RAM user does not have privilege to pass a role. 403 RAM使用者不具有PassRole的許可權,請聯繫主帳號 授權 PassRole許可權。
BillingMethodNotFound The account has not chosen any billing method. 404 該賬戶沒有選擇付款條件。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的RegionId不存在。
InternalError The request processing has failed due to some unknown error, exception or failure. 500 內部錯誤。