# 设置包年/包月资源自动续费-AutoRenewalResources
#### 功能介绍
为防止资源到期被删除，客户可为长期使用的包年/包月资源开通自动续费。
客户在费用中心开通自动续费请参见[这里](https://support.huaweicloud.com/usermanual-billing/renewals_topic_20000003.html)。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 首先要客户成功支付包年/包月资源订单，才能进行自动续费的开通。
- 目前支持设置自动续费的包年/包月产品请参见[自动续费规则说明](https://support.huaweicloud.com/usermanual-billing/renewals_topic_20000002.html)。
- 在调用本接口前，您可以调用"[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)"接口获取资源ID、资源过期时间以及资源过期后扣费策略等信息。
- 自动续费将于产品到期前7天的凌晨3:00开始扣款，请保持账户余额充足。若由于账户中余额不足等原因导致第一次未扣费成功，系统将每天凌晨3:00尝试进行一次扣款，直到扣款成功或保留产品资源的最后一天。
- 在原资源计费模式下，续费周期为该产品最小售卖周期。
 
#### 接口约束
该接口只允许使用客户AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=AutoRenewalResources)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                        | 描述                             | 访问级别  | 资源类型（\*为必须） | 条件键 | 别名 |
  |:---|:---|:---|:---|:---|:---|
  | billing:subscription:renew | 授予续费、设置自动续费、设置到期策略、按需转包年/包月的权限 | write | -           | -   | -  |
     
  
 
#### URI
POST /v2/orders/subscriptions/resources/autorenew/{resource_id}
参数说明请参见下表。
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| resource_id | 是    | String | **参数解释**： 资源ID。 **约束限制：** 您可以调用"[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)"接口获取资源ID。 设置主资源时会将从资源一起设置，主从关系为： - 云主机为主资源，对应的从资源为云硬盘  - 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）  - 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽   设置从资源自动续费，主资源也一并续费。 **取值范围**： 最大长度：64 **默认取值：** 不涉及 |
   
#### 请求消息
请求参数
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| auto_renew_times | 否    | Integer | **参数解释：** 自动续费次数。在设定的自动续费次数周期完成后，结束自动续费。 **约束限制：** 首次开通自动续费，此参数不携带或携带值为null时，默认为不限制次数； 已开通自动续费，重置自动续费次数时此参数必填，否则不做处理，不进行修改。 **取值范围：** \[0-99\] 说明： 0代表不限制次数。 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                        |
| period_type      | 否    | String  | **参数解释**： 自动续费的周期类型 **约束限制：** 不涉及 **取值范围**： - MONTH：包月  - YEAR：包年   **默认取值：** 此参数不携带或携带值为null时，按照如下规则处理： 1. 未设置过自动续费类型，默认与资源的最后一个订单的订购周期类型一致。  2. 设置过自动续费类型，与历史设置保持一致。   |
   
请求示例
```
POST https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/autorenew/eb1cac79-773b-414b-8915-6c3eed8ddf24 HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "auto_renew_times": 3,
    "period_type": "MONTH"
}
```
#### 响应消息
响应参数
| 参数         | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释** **：** 状态码。 具体请参见[状态码]。 |
| error_msg  | String | **参数解释** **：** 错误描述信息。                                                                                       |
   
响应示例：
```
HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
```
 #### 状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 描述                  |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。               |
| 400     | CBC.30010001 | 您所购买的产品已下架，不支持自动续费。 |
| 400     | CBC.99003012 | 资源ID不存在。            |
| 400     | CBC.99003602 | 资源已过期或被冻结，不允许自动续费。  |
| 400     | CBC.30010097 | 您选择的续费周期该产品暂不支持     |
| 403     | CBC.0151     | 访问拒绝。               |
| 500     | CBC.0999     | 其他错误。               |