# 退订包年/包月资源（旧） #### 功能介绍 客户购买包年/包月资源后，支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分，退订后资源将无法使用。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口即将下线，"退订包年/包月资源"新接口请参考[退订包年/包月资源-CancelResourcesSubscription](https://support.huaweicloud.com/api-bpconsole/api_order_00019.html)。 #### Web UI 客户可在费用中心退订已购买的包年/包月资源。 1. 进入"[退订管理](https://account.huaweicloud.com/usercenter/#/userindex/retreatManagement)"页面。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 开通了企业组织多级管理服务的客户可以在"退订管理"的下拉选项框中筛选该客户下各个子组织的名称，查询各子组织的可退订记录。 2. 单击"创建成功资源退订"页签。 3. 单个资源退订与批量退订可使用不同的操作方式： - 退订单个资源：单击待退订资源所在行的"退订资源"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0162960580.png "点击放大") - 批量退订：在退订列表中勾选需要退订的资源，单击列表左上角的"退订资源"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0162960576.png "点击放大") 4. 查看退订信息，退订资源。 - 5天无理由全额退订：确认退订信息，单击"退订"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0162960602.png "点击放大") - 非5天无理由退订：勾选"我已确认本次退订将收取手续费"后，单击"退订"。 ![](https://support.huaweicloud.com/api-bpconsole/zh-cn_image_0162960572.png "点击放大") #### REST API 客户在伙伴销售平台完成包年/包月资源的退订。 首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 该接口只允许使用客户AK/SK或者Token调用，不允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。因为目前解决方案提供商或华为云总经销商（一级经销商）不能自己买产品，所以没有自己的包年/包月产品。 - 调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起退订，存在主从资源关系的资源为： - 云主机为主资源，对应的从资源为云硬盘 - 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP） - 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽 - 调用该接口后，您还可以调用"[查询退款订单的金额详情](https://support.huaweicloud.com/api-bpconsole/api_order_00020.html)"接口查询退订订单对应的金额来自哪些订单。 - 该接口支持5天无理由全额退订，具体规则请参见"[退订规则说明](https://support.huaweicloud.com/usermanual-billing/zh-cn_topic_0083138805.html)"。 1. URI POST /v1.0/{domain_id}/common/order-mgr/resources/delete 参数说明请参见下表。 表1URI参数说明 | 参数 | 是否必选 | 取值范围 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | 最大长度：64 | 客户账号ID。获取方法请参见[如何获取客户的customer_id/domain_id](https://support.huaweicloud.com/api-bpconsole/offl_110002.html)。 | 2. 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | resourceIds | 是 | List\ | \[1-10\] | 资源ID列表。 最大支持1次性输入10个资源ID，只能输入主资源ID。 哪些资源是主资源请根据"[查询客户包年/包月资源列表（旧）](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0084961226.html)"接口响应参数中的"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" } ``` 3. 响应消息 响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 状态码。 具体请参见[4]。 | | error_msg | String | 错误描述信息。 | | orderIds | List\ | 客户退订订单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"] } ``` 4. 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码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 | 已冻结，不能执行此操作。 | | 400 | CBC.30010094 | 该产品不支持退订。 |