文档首页/ 客户运营能力/ API参考/ 管理交易/ 管理包年/包月资源/ 续订包年/包月资源
更新时间：2024-07-03 GMT+08:00
查看PDF
分享

续订包年/包月资源

功能介绍

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

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

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

接口约束

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

调试

您可以在API Explorer中调试该接口。

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.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.99003016

资源已过期删除或不存在。

400

CBC.99003144

资源有处理中的订单，不能进行当前操作。

400

CBC.99003154

资源已购买时长加本次续费时长已超过最大值，请重新选择续费时长。

400

CBC.99003634

参与优惠套餐活动的资源需要整体续费，不能和其他资源一起续费。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档