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

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

功能介绍

客户购买包年/包月资源后,支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分,退订后资源将无法使用。

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

Web UI

客户可在费用中心退订已购买的包年/包月资源。

  1. 进入“退订管理”页面。
  2. 单击“创建成功资源退订”页签。
  3. 单个资源退订与批量退订可使用不同的操作方式:

    • 退订单个资源:单击待退订资源所在行的“退订资源”。

    • 批量退订:在退订列表中勾选需要退订的资源,单击列表左上角的“退订资源”。

  4. 查看退订信息,勾选“我已确认本次退订金额和相关费用”后,单击“退订”。

REST API

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

首先要成功支付包年/包月产品,产生一条开通成功的包年/包月资源,才能进行退订。

  • 该接口只允许使用客户AK/SK或者Token调用
  • 调用接口后,如果某个主资源ID有对应的从资源ID,系统会将主资源ID和从资源ID一起退订,存在主从资源关系的资源为:
    • 云主机为主资源,对应的从资源为云硬盘
    • 共享带宽的情况下,带宽为主资源,对应的从资源为弹性IP(可能包含多个IP)
    • 独享带宽的情况下,弹性IP为主资源,对应的从资源为带宽

  1. URI

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

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

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

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    resourceIds

    List<String>

    [1-10]

    资源ID列表。

    最大支持1次性输入10个资源ID,只能输入主资源ID。

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

    unSubType

    Integer

    [1-2]

    退订类型,取值如下:

    • 1:退订资源及其已续费周期。
    • 2:只退订资源已续费周期,不退订资源。

    unsubscribeReasonType

    Integer

    [1-5]

    退订理由分类,取值如下:

    • 1:产品不好用
    • 2:产品功能无法满足需求
    • 3:不会操作/操作过于复杂
    • 4:对服务不满意
    • 5:其他

    此参数不携带或携带值为空串或携带值为null时,不会被赋值。

    unsubscribeReason

    String

    最大长度:512

    退订原因,一般由客户输入。

    此参数不携带或携带值为空串或携带值为null时,不会被赋值。

    请求示例

    POST https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/delete HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
      "resourceIds": ["53fa7828774df68b","72a256456xdf45g"],
      "unSubType":2,
      "unsubscribeReasonType":2,
      "unsubscribeReason":"xxxxxxx"
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4

    error_msg

    String

    错误描述信息。

    orderIds

    List<String>

    客户退订订单ID的列表信息。

    响应示例

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

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

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    400

    CBC.0100

    参数错误。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    其他错误。

    200

    CBC.3185

    云服务必须整体退订。

    200

    CBC.30000053

    资源计费模式是节省计划,不支持退订。

    200

    CBC.30000067

    资源已被删除或者资源未被纳管,不支持退订。

    200

    CBC.7281

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

    200

    CBC.99003012

    资源ID不存在。

    200

    CBC.99003100

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

    200

    CBC.99003128

    资源无已续费周期或续费周期已生效,不支持退订续费周期。

    200

    CBC.99006066

    查询费用信息错误。

    200

    CBC.99003645

    该类型的云服务不支持退订。

    400

    CBC.99003650

    云市场中的该云服务不能退订。

    200

    CBC.99003656

    已冻结,不能执行此操作