文档首页/ 合作伙伴中心/ API参考/ 待下线接口/ 管理交易/ 管理包年/包月资源/ 退订包年/包月资源（旧）
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

退订包年/包月资源（旧）

功能介绍

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

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

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>

    [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.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/delete HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...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

    已冻结，不能执行此操作。

相关文档