Changes the instance type and public bandwidth of a pay-as-you-go Elastic Compute Service (ECS) instance.
Operation description
For information about how to use ECS SDK for Python to change resource configurations, see Query available resources for configuration changes.
Take note of the following items:
-
Make sure that you have no overdue payments in your account.
-
You can modify the public bandwidth of an instance only when the instance is in the Running (
Running
) or Stopped (Stopped
) state. -
Before you change the instance type of a pay-as-you-go instance, you can call the DescribeResourcesModification operation to query the instance types to which you can change.
-
You can change the instance type of an instance only when the instance is in the Stopped (
Stopped
) state. -
The instance type and the public bandwidth of an instance cannot be changed together.
-
As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy specified for your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
- Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
- Within a single region, the sum of actual maximum bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
InstanceId | string | Yes | The ID of the instance. | i-bp67acfmxazb4p**** |
InstanceType | string | No | The new instance type. For more information, see Overview of instance families or call the DescribeInstanceTypes operation to query the most recent list of instance types. | ecs.g6.large |
InternetMaxBandwidthOut | integer | No | The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100. Note
When the pay-by-traffic billing method for network usage is used, the maximum inbound and outbound bandwidths are used as the upper limits of bandwidths instead of guaranteed performance specifications. In scenarios where demand outstrips resource supplies, these maximum bandwidth values may not be reached. If you want guaranteed bandwidths for your instance, use the pay-by-bandwidth billing method for network usage.
| 10 |
InternetMaxBandwidthIn | integer | No | The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:
Note
When the pay-by-traffic billing method for network usage is used, the maximum inbound and outbound bandwidths are used as the upper limits of bandwidths instead of guaranteed performance specifications. In scenarios where demand outstrips resource supplies, these maximum bandwidth values may not be reached. If you want guaranteed bandwidths for your instance, use the pay-by-bandwidth billing method for network usage.
| 10 |
Temporary.StartTime | string | No | Note
This parameter is in invitational preview and is not publicly available.
| hide |
Temporary.EndTime | string | No | Note
This parameter is in invitational preview and is not publicly available.
| hide |
Temporary.InternetMaxBandwidthOut | integer | No | Note
This parameter is in invitational preview and is not publicly available.
| 0 |
Async | boolean | No | Specifies whether to submit an asynchronous request. Default value: false. | false |
AllowMigrateAcrossZone | boolean | No | Specifies whether to support cross-cluster instance type upgrades. Default value: false. When Instances of the classic network type:
Instances of the Virtual Private Cloud (VPC) type: For retired instance types, if a non-I/O-optimized instance is upgraded to an I/O-optimized instance, the disk device names and software authorization codes of the instance change. For Linux instances, basic disks ( | false |
SystemDisk.Category | string | No | The new category of the system disk. This parameter is valid only when you upgrade an instance from a retired instance type to an available instance type or when you upgrade a non-I/O optimized instance to an I/O optimized instance. For more information, see Retired instance types and Overview of instance families. Valid values:
| cloud_ssd |
ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence. | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidInternetChargeType.ValueNotSupported | The specified InternetChargeType is not valid. | The specified InternetChargeType parameter is invalid. |
400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType does not exist or beyond the permitted range. | The specified instance type does not exist or you are not authorized to manage instances of this instance type. |
400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType is not authorized. | You are not authorized to use the specified instance type. |
400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | The specified instance type does not exist or you are not authorized to manage instances of this instance type. |
400 | InvalidParameter | The specified parameter "InternetMaxBandwidthOut" is not valid. | - |
400 | InvalidParameter.Mismatch | Too many parameters in one request. | The number of parameters contained in the request exceeds the upper limit. |
400 | BandwidthUpgradeDenied.EipBoundInstance | The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied. | The instance is associated with an EIP and cannot have its bandwidth temporarily upgraded. |
400 | InvalidTemporary.StartTime | The specifed Temporary.StartTime is not valid. | The specified start time of the temporary upgrade period is invalid. |
400 | InvalidTemporary.EndTime | The specifed Temporary.EndTime is not valid. | The specified end time of the temporary upgrade period is invalid. |
400 | Downgrade.NotSupported | Downgrade operation is not supported. | Configuration downgrades are not supported. |
400 | DependencyViolation.InstanceType | The current InstanceType cannot be changed to the specified InstanceType. | - |
400 | Account.Arrearage | Your account has an outstanding payment. | Your account has overdue payments. |
400 | InvalidParameter.Bandwidth | The specified parameter Bandwidth is not valid. | The specified bandwidth value is invalid. |
400 | InvalidParameter.Conflict | The specified image does not support the specified instance type. | The specified image cannot be used for instances of the specified instance type. |
400 | InvalidParameter.AllowMigrateAcrossZone | The specified parameter CanMigrateAcrossZone is not valid. | The specified AllowMigrateAcrossZone parameter is invalid. |
400 | InvalidParam.SystemDiskCategory | The specified param SystemDisk.Category is not valid. | The specified system disk category is invalid. |
400 | Throttling | Request was denied due to request throttling, please try again after 5 minutes. | - |
400 | InvalidInstanceStatus.NotStopped | The specified Instance status is not stopped. | The specified instance is not in the Stopped state. |
400 | InvalidAction | Specified action is not valid. | The operation is invalid. |
400 | IdempotenceParamNotMatch | There is a idempotence signature mismatch between this and last request. | This request and the previous request contain the same client token but different other parameters. |
400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | The specified ClientToken parameter is invalid. |
400 | Price.PricePlanResultNotFound | The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid. | The specified InternetMaxBandwidthIn or InternetMaxBandwidthOut parameter is invalid. |
400 | InvalidAction.NotSupport | The ecs on dedicatedHost not support modify instanceType. | Instance types cannot be changed for instances hosted on dedicated hosts. |
400 | InvalidMarketImageStatus.NotSupported | The status of specified market image does not support this operation. | The Alibaba Cloud Marketplace image is in a state that does not support the current operation. |
400 | InvalidOperation.VpcHasEnabledAdvancedNetworkFeature | The specified vpc has enabled advanced network feature. | Advanced features are enabled for the specified VPC. You cannot create low-specification instances in the VPC. |
400 | Invalid.PrivatePoolOptions.MatchCriteria | Target mode does not support this operation. | The operation is not supported while the PrivatePoolOptions.MatchCriteria parameter is set to 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. | The capacity of disks that belong to the specified disk category exceeds the quota limit for the zone. |
400 | InvalidParam.Async | The specified parameter async is not valid. | - |
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. | Parameter error codes not supported in the dedicated region |
403 | CategoryViolation | The specified instance does not support this operation because of its disk category. | The configurations of instances that have local disks attached cannot be upgraded or downgraded. |
403 | InvalidStatus.ValueNotSupported | The current status of the resource does not support this operation. | The resource is in a state that does not support the current 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. | Your account balance is insufficient. Add funds to your account and try again. |
403 | ChargeTypeViolation | The operation is not permitted due to charge type of the instance. | The operation is not supported while the instance is using the current billing method. |
403 | OperationDenied | The specified instance is out of usage. | The resources of the specified instance type are insufficient. |
403 | LastTokenProcessing | The last token request is processing. | A token request is being processed. Try again later. |
403 | InvalidInstance.UnpaidOrder | The specified instance has unpaid order. | The specified instance has a purchase order not paid for. |
403 | InstanceSpecModification.NotEffective | The specified instance has been reserved for making a spec modification and not taken effective in the current contract period. | The specified instance is retained due to the instance type change. The instance type change cannot take effect during the current contract period. |
403 | InvalidInstanceType.ValueNotSupported | The specified zone does not offer the specified instancetype. | The specified instance type is unavailable in the specified region. |
403 | ImageNotSupportInstanceType | The specified image do not support the InstanceType instance. | The specified image does not support the instance type. |
403 | InstanceType.Offline | The specified InstanceType has been offline. | - |
403 | InvalidParameter.NotMatch | %s | A specified parameter is invalid. Check whether parameter conflicts exist. |
403 | InvalidInstance.EipNotSupport | The specified instance with eip is not supported, please unassociate eip first. | The operation is not supported while an EIP is associated with the instance. Disassociate the EIP first. |
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. | The instance is not in the Running state. Start the instance or check whether the specified operation is valid. |
403 | OperationDenied.UnpaidOrder | The specified instance has unpaid order. | Your account has unpaid orders for the specified instance. You can log on to the ECS console to pay for the orders. |
403 | OperationDenied | %s | The operation is denied. |
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 | The operation is valid because the maximum number of IPv4 addresses has been reached. |
403 | InvalidOperation.Ipv6CountExceeded | %s | The operation is valid because the maximum number of IPv6 addresses has been reached. |
403 | InvalidOperation.Ipv6NotSupport | %s | - |
403 | InvalidOperation.Ipv4NotSupport | %s | - |
403 | InvalidOperation.InstanceWithEipNotSupport | The special instance with eip not support operate, please unassociate eip first. | The operation is not supported while an EIP is associated with the instance. Disassociate the EIP first. |
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. | The specified instance does not have a system disk. Make sure that the instance has a system disk. You can call the DescribeInstances operation to query the details of the instance. |
403 | InvalidInstanceType.NotSupportDiskCategory | The instanceType of the specified instance does not support this disk category. | The instance type does not support the current disk category. Try another instance type. For information about the disk categories supported by instance types, see the instance family documentation. |
403 | QuotaExceed.ElasticQuota | No additional quota is available for the specified ECS instance type. | The maximum number of instances of the specified instance type in the region has been reached. Reduce the quantity of instances that you want to purchase or try another region or instance type. Alternatively, you can go to the ECS console or Quota Center to request a quota increase. |
403 | QuotaExceed.ElasticQuota | The number of the specified ECS instances has exceeded the quota of the specified instance type. | The maximum number of instances of the specified instance type in the region has been reached. Reduce the quantity of instances that you want to purchase or try another region or instance type. Alternatively, you can go to the ECS console or Quota Center to request a quota increase. |
403 | QuotaExceed.ElasticQuota | The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone. | The maximum number of vCPUs for all instance types has been reached. You can go to the ECS console or Quota Center to request a quota increase. |
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. | The maximum number of instances of the specified instance type in the region has been reached, or the maximum number of vCPUs for all instance types has been reached. You can go to the ECS console or Quota Center to request a quota increase. |
403 | InvalidResourceType.NotSupported | %s | - |
403 | InvalidOperation.NotAllowed | The specified vpc %s has enabled senior network feature. | - |
403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | - |
403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | - |
403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | The maximum number of queues for all ENIs on an instance has been exceeded. For more information, see the return value of the %s placeholder in the error message. |
403 | InvalidParameter.InvalidEniQueueNumber | %s | - |
403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | The operation cannot be performed due to the limitations of instances for which the instance hibernation feature is enabled. |
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. | The specified SystemDisk.Category value is not supported. |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | The specified instance does not exist. |
404 | MissingTemporary.StartTime | Temporary.StartTime is not specified. | The start time of the temporary upgrade period must be specified. |
404 | MissingTemporary.EndTime | Temporary.EndTime is not specified. | The end time of the temporary upgrade period must be specified. |
404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records. | The specified instance billing method does not exist. |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | An internal error has occurred. Try again later. |
500 | InternalError | The request processing has failed due to some unknown error. | An internal error has occurred. Try again later. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2024-02-01 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-12-14 | The Error code has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-10-10 | The Error code has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-08-30 | The Error code has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-05-08 | The Error code has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-04-07 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||||||
|