# 续订包年/包月资源-RenewalResources #### 功能介绍 客户在自建平台完成包年/包月资源的续订。 客户的包年/包月资源即将到期时，可进行包年/包月资源的续订。 客户在费用中心执行续订操作请参见[这里](https://support.huaweicloud.com/usermanual-billing/renewals_topic_10000003.html)。 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) - 调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起续订，主资源的从资源信息可以通过调用[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)接口获取。 - 注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)接口获取的信息为准。 - 本接口支持自动支付，支付时使用折扣或优惠券的说明，请参见[支付使用折扣或优惠券说明](https://support.huaweicloud.com/api-oce/appendix_00001.html)。 - 设置包年/包月资源自动续费扣款日和续费后资源统一到期日可调用[设置包年/包月资源自动续费扣款日和续费后资源统一到期日](https://support.huaweicloud.com/api-oce/api_order_00031.html)接口。 - 本接口续费不会修改已设置的自动续费策略。例：客户新购包月资源2026/2/1-2026/3/1，自动续费策略为按月自动续费；在2026/2/9调用此接口续费一年（2026/3/1-2027/3/1），自动续费策略还是按月（在2027/3/1到期后，后续按月自动续费）。 #### 接口约束 该接口只允许使用客户AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=RenewalResources)中调试该接口，支持自动认证鉴权。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/renew #### 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource_ids | 是 | List\ | **参数解释：** 资源ID列表。 **约束限制：** 只支持传入主资源ID，最多10个资源ID。 哪些资源是主资源请根据"[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)"接口响应参数中的"is_main_resource"来标识。 **取值范围：** \[1-10\] **默认取值：** 不涉及 | | period_type | 是 | Integer | **参数解释：** 周期类型。 **约束限制：** 不涉及 **取值范围：** - 2：月 - 3：年 **默认取值：** 不涉及 | | period_num | 是 | Integer | **参数解释：** 周期数目。 **约束限制：** - 如果是月，目前支持1-11 - 如果是年，目前支持1-3 **取值范围：** \[1-11\] **默认取值：** 不涉及 | | is_auto_pay | 否 | Integer | **参数解释：** 是否自动支付。自动支付规则与自动续费规则一致，支付规则请参见[自动续费规则说明](https://support.huaweicloud.com/usermanual-billing/renewals_topic_20000002.html)中的相关规则说明。 **约束限制：** 不涉及 **取值范围：** - 0：否 - 1：是 **默认取值：** 此参数不携带或携带值为null时，默认值为"0：否"，即不自动支付。 | 请求示例 ``` POST https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/renew HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "resource_ids": [ "96308d5efd7841b9a4dac673d84d0e14" ], "period_type": 2, "period_num": 1, "is_auto_pay": 0 } ``` #### 响应消息 **响应参数** **状态码：200** 表1响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | order_ids | List\ | **参数解释** **：** 续订资源生成的订单ID的列表。 | | fail_resource_infos | List\ | **参数解释** **：** 失败的资源信息列表。有续订失败的资源时，该字段才有值。具体请参见[表FailResourceInfo](https://support.huaweicloud.com/api-oce/api_order_00018.html#api_order_00018__table3928175516326)。 该字段为预留字段。 | 表2FailResourceInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** **：** 状态码。 具体请参见[状态码](https://support.huaweicloud.com/api-oce/api_order_00018.html#api_order_00018__table106204562510)。 该字段为预留字段。 | | error_msg | String | **参数解释** **：** 错误描述信息。 该字段为预留字段。 | | resource_id | String | **参数解释** **：** 资源ID。 该字段为预留字段。 | **状态码：400** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** **：** 状态码。 具体请参见[状态码](https://support.huaweicloud.com/api-oce/api_order_00018.html#api_order_00018__section7845153731717)。 | | error_msg | String | **参数解释** **：** 错误描述信息。 | | order_ids | List\ | **参数解释** **：** 续订资源生成的订单ID的列表。 | | expiredResourceIds | List\ | **参数解释** **：** 已过期删除或不存在的资源列表。 只有错误码为CBC.99003016时，该参数才有值。 | 响应示例 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "order_ids": [ "CS19040119281JMYC" ], "fail_resource_infos":[] } ``` #### 状态码 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 400 | CBC.0100 | 参数错误。 | | 400 | CBC.30010036 | 续费的资源非主资源，不允许续费。 | | 400 | CBC.30010069 | 不存在的续费周期。 | | 400 | CBC.30050006 | 订单自动支付失败。 | | 400 | CBC.99000092 | 订购周期校验失败。 | | 400 | CBC.99003100 | 当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。 | | 400 | CBC.99003016 | 资源已过期删除或不存在。 | | 400 | CBC.99003144 | 资源有处理中的订单，不能进行当前操作。 | | 400 | CBC.99003154 | 资源已购买时长加本次续费时长已超过最大值，请重新选择续费时长。 | | 400 | CBC.99003634 | 参与优惠套餐活动的资源需要整体续费，不能和其他资源一起续费。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |