更新时间:2024-07-04 GMT+08:00

续订包年/包月资源

功能介绍

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

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

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

接口约束

该接口只允许使用客户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-TokenMIIPAgYJKoZIhvcNAQcCo...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

其他错误。