调用ModifyPrepayInstanceSpec升级或者降低一台包年包月ECS实例的实例规格，新实例规格将会覆盖实例的整个生命周期。
接口说明
请确保在使用该接口前，您已充分了解云服务器ECS的计费方式、产品定价以及降配退款规则。
升级或者降低包年包月实例规格前，您可以通过DescribeResourcesModification查询当前实例支持变配的实例规格。详情请参见Python SDK示例查询ECS变配的可用资源实践。
调用该接口时，您需要注意：
- 已过期实例无法修改实例规格，您可以续费后重新操作。
- 降低实例规格时，您需要注意：
- 实例必须处于已停止（
Stopped）状态。 - 降低前后的实例规格价格差退款会退还到您的原付费方式中，已使用的代金券不退回。
- 实例必须处于已停止（
- 本接口属于异步操作，等待约5~10秒后配置变更完成。随后，您必须调用API或者在控制台重启一次实例，否则规格变更不会生效，重启操作系统无效。
- 若实例处于已停止状态，仅需启动实例，无需重启。
- 若实例设置了
RebootWhenFinished=true，则无需单独重启。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | ModifyPrepayInstanceSpec |
系统规定参数。取值：ModifyPrepayInstanceSpec。 |
| InstanceId | String | 是 | i-bp67acfmxazb4ph**** |
实例ID。 |
| RegionId | String | 是 | cn-hangzhou |
实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| InstanceType | String | 是 | ecs.g5.xlarge |
需要变配的目标实例规格。取值请参见实例规格族或者调用DescribeInstanceTypes。 |
| OperatorType | String | 否 | upgrade |
操作类型。取值范围： 说明 该参数可无需上传，系统可自动判断升配还是降配；如要上传，请按照下面的逻辑规则操作。
说明 升级或降低实例规格的注意事项请参见上文接口说明章节。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。 |
| AutoPay | Boolean | 否 | true |
升级实例规格时，是否自动支付。取值范围：
默认值：true。 当参数 |
| MigrateAcrossZone | Boolean | 否 | false |
是否支持跨集群升级实例规格。取值范围：
默认值：false。 当参数 经典网络类型实例：
专有网络VPC类型实例：对于已停售的实例规格，非I/O优化实例变配到I/O优化实例时，云服务器磁盘设备名和软件授权码会发生变化。Linux实例的普通云盘（cloud）会被识别为xvda或者xvdb等，高效云盘（cloud_efficiency）和SSD云盘（cloud_ssd）会被识别为vda或者vdb等。 |
| SystemDisk.Category | String | 否 | cloud_efficiency |
更换系统盘类型。取值范围：
|
| RebootTime | String | 否 | 2018-01-01T12:05Z |
实例的重启时间。按照ISO 8601标准表示，使用UTC+0时间。格式为：yyyy-MM-ddTHH:mmZ。 |
| EndTime | String | 否 | 2018-01-01T12:05Z |
临时变更的终止时间。按照ISO 8601标准表示，使用UTC+0时间。格式为：yyyy-MM-ddTHH:mmZ。 |
| RebootWhenFinished | Boolean | 否 | false |
实例变配结束后是否立即重启。取值范围：
默认值为false。 说明 若实例处于停止中状态，即使您设置了 |
| ModifyMode | String | 否 | null | 说明 该参数暂未开放使用。 |
| Disk.N.DiskId | String | 否 | null | 说明 该参数暂未开放使用。 |
| Disk.N.Category | String | 否 | null | 说明 该参数暂未开放使用。 |
| Disk.N.PerformanceLevel | String | 否 | null | 说明 该参数暂未开放使用。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| OrderId | String | 1234567890 |
生成的订单ID。 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyPrepayInstanceSpec
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph****
&InstanceType=ecs.g5.xlarge
&AutoPay=true
&OperatorType=upgrade
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
04F0F334-1335-436C-A1D7-6C044FE73368
1234567890
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
"OrderId" : "1234567890"
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType is not authorized. | 指定的实例规格未授权使用。 |
| 400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 您指定的实例规格不存在，或者您没有权限操作此规格的实例。 |
| 400 | InvalidBillingMethod.ValueNotSupported | The operation is not permitted due to an invalid billing method of the instance. | 由于实例的计费方式无效，该操作不允许。 |
| 400 | InvalidInstance.PurchaseNotFound | The specified instance has no purchase history. | 该实例的订购记录不存在。 |
| 400 | InvalidInstanceType.NotSupported | The specified InstanceType is not Supported. | 不支持指定的InstanceType。 |
| 400 | 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 | Account.Arrearage | Your account has an outstanding payment. | 您的账号存在未支付的款项。 |
| 400 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在，请您检查实例ID是否正确。 |
| 400 | InvalidRebootTime.MalFormed | The specified rebootTime is not valid. | 指定的 RebootTime 不合法。 |
| 400 | InvalidRebootTime.ValueNotSupported | The specified RebootTime is not valid. | 指定的重启时间不合法。 |
| 400 | IdempotenceParamNotMatch | Request uses a client token in a previous request but is not identical to that request. | 与相同 ClientToken 的请求参数不符合。 |
| 400 | IdempotenceParamNotMatch | %s | 幂等参数不匹配。 |
| 400 | InvalidInstanceChargeType.ValueNotSupported | %s | 暂不支持此付款类型，请核对相关信息后重试。 |
| 400 | InvalidStatus.NotStopped | Instance status must be stopped. | 实例只有在已停止的状态下，才能进行此操作。 |
| 400 | InvalidAction | %s | 操作无效。 |
| 400 | InstanceDowngrade.QuotaExceed | Quota of instance downgrade is exceed. | 您的实例降配已超额度，无法进行此操作。 |
| 400 | InvalidInstanceType.ValueNotSupported | %s | 该操作暂不支持指定的实例类型。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 400 | OperationDenied | The current user does not support this operation. | 您使用的账号暂不支持此操作。 |
| 400 | LastOrderProcessing | The previous order is still processing, please try again later. | 订单正在处理中，稍后重试。 |
| 400 | InvalidOperation.VpcHasEnabledAdvancedNetworkFeature | The specified vpc has enabled advanced network feature. | 该VPC开启了高阶特性，不能创建低规格的ECS。 |
| 400 | InvalidAction.WithActiveElasticUpgrade | The instance has active Elastic Upgrade. | 指定的实例为临时升级中（即调用ModifyPrepayInstanceSpec时设置了EndTime参数）的实例，暂不支持查询。 |
| 400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | 指定磁盘类型的已用容量超出可用区配额限制，您可以前往配额中心查询和申请提升磁盘容量配额。 |
| 400 | QuotaExceed.RufundVcpu | The maximum number of refunded vcpu is exceeded: %s . | 退款规则中vCPU配额超过了最大数量限制，具体限制请参见错误信息中%s占位符的实际信息。 |
| 400 | InvalidInstanceStatus | The current status of the instance does not support this operation. | 当前实例的状态不支持此操作。 |
| 400 | InvalidOperation.InstanceRenewWithDowngradeInPlan | The operation is denied due to the specified instance has renew with downgrade record in plan. | 存在未生效的续费降配订单。订单生效前不允许此操作。 |
| 403 | OperationDenied.NoStock | The specified instance is out of usage. | 指定的实例库存不足。 |
| 403 | InvalidUser.PassRoleForbidden | The RAM user does not have privilege to pass a role. | RAM子账号不具备授予ECS RAM角色的权限。 |
| 403 | ImageNotSupportInstanceType | The specified image does not support the specified InstanceType. | 指定的镜像不支持指定的实例规格。 |
| 403 | InstanceType.Offline | %s | 实例规格因停售、供货不足等原因，不支持该操作。 |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 该资源目前的状态不支持此操作。 |
| 403 | InvalidParameter.InstanceId | %s | 指定的参数 InstanceId 无效。 |
| 403 | OperationDenied | %s | 拒绝操作。 |
| 403 | ImageNotSupportInstanceType | The specified instanceType is not supported by instance with marketplace image. | 指定的市场镜像不支持该实例规格。 |
| 403 | InvalidInstance.EipNotSupport | The special instance with eip not support operate, please unassociate eip first. | 已绑定 EIP 的实例不支持该操作，请优先解绑EIP。 |
| 403 | OperationDenied.LocalDiskUnsupported | The configuration change is not allowed when the specified instance has local disks mounted. | 实例挂载本地盘后不支持规格变配。 |
| 403 | OperationDenied.NoStock | The resource is out of stock in the specified zone. Please try other types, or choose other regions and zones. | 指定的资源在指定可用区中无货。请尝试其他类型，或选择其他可用区和地域。 |
| 403 | InvalidOperation.Ipv4CountExceeded | %s | IPv4 数量达到上限，导致该操作无效。 |
| 403 | InvalidOperation.Ipv6CountExceeded | %s | IPv6 数量达到上限，导致该操作无效。 |
| 403 | InvalidOperation.Ipv6NotSupport | %s | IPv6不支持当前操作。 |
| 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 | 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 | OperationDenied.UnpaidOrder | The specified instance has unpaid order. | 指定的实例ID已存在未支付订单，您可以登录ECS管理控制台支付。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
| 404 | BillingMethodNotFound | The account has not chosen any billing method. | 该阿里云账号没有选择任何计费方法。 |
| 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. | 内部错误，请重试。 |
| 500 | ImageOrderFailed | Create marketplace image order failed. | 创建云市场订单失败，请提交工单处理。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/152822.html
