调用ModifyDedicatedHostAutoRenewAttribute为一台或多台包年包月专有宿主机设置自动续费,也可以取消已设定的自动续费。
接口说明
包年包月专有宿主机到期前九天自动续费,扣费在08:00:00(UTC +8)时间点自动执行。如果前一日扣费失败,次日继续定时执行。扣费成功或者九天之后专有宿主机到期被锁定后停止自动扣费。期间,您需要保证自己的支付方式使用额度充足即可。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyDedicatedHostAutoRenewAttribute |
系统规定参数。取值:ModifyDedicatedHostAutoRenewAttribute |
DedicatedHostIds | String | 是 | dh-bp165p6xk2tlw61e**** |
专有宿主机ID。最多可以输入100个包年包月专有宿主机ID,ID之间用半角逗号(,)隔开。 |
RegionId | String | 是 | cn-hangzhou |
专有宿主机所属的地域ID。 |
Duration | Integer | 否 | 1 |
续费周期。取值范围:请参见 |
PeriodUnit | String | 否 | Month |
续费时长单位。取值范围:
|
AutoRenew | Boolean | 否 | false |
是否自动续费包年包月专有宿主机。取值范围:
|
RenewalStatus | String | 否 | Normal |
是否自动续费包年包月专有宿主机,参数
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 2A4EA075-CB5B-41B7-B0EB-70D339F64DE7 |
请求ID。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=ModifyDedicatedHostAutoRenewAttribute
&DedicatedHostIds=dh-bp165p6xk2tlw61e****
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<ModifyDedicatedHostAutoRenewAttributeResponse>
<RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F64DE7</RequestId>
</ModifyDedicatedHostAutoRenewAttributeResponse>
JSON
格式
{
"RequestId":"2A4EA075-CB5B-41B7-B0EB-70D339F64DE7"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | MissingParameter.DedicatedHostId | DedicatedHostId should not be null. | 参数DedicatedHostId不能为空。 |
403 | InvalidParameter.ToManyDedicatedHostIds | DedicatedHostId should be less than 100. | 参数DedicatedHostIds包含的专有宿主机ID应该少于100个。 |
403 | InvalidParameter.InvalidDedicatedHostId | %s | 指定的参数DedicatedHostId无效。 |
403 | IncorrectHostStatus | The current status of the resource does not support this operation. | 当前资源的状态不支持此操作。 |
403 | ChargeTypeViolation | Pay-As-You-Go dedicated host 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. | 参数PeriodUnit无效。 |
访问错误中心查看更多错误码。