本接口用于修改一臺按量付費ECS實例的實例規格或者公網帶寬大小。
接口說明
請確保在使用該接口前,已充分了解 ECS 產品的收費方式和價格。
更改按量付費實例規格前,您可以通過 DescribeResourcesModification 查詢當前實例支持變配的實例規格。
注意事項
- 賬號必須處于無欠費狀態。
- 每次調用只能修改單項配置,即單次只能修改實例規格,或者只能調整公網帶寬大小。
- 實例狀態必須為運行中(
Running
)或者已停止(Stopped
)時才能調節公網帶寬大小,修改后立即生效。 - 實例狀態必須為已停止(
Stopped
)時才能修改實例規格,修改后需要啟動實例后生效。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ecs:ModifyInstanceSpec | update | *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 指定的實例 ID。 | i-bp67acfmxazb4p**** |
InstanceType | string | 否 | 實例的目標規格。更多信息,請參見實例規格族,也可以調用 DescribeInstanceTypes 接口獲得最新的規格表。 | ecs.g6.large |
InternetMaxBandwidthOut | integer | 否 | 公網出帶寬最大值,單位為 Mbit/s(Megabit per second)。取值范圍:0~100。 說明
按使用流量計費模式下的出入帶寬峰值都是帶寬上限,不作為業務承諾指標。當出現資源爭搶時,帶寬峰值可能會受到限制。如果您的業務需要有帶寬的保障,請使用按固定帶寬計費模式。
| 10 |
InternetMaxBandwidthIn | integer | 否 | 公網入帶寬最大值,單位為 Mbit/s(Megabit per second)。取值范圍:
說明
按使用流量計費模式下的出入帶寬峰值都是帶寬上限,不作為業務承諾指標。當出現資源爭搶時,帶寬峰值可能會受到限制。如果您的業務需要有帶寬的保障,請使用按固定帶寬計費模式。
| 10 |
Temporary.StartTime | string | 否 | 說明
該參數正在邀測中,暫未開放使用。
| null |
Temporary.EndTime | string | 否 | 說明
該參數正在邀測中,暫未開放使用。
| null |
Temporary.InternetMaxBandwidthOut | integer | 否 | 說明
該參數正在邀測中,暫未開放使用。
| null |
Async | boolean | 否 | 是否提交異步請求。取值范圍:
默認值:false。 | false |
AllowMigrateAcrossZone | boolean | 否 | 是否支持跨集群升級實例規格。
默認值:false。 當參數 經典網絡類型實例:
專有網絡 VPC 類型實例:對于已停售的實例規格,非 I/O 優化實例變配到 I/O 優化實例時,云服務器磁盤設備名和軟件授權碼會發生變化。Linux 實例的普通云盤( | false |
SystemDisk.Category | string | 否 | 更換系統盤類型。取值范圍:
說明
該參數只有在從已停售的實例規格升級到正常售賣的實例規格族,并將非 I/O 優化實例規格升級為 I/O 優化實例規格時有效。
| cloud_ssd |
ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符,且不能超過 64 個字符。更多信息,請參見如何保證冪等性。 | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
ModifyMode | string | 否 | 說明
該參數暫未開放使用。
| null |
Disk | array<object> | 否 | 說明
該參數暫未開放使用。
| |
object | 否 | 說明
該參數暫未開放使用。
| ||
DiskId | string | 否 | 說明
該參數暫未開放使用。
| null |
Category | string | 否 | 說明
該參數暫未開放使用。
| null |
PerformanceLevel | string | 否 | 說明
該參數暫未開放使用。
| null |
DryRun | boolean | 否 | 是否只預檢此次請求。取值范圍:
| false |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidInternetChargeType.ValueNotSupported | The specified InternetChargeType is not valid. | 暫不支持指定的網絡付費類型的實例,請確認相關參數是否正確。 |
400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType does not exist or beyond the permitted range. | 您指定的實例規格不存在,或者您沒有權限操作此規格的實例。 |
400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType is not authorized. | 指定的實例規格未授權使用。 |
400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 您指定的實例規格不存在,或者您沒有權限操作此規格的實例。 |
400 | InvalidParameter | The specified parameter "InternetMaxBandwidthOut" is not valid. | - |
400 | InvalidParameter.Mismatch | Too many parameters in one request. | 請求中包含的參數過多。 |
400 | BandwidthUpgradeDenied.EipBoundInstance | The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied. | 該實例已經綁定 EIP,不能進行臨時升級。 |
400 | InvalidTemporary.StartTime | The specifed Temporary.StartTime is not valid. | 指定的臨時升級開始時間無效。 |
400 | InvalidTemporary.EndTime | The specifed Temporary.EndTime is not valid. | 指定的臨時升級結束時間無效。 |
400 | Downgrade.NotSupported | Downgrade operation is not supported. | 不支持降配。 |
400 | DependencyViolation.InstanceType | The current InstanceType cannot be changed to the specified InstanceType. | 當前實例的規格不能變更到指定的規格。 |
400 | Account.Arrearage | Your account has an outstanding payment. | 您的賬號存在未支付的款項。 |
400 | InvalidParameter.Bandwidth | The specified parameter Bandwidth is not valid. | 指定的 Bandwidth 不合法。 |
400 | InvalidParameter.Conflict | The specified image does not support the specified instance type. | 指定的鏡像不能用于指定的實例規格。 |
400 | InvalidParameter.AllowMigrateAcrossZone | The specified parameter CanMigrateAcrossZone is not valid. | 指定的參數 CanMigrateAcrossZone 無效。 |
400 | InvalidParam.SystemDiskCategory | The specified param SystemDisk.Category is not valid. | 指定的系統盤類型參數無效。 |
400 | Throttling | Request was denied due to request throttling, please try again after 5 minutes. | 您當前的請求被流控,請5分鐘后重試。 |
400 | InvalidInstanceStatus.NotStopped | The specified Instance status is not stopped. | 指定實例的狀態不是已停止。 |
400 | InvalidAction | Specified action is not valid. | 該操作無效。 |
400 | IdempotenceParamNotMatch | There is a idempotence signature mismatch between this and last request. | 該請求與上一個請求的 ClientToken 參數一致,但其它請求參數不一致。 |
400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | 指定的 ClientToken 不合法。 |
400 | Price.PricePlanResultNotFound | The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid. | 提供的 internetMaxBandwidthIn 或 internetMaxBandwidthOut 無效。 |
400 | InvalidAction.NotSupport | The ecs on dedicatedHost not support modify instanceType. | 專用宿主機上的實例不支持變更實例規格。 |
400 | InvalidMarketImageStatus.NotSupported | The status of specified market image does not support this operation. | 指定的市場鏡像的狀態不支持該操作。 |
400 | InvalidOperation.VpcHasEnabledAdvancedNetworkFeature | The specified vpc has enabled advanced network feature. | 該VPC開啟了高階特性,不能創建低規格的ECS。 |
400 | Invalid.PrivatePoolOptions.MatchCriteria | Target mode does not support this operation. | Target模式不支持本次操作。 |
400 | InstanceTypeNotSupported.TooManyDisksAttached | %s | - |
400 | InvalidDiskCategory.NotSupported | The upgrade operation of instance does not support this category of disk. | 實例的升級操作不支持此類磁盤。 |
400 | InvalidParameter.CloudboxNotSupported | %s | - |
400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | 指定磁盤類型的已用容量超出可用區配額限制,您可以前往配額中心查詢和申請提升磁盤容量配額。 |
400 | InvalidParam.Async | The specified parameter async is not valid. | Async參數不合法。 |
400 | MissingParameter.DiskCategory | The specified parameter Disk.Category can not be null when Disk.DiskId is specified. | - |
400 | InvalidParameter.DiskCategory | The specified parameter Disk.Category is not valid. | - |
400 | InvalidPerformanceLevel.Malformed | The specified parameter Disk.n.PerformanceLevel is not valid. | - |
400 | NoPermission.Price | The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true. | - |
400 | InvalidParameter.DedicatedRegionNotSupported | The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP. | 專屬云地域不支持的參數錯誤碼 |
400 | InvalidOperation.OnlineModificationUnsupported | Online modification of instance type is not supported for the specified instance due to its CPU topology. | 當前CPU拓撲類型不支持熱變配 |
400 | QuotaExceeded.InternetBandwidth | %s. | 您當前賬號下,按量付費ECS實例的按固定帶寬計費公網帶寬超過了總帶寬配額限制。 |
403 | CategoryViolation | The specified instance does not support this operation because of its disk category. | 掛載有本地磁盤的實例不支持升降配。 |
403 | InvalidStatus.ValueNotSupported | The current status of the resource does not support this operation. | 當前資源的狀態不支持此操作。 |
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 | ChargeTypeViolation | The operation is not permitted due to charge type of the instance. | 付費方式不支持該操作,請您檢查實例的付費類型是否與該操作沖突。 |
403 | OperationDenied | The specified instance is out of usage. | 指定的實例庫存不足。 |
403 | LastTokenProcessing | The last token request is processing. | 正在處理上一條令牌請求,請您稍后再試。 |
403 | InvalidInstance.UnpaidOrder | The specified instance has unpaid order. | 指定的實例有未支付的訂單,請您先支付再進行操作。 |
403 | InstanceSpecModification.NotEffective | The specified instance has been reserved for making a spec modification and not taken effective in the current contract period. | 指定的實例因規格調整被保留,在當前合同期內無法生效。 |
403 | InvalidInstanceType.ValueNotSupported | The specified zone does not offer the specified instancetype. | 指定的區域不提供此類型的實例。 |
403 | ImageNotSupportInstanceType | The specified image do not support the InstanceType instance. | 指定的鏡像不支持此類實例規格。 |
403 | InstanceType.Offline | The specified InstanceType has been offline. | - |
403 | InvalidParameter.NotMatch | %s | 您輸入的參數無效,請檢查參數之間是否沖突。 |
403 | InvalidInstance.EipNotSupport | The specified instance with eip is not supported, please unassociate eip first. | 已綁定 EIP 的實例不支持該操作,請先解綁此EIP。 |
403 | InvalidInstance.NatPortMapNotSupport | The special instance with nat port map not support operate, please remove nat port map first. | - |
403 | InvalidOperation.StarterPackage | StarterPackage not support modification. | - |
403 | OperationDenied.NoStock | The resource is out of usage. | 該實例不在運行狀態,請您啟動實例或檢查操作是否合理。 |
403 | OperationDenied.UnpaidOrder | The specified instance has unpaid order. | 指定的實例ID已存在未支付訂單,您可以登錄ECS管理控制臺支付。 |
403 | OperationDenied | %s | 拒絕操作。 |
403 | InvalidOperation.EipNotSupport | The special instance with eip not support operate, please unassociate eip first. | - |
403 | InvalidParameter.InternetMaxBandwidthOut | The specified parameter InternetMaxBandwidthOut is invalid. | - |
403 | InvalidOperation.EniCountExceeded | %s | - |
403 | InvalidOperation.Ipv4CountExceeded | %s | IPv4 數量達到上限,導致該操作無效。 |
403 | InvalidOperation.Ipv6CountExceeded | %s | IPv6 數量達到上限,導致該操作無效。 |
403 | InvalidOperation.Ipv6NotSupport | %s | IPv6不支持當前操作。 |
403 | InvalidOperation.Ipv4NotSupport | %s | - |
403 | InvalidOperation.InstanceWithEipNotSupport | The special instance with eip not support operate, please unassociate eip first. | 已綁定 EIP 的實例不支持該操作,請優先解綁 EIP。 |
403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | 我們檢測到您的默認信用卡或借記卡存在安全風險。請通過電子郵件中的鏈接進行驗證。 |
403 | InvalidInstance.NotFoundSystemDisk | The specified instance has no system disk. | 指定的實例沒有掛載系統盤。請確保指定的實例已掛載了系統盤。您可以調用 DescribeInstances 查詢指定實例的信息。 |
403 | InvalidInstanceType.NotSupportDiskCategory | The instanceType of the specified instance does not support this disk category. | 指定的實例規格(InstanceType)不支持當前實例的云盤類別。請嘗試更換其它實例規格。關于實例規格支持的云盤類型,請參見實例規格族文檔。 |
403 | QuotaExceed.ElasticQuota | No additional quota is available for the specified ECS instance type. | 您在當前地域選擇的實例規格所要創建的臺數超出系統限額,您可以選擇其他地域、實例規格或減少臺數重新購買,也可以前往ECS管理控制臺或配額中心申請提高限額。 |
403 | QuotaExceed.ElasticQuota | The number of the specified ECS instances has exceeded the quota of the specified instance type. | 您在當前地域選擇的實例規格所要創建的臺數超出系統限額,您可以選擇其他地域、實例規格或減少臺數重新購買,也可以前往ECS管理控制臺或配額中心申請提高限額。 |
403 | QuotaExceed.ElasticQuota | The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone. | 您的全實例規格vCPU配額超出系統限額,您可以前往ECS管理控制臺或配額中心申請提高限額。 |
403 | QuotaExceed.ElasticQuota | The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone. | 您在當前地域選擇的實例規格所要創建的臺數超出系統限額,或者全實例規格vCPU配額超出系統限額,您可以前往ECS管理控制臺或配額中心申請提高限額。 |
403 | InvalidResourceType.NotSupported | %s | - |
403 | InvalidOperation.NotAllowed | The specified vpc %s has enabled senior network feature. | - |
403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | 不支持本次操作。具體信息請參見錯誤信息%s占位符的實際返回值。 |
403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | 彈性網卡隊列數超過上限,具體信息請參見錯誤信息%s占位符的實際返回結果。 |
403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | 彈性網卡隊列總數超過上限,具體信息請參見錯誤信息%s占位符的實際返回結果。 |
403 | InvalidParameter.InvalidEniQueueNumber | %s | 彈性網卡隊列數有誤,具體信息請參見錯誤信息%s占位符的實際返回結果。 |
403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | 不符合開啟休眠選項的實例的相關限制,操作不被允許。 |
403 | InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode | %s | - |
403 | InvalidOperation.EniQueuePairNumberOverflow | %s | - |
403 | InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded | %s | - |
403 | InvalidOperation.MaxEniQueuePairNumberExceed | %s | - |
403 | InvalidOperation.MaxModifyOnlineNumberExceeded | The specified instance has reached the maximum number of modify online attempts and needs to be rebooted. | - |
403 | InvalidOperation.RebootingRequired | The specified instance needs to be rebooted. | - |
403 | InvalidOperation.OSTypeNotSupported | The specified OS type is not supported. | - |
403 | InvalidSystemDiskCategory.ValueNotSupported | The specified parameter SystemDisk.Category is not valid. | 指定的 SystemDisk.Category 值不受支持。 |
403 | InvalidDataDiskCategory.ValueNotSupported | The specified Category of Data Disk is not valid. | 指定的數據盤磁盤類型不支持 |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
404 | MissingTemporary.StartTime | Temporary.StartTime is not specified. | 未指定臨時升級開始時間。 |
404 | MissingTemporary.EndTime | Temporary.EndTime is not specified. | 未指定臨時升級結束時間。 |
404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records. | 指定的實例計費方式不存在。 |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內部錯誤,請重試。 |
500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤,請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-09-27 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-02-01 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-12-14 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-10-10 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-08-30 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-05-08 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-04-07 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |