# 退订包年/包月资源-CancelResourcesSubscription
#### 功能介绍
客户购买包年/包月资源后，支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分，退订后资源将无法使用。
客户在费用中心退订已购买的包年包月资源请参见[这里](https://support.huaweicloud.com/usermanual-billing/zh-cn_topic_0083138805.html)。
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。
- 调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起退订，主资源的从资源信息可以通过调用[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-bpconsole/api_order_00021.html)接口获取。
- 注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-bpconsole/api_order_00021.html)接口获取的信息为准。
- 调用该接口后，您还可以调用"[查询退款订单的金额详情-ShowRefundOrderDetails](https://support.huaweicloud.com/api-bpconsole/api_order_00020.html)"接口查询退订订单对应的金额来自哪些订单。
- 该接口支持5天无理由全额退订，具体规则请参见"[退订规则说明](https://support.huaweicloud.com/usermanual-billing/unsubscription_topic_20000081.html)"。
- 您正在退订使用中的资源，请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复，若您要保留资源，仅退订未使用的续费周期，请退订续费周期。
 
#### 接口约束
该接口只允许使用客户AK/SK或者Token调用，不允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。因为目前解决方案提供商或华为云总经销商（一级经销商）的不能自己买产品，所以没有自己的包年/包月产品。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=CancelResourcesSubscription)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
伙伴操作员账号无法调用当前API。
#### URI
POST /v2/orders/subscriptions/resources/unsubscribe
#### 请求消息
请求参数
| 参数                      | 是否必选 | 参数类型           | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| resource_ids            | 是    | List\<String\> | **参数解释：** 资源ID列表。 **约束限制：** 最大支持1次性输入10个资源ID，只能输入主资源ID和与其有关联关系的子资源ID。整机场景下只能输入主资源ID。哪些资源是主资源请根据"[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-bpconsole/api_order_00021.html)"接口响应参数中的"is_main_resource"来标识。 **取值范围：** \[1-10\] **默认取值：** 不涉及                                                                                                                                                                              |
| unsubscribe_type        | 是    | Integer        | **参数解释：** 退订类型。 **约束限制：** 不涉及 **取值范围：** - 1：退订资源及其已续费周期。  - 2：只退订资源已续费周期，不退订资源。   **默认取值：** 不涉及                                                                                                                                                                                                                                               |
| unsubscribe_reason_type | 否    | Integer        | **参数解释：** 退订理由分类。 **约束限制：** 不涉及 **取值范围：** - 1：产品不好用  - 2：产品功能无法满足需求  - 3：不会操作/操作过于复杂  - 4：对服务不满意  - 5：其他   **默认取值：** 不涉及 |
| unsubscribe_reason      | 否    | String         | **参数解释：** 退订原因，一般由客户输入。 **约束限制：** 不涉及 **取值范围：** 最大长度：512 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
请求示例
```
POST https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/unsubscribe HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "resource_ids": [
    "21e09f37c5c9420c8746ad5c71fb3aab"
  ],
  "unsubscribe_type": 1,
  "unsubscribe_reason_type": 5,
  "unsubscribe_reason": "test"
}
```
#### 响应消息
响应参数
| 参数                  | 参数类型                     | 描述                                                                                                                                                                                                                                               |
|:---|:---|:---|
| error_code          | String                   | **参数解释：** 状态码。 具体请参见[状态码](https://support.huaweicloud.com/api-bpconsole/api_order_00019.html#api_order_00019__section912695313337)。                                          |
| error_msg           | String                   | **参数解释：** 错误描述信息。                                                                                                                                                                                             |
| order_ids           | List\<String\>           | **参数解释：** 客户退订订单ID的列表信息。                                                                                                                                                                                        |
| fail_resource_infos | List\<FailResourceInfo\> | **参数解释：** 失败的资源信息列表。有退订失败的资源时，该字段才有值。具体请参见[表FailResourceInfo](https://support.huaweicloud.com/api-bpconsole/api_order_00019.html#api_order_00019__table173001375312)。 该字段为预留字段。 |
   
表 FailResourceInfo
 
| 参数          | 参数类型   | 描述                                                                                                                                                                                                                                              |
|:---|:---|:---|
| error_code  | String | **参数解释：** 状态码。 具体请参见[状态码](https://support.huaweicloud.com/api-bpconsole/api_order_00019.html#api_order_00019__section912695313337)。 该字段为预留字段。 |
| error_msg   | String | **参数解释：** 错误描述信息。 该字段为预留字段。                                                                                                                                                   |
| resource_id | String | **参数解释：** 资源ID。 该字段为预留字段。                                                                                                                                                   |
   
响应示例
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
  "order_ids": [
    "CS19040119281JMYC"
  ],
  "fail_resource_infos":[]
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 描述                                |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。                             |
| 400     | CBC.30000053 | 资源计费模式是节省计划，不支持退订。                |
| 400     | CBC.30000067 | 资源已被删除或者资源未被纳管，不支持退订。             |
| 400     | CBC.99003012 | 资源ID不存在。                          |
| 400     | CBC.99003100 | 当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。 |
| 400     | CBC.99003128 | 资源无已续费周期或续费周期已生效，不支持退订续费周期。       |
| 400     | CBC.99003185 | 云服务必须整体操作。                        |
| 400     | CBC.99003643 | 已开发票的云服务不允许退订                     |
| 400     | CBC.99003647 | 该按需套餐包不支持退订。                      |
| 400     | CBC.99003649 | 试用云服务不支持退订。                       |
| 400     | CBC.99003650 | 云商店中的该云服务不能退订。                    |
| 400     | CBC.99003651 | 交易正在进行中，不可以退订。                    |
| 400     | CBC.99003652 | 软开云套餐不能退订。                        |
| 400     | CBC.99003654 | 存在带宽加油包，不允许退订续费周期。                |
| 400     | CBC.99003656 | 已冻结，不能执行此操作。                      |
| 400     | CBC.99006066 | 查询费用信息错误。                         |
| 400     | CBC.30010094 | 该产品不支持退订。                         |
| 400     | CBC.30010096 | 专区或联盟订单不支持在当前站点直接操作，请到对应站点操作。     |
| 403     | CBC.0151     | 访问拒绝。                             |
| 500     | CBC.0999     | 其他错误。                             |