客户运营能力客户运营能力

更新时间:2021/09/13 GMT+08:00
分享

续订包年/包月资源

功能介绍

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

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

接口约束

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

调试

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

URI

POST /v2/orders/subscriptions/resources/renew

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

resource_ids

List<String>

列表最大长度:100

资源ID列表。

只支持传入主资源ID,最多100个资源ID。

哪些资源是主资源请根据“查询客户包年/包月资源列表”接口响应参数中的“is_main_resource”来标识。

period_type

Integer

[2|3]

周期类型:

  • 2:月
  • 3:年

period_num

Integer

[1-11]

周期数目:

  • 如果是月,目前支持1-11
  • 如果是年,目前支持1-3

expire_policy

Integer

[1-3]

到期策略:

  • 1:转按需
  • 2:自动退订
  • 3:自动续订

is_auto_pay

Integer

[0-1]

是否自动支付。

  • 0:否
  • 1:是

不填写的话,默认值是0,不自动支付。自动支付仅仅支持从余额付款。

请求示例
POST https://bss.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

参数

参数类型

描述

order_ids

List<String>

续订资源生成的订单ID的列表。

状态码:400

参数

参数类型

描述

error_code

String

状态码。

具体请参见状态码

error_msg

String

错误描述信息。

order_ids

List<String>

续订资源生成的订单ID的列表。

expired_resource_ids

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"
  ]
}

状态码

HTTP状态码

错误码

描述

400

CBC.0100

参数错误。

400

CBC.99003001

资源已过期。

400

CBC.99003002

资源被锁定。

400

CBC.99003004

资源存在依赖。

400

CBC.99003005

资源正在开通。

400

CBC.99003006

云服务类型不支持。

400

CBC.99003100

当前操作的资源中,有资源包含在您的待支付的订单,不能进行当前操作。

400

CBC.99003638

带宽加油包资源不能续费。

400

CBC.99003016

存在过期资源。

400

CBC.99003124

资源已经退订。

400

CBC.99003144

资源正在退订或者变更。

400

CBC.99003634

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

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品