开发者社区 问答 正文

ECS如何设置实例的自动续费状态



描述


设置实例的自动续费状态。

  • 为了减少用户资源到期维护成本,针对包年包月的 ECS 实例,阿里云推出了自动续费功能,自动续费扣款日为实例到期前第 9 天,扣费动作在北京时间 (GMT+8) 08:00:00 开始执行。
  • 如果前一日执行自动扣费失败,将会继续下一日定时继续执行,直到扣费成功或者 9 天之后实例到期锁定。你只需要保证自己的账号的余额或者信用额度充足即可。


请求参数


名称类型是否必须描述
ActionString系统规定参数。取值:ModifyInstanceAutoRenewAttribute
RegionIdString实例所属的地域 ID。
InstanceIdString实例 ID。支持批量设置最多 100 个包年包月实例,多个实例 ID 以英文逗号分隔。
DurationInteger设置实例自动续费时长。单位:月,取值:1|2|3|6|12
AutoRenewBoolean设置是否自动续费。取值范围:
  • True:设置为自动续费类型。
  • False:取消自动续费类型。
默认值: False


返回参数


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

错误码


错误代码描述Http 状态码语义
ChargeTypeViolationPay-As-You-Go instances do not support this operation.403此操作不支持按量付费实例类型。
IncorrectInstanceStatusThe current status of the resource does not support this operation.403由于实例已过期,不支持此操作。
InvalidParameter.DurationThe auto renewal duration should be one of the following values: 1|2|3|6|12.403指定的续费时长不符合要求,应为 [1,2,3,6,12] 中的一个。
InvalidParameter.InvalidInstanceIdThe specified instanceId is not valid.403指定的 InstanceId 无效。
InvalidParameter.ToManyInstanceIdsNo more than 100 InstanceIds can be specified.403指定的 InstanceId 数量不能大于 100。
MissingParameter.InstanceIdInstanceId should not be null.403InstanceId 不能为空。


示例



请求示例


https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-instance1,i-instance2
&Duration=2
&AutoRenew=True
&<公共请求参数>
返回示例

XML格式
<ModifyInstanceAutoRenewAttributeResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceAutoRenewAttributeResponse>
JSON格式
{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}


展开
收起
boxti 2017-10-19 14:55:25 2905 分享
分享
版权
举报
阿里云 AI 助理回答

根据您的描述,您想了解如何使用阿里云API来设置ECS实例的自动续费状态。下面是一个简化的指南,帮助您理解并执行这个操作:

请求目的

通过调用阿里云ECS API中的ModifyInstanceAutoRenewAttribute动作,您可以批量修改包年包月(预付费)ECS实例的自动续费属性,包括是否开启自动续费以及设置自动续费的时长。

请求参数说明

  • Action: 必须参数,固定值为ModifyInstanceAutoRenewAttribute,表示要执行的操作。
  • RegionId: 必须参数,指定实例所在的地域ID,例如cn-hangzhou
  • InstanceId: 必须参数,一个或多个ECS实例ID,以英文逗号分隔,最多支持100个实例。例如i-12345678,i-87654321
  • Duration(可选): 设置自动续费的时长,单位为月,取值范围为1、2、3、6、12。如果不设置,默认可能不会改变当前的续费周期。
  • AutoRenew: 可选参数,布尔值,用于控制自动续费的状态。True表示开启自动续费,False表示取消自动续费。默认值为False

示例请求

https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-12345678,i-87654321
&AutoRenew=True
&Duration=1
&<公共请求参数>

在这个示例中,我们设置了两个实例(i-12345678i-87654321)在杭州地域的自动续费属性,开启了自动续费,并且续费时长为1个月。

注意事项

  • 确保您有权限对这些实例进行操作。
  • 实例必须是包年包月(预付费)类型,按量付费实例不支持此操作。
  • 检查实例状态是否允许更改自动续费设置。
  • 如果设置Duration,确保其值在允许的范围内。
  • 请不要忘记添加阿里云API请求中必要的公共请求参数,如AccessKeyId、Signature等,以完成身份验证。

错误码处理

如果遇到错误,可以根据返回的错误码和HTTP状态码进行排查。例如,ChargeTypeViolation错误意味着您尝试对按量付费实例执行了不支持的操作,这时需要检查实例的计费方式。

通过以上步骤,您可以成功地利用阿里云API调整ECS实例的自动续费配置。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等