全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
云服务器 ECS

ModifyInstanceNetworkSpec

更新时间:2018-01-18 11:58:33

描述

修改实例的带宽配置。当实例现有网络规格不满足要求时,可以通过修改实例的带宽配置提高网络性能。调用该接口时,您需要注意:

  • 修改 包年包月PrePaid)实例的带宽配置时:

    • 可以升级或者降配计费方式为 按使用流量PayByTraffic)的带宽;
      只能升级计费方式为 按固定带宽PayByBandwidth)的带宽。

    • 公网出带宽InternetMaxBandwidthOut)从 0 Mbps 升级到一个非零值时会自动分配一个公网 IP。

    • 您可以通过该接口将带宽计费方式 按使用流量PayByTraffic)转换为 按固定带宽PayByBandwidth)。
      您只能通过 ECS 控制台 将带宽计费方式 按固定带宽PayByBandwidth)转换为 按使用流量PayByTraffic)。

  • 修改 按量付费PostPaid)实例的带宽配置时:

    • 可以升级或者降配带宽。

    • 公网出带宽InternetMaxBandwidthOut)从 0 Mbps 升级到一个非零值时不会自动分配公网 IP,您需要调用 AllocatePublicIpAddress 为实例分配公网 IP。

    • 支持将带宽计费方式 按使用流量PayByTraffic) 转换为 按固定带宽PayByBandwidth);
      支持将带宽计费方式 按固定带宽PayByBandwidth)转换为 按使用流量PayByTraffic)。

  • 对于经典网络(Classic)类型实例,当 公网出带宽InternetMaxBandwidthOut)从 0 Mbps 升级到一个非零值时,实例必须处于 已停止Stopped)状态。

  • 升级带宽后,默认自动扣费,您需要确保账户余额充足,如果账户余额不足会生成异常订单,此订单暂时不支持通过 ECS 控制台支付,只能作废。
    如果您的账户余额不足,可以将参数 AutoPay 置为 false,即取消自动支付,此时调用该接口会生成正常的未支付订单,此订单可登录 ECS 控制台 支付。

  • 单个实例每成功操作一次,5分钟内不能继续操作。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:ModifyInstanceNetworkSpec
InstanceId String 需要修改网络配置的实例 ID。
InternetMaxBandwidthOut Integer 公网出带宽最大值,单位为 Mbps(Megabit per second)。取值范围:
  • 按带宽计费:[0, 100]
  • 按流量计费:[0, 100]
InternetMaxBandwidthIn Integer 设置公网入带宽最大值,单位为 Mbps(Megabit per second)。取值范围:
  • 按带宽计费:[1, 200]
  • 按流量计费:[1, 200]
NetworkChargeType String 转换网络计费方式。取值范围:
  • PayByBandwidth:按固定带宽计费
  • PayByTraffic:按使用流量计费
AutoPay Boolean 是否自动支付。取值范围:
  • true:变更带宽配置后,自动扣费。当您将参数 Autopay 置为 True 时,您需要确保账户余额充足,如果账户余额不足会生成异常订单,此订单暂时不支持通过 ECS 控制台支付,只能作废。
  • false:变更带宽配置后,只生成订单不扣费。如果您的账户余额不足,可以将参数 AutoPay 置为 false,即取消自动支付,此时调用该接口会生成正常的未支付订单,此订单可登录 ECS 控制台 支付。
默认值:true
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
RequestId String 唯一请求ID
OrderId Long 生成的订单ID

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
  2. &RegionId=cn-hangzhou
  3. &InstanceId=i-xxxxx1
  4. &InternetMaxBandwidthOut=10
  5. &ClientToken=xxxxxxxxxxxxxx
  6. &<公共请求参数>

返回示例

XML 格式

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

JSON 格式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
  3. }

错误码

错误代码 错误信息 HTTP状态码 说明
Account.Arrearage Your account has an outstanding payment. 400 账号已经欠费。
DecreasedBandWidthNotAllowed A higher bandwidth than the current one is required. 400 新带宽不能低于已有带宽。
InvalidInstance.UnpaidOrder The specified instance has unpaid order. 400 当前实例有未支付的订单。
InvalidInstanceStatus.NotStopped The specified Instance status is not Stopped. 400 实例未处于停止状态。
InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is invalid. 400 指定的 InternetChargeType 不存在。
InvalidInternetMaxBandwidthIn.ValueNotSupported The specified InternetMaxBandwidthIn is beyond the permitted range. 400 指定的 InternetMaxBandwidthIn 超出取值范围。
InvalidInternetMaxBandwidthOut.ValueNotSupported The specified InternetMaxBandwidthOut is beyond the permitted range. 400 指定的 InternetMaxBandwidthOut 超出取值范围。
MissingParameter The input parameter “InstanceId” that is mandatory for processing this request is not supplied. 400 缺少 InstanceId 值
OperationDenied Specified instance is in VPC. 400 VPC 网络实例不支持该操作。
ChargeTypeViolation The operation is not permitted due to billing method of the instance. 403 当前实例的付费类型不支持此操作。
IncorrectInstanceStatus The current status of the instance does not support this operation. 403 该实例目前的状态不支持此操作。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 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 账户余额不足。
OperationDenied The operation is denied due to the instance is PrePaid. 403 包年包月实例不支持此操作。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例 ID 不存在。
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误,请稍后再试。
本文导读目录