续订包年/包月资源
功能介绍
客户在伙伴销售平台完成包年/包月资源的续订。
客户的包年/包月资源即将到期时，可进行包年/包月资源的续订。
客户在费用中心执行续订操作请参见这里。
- 调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起续订，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
- 注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。
- 本接口支持自动支付，支付时使用折扣或优惠券的说明，请参见支付使用折扣或优惠券说明。
接口约束
该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴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] |
周期类型：
|
period_num |
是 |
Integer |
[1-11] |
周期数目：
|
expire_policy |
是 |
Integer |
[0-3] |
到期策略（字段已废弃，请勿使用该字段。此字段必填，需携带，但携带的枚举实际并不生效）：
|
is_auto_pay |
否 |
Integer |
[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
参数 |
参数类型 |
描述 |
|---|---|---|
order_ids |
List<String> |
续订资源生成的订单ID的列表。 |
fail_resource_infos |
List<FailResourceInfo> |
失败的资源信息列表。有续订失败的资源时，该字段才有值。具体请参见表FailResourceInfo。 该字段为预留字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
状态码。 具体请参见状态码。 该字段为预留字段。 |
error_msg |
String |
错误描述信息。 该字段为预留字段。 |
resource_id |
String |
资源ID。 该字段为预留字段。 |
状态码：400
参数 |
参数类型 |
描述 |
|---|---|---|
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.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 |
其他错误。 |
