调用ModifyDedicatedHostAutoRenewAttribute为一台或多台包年包月专有宿主机设置自动续费,也可以取消已设定的自动续费。

描述

包年包月专有宿主机到期前九天自动续费,扣费在08:00:00(UTC+8)时间点自动执行。如果前一日扣费失败,次日继续定时执行。扣费成功或者九天之后专有宿主机到期被锁定后停止自动扣费。期间,您需要保证自己的支付方式使用额度充足即可。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:ModifyDedicatedHostAutoRenewAttribute
RegionId String 专有宿主机所属的地域ID。
DedicatedHostIds String 专有宿主机ID。最多可以输入100个包年包月专有宿主机ID,ID之间用半角逗号(,)隔开。
Period String 续费周期,取值范围:请参见PeriodUnit的参数描述部分。
PeriodUnit String 续费单位。取值范围:
  • Week:周。此时,Period的取值范围: 1 | 2 | 3
  • Month(默认):月。此时,Period的取值范围:1 | 2 | 3 | 6 | 12
AutoRenew Boolean 是否自动续费包年包月的专有宿主机。取值范围:true | false(默认)
RenewalStatus String 是否自动续费包年包月的专有宿主机,RenewalStatus的优先级高于AutoRenew。取值范围:
  • AutoRenewal:自动续费。
  • Normal:待续费。
  • NotRenewal:不续费,也不发送到期提醒。到期前第三天我们会发送不续费提醒。不续费的专有宿主机可以设置成待续费(Normal),再自行续费(RenewDedicatedHosts)或设置为自动续费(AutoRenewal)。
ClientToken String

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

返回参数

均为公共返回参数。参数详情,请参见公共参数

示例

请求示例
https://ecs.aliyuncs.com/?Action=ModifyDedicatedHostAutoRenewAttribute
&RegionId=cn-hangzhou
&DedicatedHostIds=dh-dedicatedhost1,dh-dedicatedhost2
&AutoRenew=true
&<公共请求参数>
返回示例
  • XML格式
    <ModifyDedicatedHostAutoRenewAttributeResponse>
      <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F64DE7</RequestId>
    </ModifyDedicatedHostAutoRenewAttributeResponse>
  • JSON格式
    {
        "RequestId":"2A4EA075-CB5B-41B7-B0EB-70D339F64DE7"
    }

错误码

错误代码 错误信息 HTTP 状态码 说明
IncorrectHostStatus The current status of the resource does not support this operation. 403 由于实例已过期,不支持此操作。
InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. 403 指定的续费单位无效。
InvalidParameter.ToManyDedicatedHostIds No more than 100 DedicatedHostIds can be specified. 403 单次最多能指定100个专有宿主机ID。
MissingParameter.DedicatedHostId DedicatedHostId should not be null. 403 指定的DedicatedHostIds不能为空。
InvalidParameter.InvalidDedicatedHostId The specified dedicatedHostIds is not valid. 403 指定的DedicatedHostIds中有无效的专有宿主机ID。
InvalidParameter.Duration The auto renewal duration should be one of the following values: 1|2|3|6|12. 403 指定的续费时长不符合要求。正确的续费时长应为{1,2,3,6,12}中的一个。
InvalidParameter.RenewalStatus The specified parameter RenewalStatus must be AutoRenewal NotRenewal or Normal. 403 指定的RenewalStatus无效。
InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 404 指定的DedicatedHostIds列表里有不存在的专有宿主机ID。