文档首页 > > API参考> 待下线接口> 管理交易> 管理包年/包月订单> 管理资源> 退订包年/包月资源

退订包年/包月资源

分享
更新时间: 2020/06/17 GMT+08:00

功能介绍

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

Web UI

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

  1. 进入“退订管理”页面。

    开通了企业组织多级管理服务的客户可以在“退订管理”的下拉选项框中筛选该客户下各个子组织的名称,查询各子组织的可退订记录。

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

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

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

  4. 查看退订信息,退订资源。

    • 5天无理由全额退订:确认退订信息,单击“退订”。

    • 非5天无理由退订:勾选“我已确认本次退订将收取手续费”后,单击“退订”。

REST API

客户在伙伴销售平台完成包年/包月资源的退订。

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

  • 该接口只允许使用客户AK/SK或者Token调用,不允许使用合作伙伴AK/SK或者Token调用。因为目前合作伙伴不能自己买产品,所以没有自己的包年/包月产品。
  • 目前支持退订的云服务类型参见续订或退订包年/包月资源支持的云服务类型
  • 调用接口后,如果某个主资源ID有对应的从资源ID,系统会将主资源ID和从资源ID一起退订,存在主从资源关系的资源为:
    • 云主机为主资源,对应的从资源为云硬盘
    • 共享带宽的情况下,带宽为主资源,对应的从资源为弹性IP(可能包含多个IP)
    • 独享带宽的情况下,弹性IP为主资源,对应的从资源为带宽
  • 调用该接口后,您还可以调用“查询退款订单的金额详情”接口查询退订订单对应的金额来自哪些订单。
  • 该接口支持5天无理由全额退订,具体规则请参见“退订规则说明”。

  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>

    列表最大长度:10

    资源ID列表。

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

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

    unSubType

    Integer

    [1-2]

    退订类型,取值如下:

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

    unsubscribeReasonType

    Integer

    [1-5]

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

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

    unsubscribeReason

    String

    最大长度:512

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

    请求示例

    POST https://bss.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": "Success",
        "orderIds": ["xxxxxxxxxx"]
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0100

    参数错误。

    CBC.0151

    访问拒绝。

    CBC.0999

    其他错误。

    CBC.3001

    资源已过期。

    CBC.3002

    资源被锁定。

    CBC.3004

    资源存在依赖。

    CBC.3005

    资源正在开通。

    CBC.3006

    云服务类型不支持。

    CBC.3128

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

    CBC.3185

    云服务必须整体退订。

    CBC.3640

    有加油包的资源,不能退订。

    CBC.5042

    资源无法找到。

    CBC.7281

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

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问