ModifyReservedInstanceAutoRenewAttribute - 修改预留实例券自动续费属性

更新时间:
复制为 MD 格式

本接口主要用于修改一个或多个预留实例券的自动续费属性,支持您取消或者关闭自动续费。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:ModifyReservedInstanceAutoRenewAttribute

update

*ReservedInstance

acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#ReservedInstanceId}

请求参数

名称

类型

必填

描述

示例值

RegionId

string

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

cn-hangzhou

Period

integer

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

  • PeriodUnitYear时,取值范围:1、3、5。

  • PeriodUnitMonth时,取值范围:1。

1

PeriodUnit

string

自动续费时长单位。

取值范围:Month、Year。

默认值:Month。

Month

RenewalStatus

string

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

  • AutoRenewal:自动续费。

  • Normal:手动续费。

AutoRenewal

ReservedInstanceId

array

预留实例券 ID。

string

预留实例券 ID。您可以调用 DescribeReservedInstances 查看已购买的预留实例券。 仅支持对在有效期中的预留实例券进行设置。

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

ecsri-ajdfaj****

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

2A4EA075-CB5B-41B7-B0EB-70D339F6****

示例

正常返回示例

JSON格式

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

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter.Duration The specified parameter Duration is invalid.
403 Abs.MissingParamter.InstanceId ReservedInstanceId should not be null.
403 InvalidParameter.ToManyInstanceIds ReservedInstanceId should be less than 100.
403 InvalidParameter.PeriodUnit The specified parameter PeriodUnit is not valid.
403 InvalidParameter.Period The specified parameter Period is not valid.
403 InvalidParameter.RenewalStatus The specified parameter RenewalStatus is not valid. 指定的参数 RenewalStatus 无效。
403 InValidParameter Parameter invalid.%s 无效的参数。

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

变更历史

更多信息,参考变更详情