更新时间:2024-09-26 GMT+08:00

续订包年/包月资源(旧)

功能介绍

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

该接口即将下线,“续订包年/包月资源”新接口请参考续订包年/包月资源

Web UI

资源即将到期时,已经购买包年/包月产品的客户,可以在费用中心执行续订操作。

  1. 进入“ 续费管理”页面。
  2. 设置查询条件。

    • 开通了企业项目管理的客户可以设置查询条件筛选该客户下各企业项目的名称,查询各企业项目待续费的资源。
    • 单击“设置统一到期日”,可以设置资源的统一到期日,设置资源统一到期日的步骤请参见如何设置统一到期日
    • 可在“手动续费项”、“自动续费项”、“到期转按需项”“到期不续费项”页签查询全部待续费资源。
    • 可对“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签的资源进行手动续费的操作。

  3. 所有需手动续费的资源都可归置到“手动续费项”页签。请参见如何恢复为手动续费
  4. 单个续费与批量续费可使用不同的操作方式:

    • 单个续费:在资源页面找到需要续费的资源,单击操作列的“续费”。

    • 批量续费:在资源页面勾选需要续费的资源,单击列表左上角的“批量续费”。

    • 进入续费管理页面,默认隐藏有待支付订单的资源,可取消勾选页面中间“隐藏有待支付订单的资源”展示出来。
    • 若资源有续费待支付订单,对该资源进行续费时弹出提示:资源有待支付订单,完成支付或取消订单后才能续费订单。可点击提示框的订单号进入订单页面,完成支付或取消该订单后,该资源恢复可续费状态。

  5. 确认需要续费的资源信息,并设置续费时长,单击“去支付”。

  6. 选择优惠和支付方式,单击“确认付款”。

REST API

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

  • 该接口只允许使用客户AK/SK或者Token调用。
  • 调用接口后,如果某个主资源ID有对应的从资源ID,系统会将主资源ID和从资源ID一起续订,存在主从资源关系的资源为:
    • 云主机为主资源,对应的从资源为云硬盘
    • 共享带宽的情况下,带宽为主资源,对应的从资源为弹性IP(可能包含多个IP)
    • 独享带宽的情况下,弹性IP为主资源,对应的从资源为带宽
  • 本接口支持自动支付,自动支付时支持使用折扣、优惠券。支付时使用折扣或优惠券的说明,请参见支付使用折扣或优惠券说明

  1. URI

    POST /v1.0/{domain_id}/common/order-mgr/resources/renew

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

  2. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    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_mode

    Integer

    [0-3]

    到期策略(字段已废弃,请勿使用):

    • 0:进入宽限期
    • 1:转按需
    • 2:自动退订
    • 3:自动续订

    isAutoPay

    Integer

    [0-1]

    是否自动支付。

    • 0:否
    • 1:是

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

    此参数不携带或携带值为null或携带值为空串时,取值为0;不支持携带值为空。

    请求示例
    POST https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/renew HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
      "resource_ids": ["53fe*****068b"],
      "period_type":2,
      "period_num":2,
      "expire_mode":0
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4

    error_msg

    String

    错误描述信息。

    order_ids

    List<String>

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

    expiredResourceIds

    List<string>

    因资源过期无法续费的资源列表。

    只有错误码为3016时,该参数才有值。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time  
    
    {
        "error_code": "CBC.0000",
        "error_msg": "success",
        "order_ids": ["xxxxxxxxxx"],
        "expiredResouceIds":[]
    }

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

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    200/400

    CBC.0100

    参数错误。

    500

    CBC.0999

    其他错误。

    403

    CBC.0151

    访问拒绝。

    200

    CBC.7281

    您的账号已被冻结,无法续订/退订。

    200

    CBC.3016

    存在过期资源。

    200

    CBC.99003144

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

    400

    CBC.99003154

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

    200

    CBC.3144

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

    200

    CBC.99003631

    退订中/删除中/释放中的资源不能续费。

    200

    CBC.30010036

    续费的资源非主资源,不允许续费。

    200

    CBC.30010069

    不存在的续费周期。

    200

    CBC.30050006

    订单自动支付失败。