调用ModifyReservedInstanceAutoRenewAttribute为一个或多个包年包月预留实例券设置自动续费,也可以取消已设定的自动续费。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyReservedInstanceAutoRenewAttribute

系统规定参数。取值:ModifyReservedInstanceAutoRenewAttribute

RegionId String cn-hangzhou

预留实例券所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

Period Integer 1

自动续费周期。取值范围:

  • PeriodUnitYear时,取值范围:1、3、5。
  • PeriodUnitMonth时,取值范围:1。
PeriodUnit String Month

自动续费时长单位。

取值范围:Month、Year。

默认值:Month。

RenewalStatus String AutoRenewal

是否自动续费包年包月预留实例券。取值范围:

  • AutoRenewal:自动续费。
  • Normal:手动续费。
ReservedInstanceId.N String ecsri-ajdfaj****

预留实例券ID。您可以调用DescribeReservedInstances查看已购买的预留实例券。

仅支持对生效中(Status=Active)的预留实例券进行设置。

单次设置的预留实例券数量最多不超过100个。

返回数据

名称 类型 示例值 描述
RequestId String 2A4EA075-CB5B-41B7-B0EB-70D339F6****

请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyReservedInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&Period=1
&PeriodUnit=Month
&RenewalStatus=AutoRenewal
&ReservedInstanceId.1=ecsri-ajdfaj****
&ReservedInstanceId.2=ecsri-abjkql****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyReservedInstanceAutoRenewAttributeResponse>
    <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F6****</RequestId>
</ModifyReservedInstanceAutoRenewAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

错误码

HttpCode 错误码 错误信息 描述
403 InvalidParameter.Duration %s 参数 Duration 无效。
403 InvalidParameter.RenewalStatus %s 指定的参数 RenewalStatus 无效。
403 InvalidParameter %s 无效的参数。

访问错误中心查看更多错误码。