续订包年/包月资源

功能介绍

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

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

客户在费用中心执行续订操作请参见这里。

调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起续订，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。
本接口支持自动支付，支付时使用折扣或优惠券的说明，请参见支付使用折扣或优惠券说明。

接口约束

该接口只允许使用客户AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/orders/subscriptions/resources/renew

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
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
expire_policy	否	Integer	[0-3]	到期策略（字段已废弃，请勿使用该字段。此字段非必填，无需携带。若携带，携带的枚举实际并不生效）： 0：进入宽限期/保留期 1：转按需 2：自动退订 3：自动续订
is_auto_pay	否	Integer	[0-1]	是否自动支付。 0：否 1：是此参数不携带或携带值为null时，默认值为“0：否”，即不自动支付。自动支付规则与自动续费规则一致，支付规则请参见自动续费规则说明中的相关规则说明。

请求示例

POST https://bss-intl.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,
    "expire_policy": 1,
    "is_auto_pay": 0
}

响应消息

响应参数

状态码：200

表1 响应Body参数
参数	参数类型	描述
order_ids	List<String>	续订资源生成的订单ID的列表。
fail_resource_infos	List<FailResourceInfo>	失败的资源信息列表。有续订失败的资源时，该字段才有值。具体请参见表FailResourceInfo。该字段为预留字段。

表2 FailResourceInfo
参数	参数类型	描述
error_code	String	状态码。具体请参见状态码。该字段为预留字段。
error_msg	String	错误描述信息。该字段为预留字段。
resource_id	String	资源ID。该字段为预留字段。

状态码：400

表3 响应Body参数
参数	参数类型	描述
error_code	String	状态码。具体请参见状态码。
error_msg	String	错误描述信息。
order_ids	List<String>	续订资源生成的订单ID的列表。
expiredResourceIds	List<String>	已过期删除或不存在的资源列表。只有错误码为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":[]
}

状态码

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

HTTP状态码	错误码	描述
400	CBC.0100	参数错误。
400	CBC.30010036	续费的资源非主资源，不允许续费。
400	CBC.30010069	不存在的续费周期。
400	CBC.30050006	订单自动支付失败。
400	CBC.99000092	订购周期校验失败。
400	CBC.99003100	当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。
400	CBC.7281	您的账号已被冻结，无法续订/退订/支付。
400	CBC.99003016	资源已过期删除或不存在。
400	CBC.99003144	资源有处理中的订单，不能进行当前操作。
400	CBC.99003154	资源已购买时长加本次续费时长已超过最大值，请重新选择续费时长。
400	CBC.99003634	参与优惠套餐活动的资源需要整体续费，不能和其他资源一起续费。
403	CBC.0151	访问拒绝。
500	CBC.0999	其他错误。