# 续订包年/包月资源（旧） #### 功能介绍 客户的包年/包月资源即将到期时，可进行包年/包月资源的续订。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口即将下线，"续订包年/包月资源"新接口请参考[续订包年/包月资源-RenewalResources](https://support.huaweicloud.com/api-bpconsole/api_order_00018.html)。 #### Web UI 资源即将到期时，已经购买包年/包月产品的客户，可以在费用中心执行续订操作。 1. 进入" [续费管理](https://account.huaweicloud.com/usercenter/?locale=zh-cn#/userindex/renewalManagement)"页面。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 如需对域名续费，可点击页面右上角"域名续费"快捷入口，进入控制台进行续费操作。请参见"如何[域名续费](https://support.huaweicloud.com/usermanual-domain/domain_ug_330008.html)"。 2. 设置查询条件。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0295652247.png "点击放大") ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 开通了企业项目管理的客户可以设置查询条件筛选该客户下各企业项目的名称，查询各企业项目待续费的资源。 - 单击"设置统一到期日"，可以设置资源的统一到期日，设置资源统一到期日的步骤请参见[如何设置统一到期日](https://support.huaweicloud.com/usermanual-billing/renewals_topic_10000004.html)。 - 可在"手动续费项"、"自动续费项"、"到期转按需项""到期不续费项"页签查询全部待续费资源。 - 可对"手动续费项"、"自动续费项"、"到期转按需项"、"到期不续费项"页签的资源进行手动续费的操作。 3. 所有需手动续费的资源都可归置到"手动续费项"页签。请参见[如何恢复为手动续费](https://support.huaweicloud.com/usermanual-billing/renewals_topic_10000005.html)。 4. 单个续费与批量续费可使用不同的操作方式： - 单个续费：在资源页面找到需要续费的资源，单击操作列的"续费"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0295651981.png "点击放大") - 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的"批量续费"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0295652238.png "点击放大") ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 进入续费管理页面，默认隐藏有待支付订单的资源，可取消勾选页面中间"隐藏有待支付订单的资源"展示出来。 - 若资源有续费待支付订单，对该资源进行续费时弹出提示：资源有待支付订单，完成支付或取消订单后才能续费订单。可点击提示框的订单号进入订单页面，完成支付或取消该订单后，该资源恢复可续费状态。 5. 确认需要续费的资源信息，并设置续费时长，单击"去支付"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0295652273.png "点击放大") 6. 选择优惠和支付方式，单击"确认付款"。 7. 获取并输入手机验证码，单击"确认付款"。 - 操作成功即可完成续费。 - 如暂时不支付，可直接关闭支付页面。后续可以在左侧菜单中选择"我的订单"并单击"待支付"页签，支付刚才生成的续费订单，即可完成续费。 #### REST API 客户在伙伴销售平台完成包年/包月资源的续订。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 该接口只允许使用客户AK/SK或者Token调用，不允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。因为目前解决方案提供商或华为云总经销商（一级经销商）不能自己买产品，所以没有自己的包年/包月产品。 - 调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起续订，存在主从资源关系的资源为： - 云主机为主资源，对应的从资源为云硬盘 - 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP） - 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽 - 本接口支持自动支付，自动支付时支持使用折扣、优惠券。支付时使用折扣或优惠券的说明，请参见[支付使用折扣或优惠券说明](https://support.huaweicloud.com/api-bpconsole/appendix_00001.html)。 1. URI POST /v1.0/{domain_id}/common/order-mgr/resources/renew 参数说明请参见下表。 表1URI参数说明 | 参数 | 是否必选 | 取值范围 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | 最大长度：64 | 客户账号ID。获取方法请参见[如何获取客户的customer_id/domain_id](https://support.huaweicloud.com/api-bpconsole/offl_110002.html)。 | 2. 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | resource_ids | 是 | List\ | \[1-10\] | 资源ID列表。 只支持传入主资源ID，最多10个资源ID。 哪些资源是主资源请根据"[查询客户包年/包月资源列表（旧）](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0084961226.html)"接口响应参数中的"is_main_resource"来标识。 | | period_type | 是 | Integer | \[2\|3\] | 周期类型： - 2：月 - 3：年 | | period_num | 是 | Integer | \[1-11\] | 周期数目： - 如果是月，目前支持1-11 - 如果是年，目前支持1-3 | | isAutoPay | 否 | Integer | \[0-1\] | 是否自动支付。 - 0：否 - 1：是 不填写的话，默认值是0，不自动支付。 此参数不携带或携带值为null或携带值为空串时，取值为0；不支持携带值为空。 | 请求示例 ``` POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/renew HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "resource_ids": ["53fe*****068b"], "period_type":2, "period_num":2 } ``` 3. 响应消息 响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 状态码。 具体请参见[4]。 | | error_msg | String | 错误描述信息。 | | order_ids | List\ | 续订资源生成的订单ID的列表。 | | expiredResourceIds | List\ | 因资源过期无法续费的资源列表。 只有错误码为3016时，该参数才有值。 | 响应示例 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "order_ids": ["xxxxxxxxxx"], "expiredResouceIds":[] } ``` 4. 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 200 | CBC.0000 | 成功。 | | 200/400 | CBC.0100 | 参数错误。 | | 500 | CBC.0999 | 其他错误。 | | 403 | CBC.0151 | 访问拒绝。 | | 200 | CBC.3016 | 存在过期资源。 | | 200 | CBC.99003144 | 资源有处理中的订单，不能进行当前操作。 | | 400 | CBC.99003154 | 资源已购买时长加本次续费时长后已超过最大值，请重新选择续费时长。 | | 200 | CBC.3144 | 资源有处理中的订单，不能进行当前操作。 | | 200 | CBC.99003631 | 退订中/删除中/释放中的资源不能续费。 | | 200 | CBC.30010036 | 续费的资源非主资源，不允许续费。 | | 200 | CBC.30010069 | 不存在的续费周期。 | | 200 | CBC.30050006 | 订单自动支付失败。 |