在提供的“# 待处理文本”中未找到指定的`## 2. 最终结果`或`最终搜索标题：`，无法提取标题。-云服务器 ECS(ECS)-阿里云帮助中心

本接口用于修改一台或多台包年包月实例的自动续费属性，可以帮助您减少资源到期的维护成本。

接口说明

请确保在使用该接口前，您已充分了解云服务器 ECS 的计费方式和价格。

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

操作

访问级别

资源类型

条件关键字

关联操作

ecs:ModifyInstanceAutoRenewAttribute

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

无

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。支持批量设置最多 100 个包年包月实例，多个实例 ID 以英文逗号分隔。	i-bp67acfmxazb4ph**,i-bp67acfmxazb4pi**
RegionId	string	是	实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
Duration	integer	否	设置实例自动续费时长。 `PeriodUnit`为`Year`（年）时，`Duration`的取值范围为：{"1", "2", "3", "4", "5"} `PeriodUnit`为`Month`（月）时，`Duration`的取值范围为：{"1", "2", "3", "6", "12", "24", "36", "48", "60"} `PeriodUnit`为`Week`（周）时，`Duration`的取值范围为：{"1", "2", "3", "4"}	1
AutoRenew	boolean	否	实例到期前是否自动续费。 true：是。 false：否。默认值：false。	true
RenewalStatus	string	否	实例的自动续费状态。取值范围： AutoRenewal：设置为自动续费。 Normal：取消自动续费。 NotRenewal：不再续费。传入该值后，系统不再发送到期提醒，只在到期前第三天发送不续费提醒。不再续费的 ECS 实例可以更改成待续费（`Normal`）后，再自行续费或设置为自动续费。说明参数`RenewalStatus`的优先级高于参数`AutoRenew`。如果不传入参数`RenewalStatus`，则默认以参数`AutoRenew`为准。	AutoRenewal
PeriodUnit	string	否	续费时长的时间单位，即参数`Duration`的单位。取值范围： Week Month（默认） Year	Month

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

HTTP status code	错误码	错误信息	描述
400	OperationDenied.StarterPackage	Instance created with a Starter Package plan can not set auto renew.
500	InternalError	The request processing has failed due to some unknown error.
403	MissingParameter.InstanceId	InstanceId should not be null.	参数 InstanceId 不能为空。
403	InvalidParameter.ToManyInstanceIds	InstanceId should be less than 100.
403	InvalidParameter.InvalidInstanceId	%s	指定的参数 InstanceId 无效。
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	按量付费实例不支持该操作，检查实例的付费类型是否与该操作冲突。
403	InvalidParameter.Duration	%s	参数 Duration 无效。
403	InvalidParameter.RenewalStatus	%s	指定的参数 RenewalStatus 无效。
403	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	参加了入门级套餐活动的实例，只能设置成每月自动续费。

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

更多信息，参考变更详情。