全部产品
云服务器 ECS

RenewInstance

更新时间:2017-09-13 09:26:21   分享:   

描述

  • 该API只对包月ECS实例生效,否则则报错。

  • 若实例付费类型为预付费的包年包月实例(PrePaid),则在执行付款时默认会使用该账号下可用的优惠券(0折账号除外)。

  • 该API要求用户必须支持账号的余额支付或信用支付。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:RenewInstance。
InstanceId String 指定的需要实例规格的实例ID。
Period Integer 预付费续费时长,单位是月。
取值范围为:
  • 1 - 9
  • 12
  • 24
  • 36
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http状态码 语义
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以外的字符。
InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records. 400 指定的 InstanceChargeType 不存在。
InvalidInstanceType.codeUnauthorized The specified InstanceType is not authorized. 400 指定的InstanceType未授权使用。
InvalidInstanceType.NotSupported The specified InstanceType is not Supported. 400 指定的InstanceType不支持。
InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range. 400 指定的InstanceType不合法(超出可选范围)。
InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. 400 指定的InstanceType未授权使用。
InvalidInternetChargeType.InstanceNotSupported The specified instance which is in vpc is not support the parameter InternetChargeType. 400 VPC实例不支持InternetChargeType。
InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. 400 指定的InternetChargeType不存在。
InvalidParameter The specified parameter “InternetMaxBandwidthOut” is not valid. 400 指定的InternetMaxBandwidthOut不合法(不是数字或超出范围)。
InvalidPeriod The specified period is not valid. 400 指定的 period 参数格式不合法(不是数字或超出范围)。
InvalidRebootTime.Malformed The specified RebootTime is not valid. 400 指定的RebootTime不合法。
InvalidRebootTime.ValueNotSupported The specified RebootTime is out of the permitted range. 400 指定的RebootTime超出范围。
OperationDenied Specified instance is in VPC. 400 指定实例在VPC中。
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 付费方式不支持这个操作。
Diskcategory.Mismatch The disk specified to convert to portable is not allowed due to the disk category does not support. 403 指定的磁盘类型不支持转换为可卸载磁盘。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 该资源目前的状态不支持此操作。
Instance.UnPaidOrder The specified instance has unpaid order. 403 该实例下还有未付费的订单。
InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 403 该资源目前被安全锁定被拒绝操作。
InstanceTypeNotSupported The specified zone does not offer the specified instancetype. 403 指定zone不支持指定的实例类型。
InvalidDisk.NotAllowed The specified disk is not allowed to be converted to portable. 403 指定的磁盘不允许转换为可卸载磁盘。
LastTokenProcessing The last token request is processing. 403 上一次请求还在处理中。
InvalidDiskId.NotFound The specified disk does not exist. 404 指定的磁盘不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的InstanceId不存在。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=RenewInstance
  2. &InstanceId=i-instance1
  3. &Period=1
  4. &<公共请求参数>

返回示例

XML格式

  1. <ModifyInstanceSpecResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ModifyInstanceSpecResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?