RenewReservedInstances_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

请确保在使用该接口前,已充分了解预留实例券的收费方式和价格

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecs:RenewReservedInstances
Create
ReservedInstance
acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#ReservedInstanceId}

请求参数

字段名称字段详情
ReservedInstanceIdarray<string>

预留实例券 ID。

子级条数 <= 100子级条数 >= 1
RegionIdstring

预留实例券所属的地域 ID。展开详情

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
Periodinteger<int32>

购买预留实例券的时长。展开详情

示例值:1
PeriodUnitstring

购买预留实例券的时长单位。展开详情

示例值:Year
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性

示例值:123e4567-e89b-12d3-a456-426655440000
AutoRenewboolean

是否要自动续费。展开详情

示例值:true
AutoRenewPeriodinteger<int32>

每次自动续费的时长,单位为月。当参数 AutoRenew 取值为 true 时,该参数才生效。展开详情

示例值:1

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:8C314443-AF0D-4766-9562-C83B7F1****
ReservedInstanceIdSetsobject
OrderIdstring

订单 ID。

示例值:2023912123****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidInstanceType.ValueUnauthorized
The specified InstanceType is not authorized.诊断
400
InvalidParameter.Conflict
The specified region and cluster do not match.诊断
400
InvalidTagKey.Malformed
The specified Tag.n.Key is not valid.诊断
400
InvalidPeriodUnit.ValueNotSupported
The specified parameter PeriodUnit is not valid.诊断
400
InvalidTagValue.Malformed
The specified Tag.n.Value is not valid.诊断
400
InvalidChargeType.ValueNotSupported
ChargeType is not valid.诊断
400
OperationDenied
The specified InstanceType or Zone is not authorized for current user.诊断
400
InvalidPeriod
The specified Period or PeriodUnit is not correct.诊断
400
MissingParameter.ReservedInstanceIds
The specified ReservedInstanceIds does not exist.诊断
400
InvalidParameter.PeriodUnit
The specified PeriodUnit is invalid.诊断
400
InvalidParameter.Period
The specified Period is invalid.诊断
400
InvalidParameter.ReservedInstanceIds
The specified ReservedInstanceIds is invalid.诊断
400
InvalidPeriod.ExceededMaximumExpiration
The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.诊断
403
OperationDenied.NoStock
The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.诊断
403
OperationDenied
Sales of this resource are temporarily suspended in the specified region; please try again later.诊断
403
NodeControllerUnavailable
The Node Controller is temporarily unavailable.诊断
403
InvalidParameter.ResourceOwnerAccount
ResourceOwnerAccount is Invalid.诊断
403
Zone.NotOpen
The specified zone is not granted to you to buy resources yet.诊断
403
Zone.NotOnSale
The specified zone is not available for purchase.诊断
403
Account.Arrearage
Your account has been in arrears.诊断
403
InvalidReservedInstanceName.Malformed
The specified parameter ReservedInstanceName is invalid.诊断
403
InvalidParameter.Scope
The specified parameter 'Scope' is invalid.诊断
403
InvalidReservedInstanceStatus.ValueNotSupported
ReservedInstance status is not supported.诊断
403
InvalidReservedInstanceOfferingType.ValueNotSupported
The OfferingType is not supported.诊断
403
InvalidReservedInstanceOfferingClass.ValueNotSupported
The OfferingClass is not supported.诊断
403
MissingParameter.ZoneId
The specified zoneId should be not empty.诊断
403
MissingParameter.InstanceType
The instanceType should be not empty.诊断
403
MissingParameter.ReservedInstanceId
The ids of reservedInstance can not be empty.诊断
403
MissingParameter.ReservedInstanceConfiguration
The configurations of reservedInstance can not be empty.诊断
403
InvalidParameter.SplitOrMerge
The Many-to-many of modification is not supported.诊断
403
MissingParameter.InstanceTypeAndAmountBothEmpty
The instanceType and amount can not be both empty.诊断
403
InvalidReservedInstancePlatform.ValueNotSupported
The Platform is not supported.诊断
403
InvalidParameter.ReservedInstanceName
The reservedInstanceName is invalid.诊断
403
InvalidReservedInstanceZone.ValueNotSupported
The zoneId is not exist.诊断
403
InvalidParameter.ValueNotSupported
The instanceTypeFamily of the instance to be changed must be consistent.诊断
403
IncorrectInstanceStatus
The status of specified reservedInstance must be active.诊断
403
InvalidPlatform.ValueNotSupported
The platform of reservedInstance is invalid.诊断
403
InvalidScope.ValueNotSupported
The scope of reservedInstance is invalid, The valid value is Zone or Region.诊断
403
InvalidConfiguration.ValueNotSupported
The modification Configuration should not be empty.诊断
403
InvalidZoneId.ValueNotSupported
The specified zoneId should be same.诊断
403
InvalidParameter
The parameter is invalid.Please check it.诊断
403
InvalidInstanceAmount.ValueNotSupported
The instanceAmount is invalid.诊断
403
OperationDenied.OnlyModifyName
It is not allowed to modify the ReservedInstanceName only.诊断
403
InvalidReservedInstanceId.NotFound
The specified parameter ReservedInstanceId is invalid.诊断
403
ChargeTypeViolation
The operation is not permitted due to charge type of the instance.诊断
404
InvalidZoneId.NotFound
The ZoneId provided does not exist in our records.诊断
500
InternalError
The request processing has failed due to some unknown error.诊断

变更历史

变更时间变更内容概要操作
2024-12-26
变更错误码400
变更错误码403
2022-11-02
变更错误码400
变更错误码403
新增请求参数AutoRenew
新增请求参数AutoRenewPeriod
2022-08-12
新增OpenAPI,续费预留实例券

相关示例