续订包年/包月资源（旧）

功能介绍

客户的包年/包月资源即将到期时，可进行包年/包月资源的续订。

该接口即将下线，“续订包年/包月资源”新接口请参考续订包年/包月资源。

Web UI

资源即将到期时，已经购买包年/包月产品的客户，可以在费用中心执行续订操作。

进入“ 续费管理”页面。
设置查询条件。
- 开通了企业项目管理的客户可以设置查询条件筛选该客户下各企业项目的名称，查询各企业项目待续费的资源。
- 单击“设置统一到期日”，可以设置资源的统一到期日，设置资源统一到期日的步骤请参见如何设置统一到期日。
- 可在“手动续费项”、“自动续费项”、“到期转按需项”“到期不续费项”页签查询全部待续费资源。
- 可对“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签的资源进行手动续费的操作。
所有需手动续费的资源都可归置到“手动续费项”页签。请参见如何恢复为手动续费。
单个续费与批量续费可使用不同的操作方式：
- 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。
- 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。
- 进入续费管理页面，默认隐藏有待支付订单的资源，可取消勾选页面中间“隐藏有待支付订单的资源”展示出来。
- 若资源有续费待支付订单，对该资源进行续费时弹出提示：资源有待支付订单，完成支付或取消订单后才能续费订单。可点击提示框的订单号进入订单页面，完成支付或取消该订单后，该资源恢复可续费状态。
确认需要续费的资源信息，并设置续费时长，单击“去支付”。
选择优惠和支付方式，单击“确认付款”。

REST API

客户在自建平台完成包年/包月资源的续订。

该接口只允许使用客户AK/SK或者Token调用。
调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起续订，存在主从资源关系的资源为：
- 云主机为主资源，对应的从资源为云硬盘
- 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）
- 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽
本接口支持自动支付，自动支付时支持使用折扣、优惠券。支付时使用折扣或优惠券的说明，请参见支付使用折扣或优惠券说明。

URI

POST /v1.0/{domain_id}/common/order-mgr/resources/renew

参数说明请参见下表。

表1 URI参数说明
参数	是否必选	取值范围	描述
domain_id	是	最大长度：64	客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
resource_ids	是	List<String>	[1-10]	资源ID列表。只支持传入主资源ID，最多10个资源ID。哪些资源是主资源请根据“查询客户包年/包月资源列表（旧）”接口响应参数中的“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-intl.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
}

响应消息

响应参数

参数	参数类型	描述
error_code	String	状态码。具体请参见4。
error_msg	String	错误描述信息。
order_ids	List<String>	续订资源生成的订单ID的列表。
expiredResourceIds	List<string>	因资源过期无法续费的资源列表。只有错误码为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":[]
}

状态码

状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码	错误码	描述
200	CBC.0000	成功。
200/400	CBC.0100	参数错误。
500	CBC.0999	其他错误。
403	CBC.0151	访问拒绝。
200	CBC.7281	您的账号已被冻结，无法续订/退订。
200	CBC.3016	存在过期资源。
200	CBC.99003144	资源有处理中的订单，不能进行当前操作。
400	CBC.99003154	资源已购买时长加本次续费时长后已超过最大值，请重新选择续费时长。
200	CBC.3144	资源有处理中的订单，不能进行当前操作。
200	CBC.99003631	退订中/删除中/释放中的资源不能续费。
200	CBC.30010036	续费的资源非主资源，不允许续费。
200	CBC.30010069	不存在的续费周期。
200	CBC.30050006	订单自动支付失败。