全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
云服务器 ECS

ModifyInstanceSpec

更新时间:2017-10-10 09:54:20

描述

修改按量付费实例配置,支持调整后付费实例(PostPaid)的实例规格、带宽大小,单次只能升级单项配置。在使用这个接口的时候,需要注意以下几点:

  • 实例状态为正常业务状态(运行中、已停止)且无欠费的情况下才能进行变更配置的操作,当对实例规格进行变更时实例必须处于停止状态。
  • 单个实例每成功操作一次,5 分钟内不能继续操作。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:ModifyInstanceSpec
InstanceId String 指定的实例 ID。
InstanceType String 实例规格。取值参考文档实例规格族,也可以通过 DescribeInstanceTypeFamilies 获得最新的规格族详情。
InternetMaxBandwidthOut Integer 公网出带宽最大值,单位为 Mbps (Megabit per second)。取值范围:
  • 按带宽计费:[0, 200]
  • 按流量计费:[0, 200]
InternetMaxBandwidthIn Integer 公网入带宽最大值,单位为 Mbps (Megabit per second)。取值范围:
  • 按带宽计费:[1, 100]
  • 按流量计费:[1, 100]
您可以提交工单申请将带宽范围设置成 [0, 200] Mbps。
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
RequestId String 唯一请求 ID

错误码

错误代码 描述 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 该实例处于专有网络(VPC)状态。
Price.PricePlanResultNotFound The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid. 400 公网入带宽或公网出带宽传入参数不合法。
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 当前操作无效。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceSpec
  2. &InstanceId=i-xxxxx1
  3. &InstanceType=ecs.s1.large
  4. &InternetMaxBandwidthOut=10
  5. &InternetMaxBandwidthIn=100
  6. &ClientToken=xxxxxxxxx
  7. &<公共请求参数>

返回示例

XML格式

  1. <ModifyInstanceSpec>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. </ModifyInstanceSpec>

JSON格式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  3. }
本文导读目录