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

功能介绍

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

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

Web UI

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

进入“退订管理”页面。
单击“创建成功资源退订”页签。
单个资源退订与批量退订可使用不同的操作方式：
- 退订单个资源：单击待退订资源所在行的“退订资源”。
- 批量退订：在退订列表中勾选需要退订的资源，单击列表左上角的“退订资源”。
查看退订信息，勾选“我已确认本次退订金额和相关费用”后，单击“退订”。

REST API

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

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

该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴AK/SK或者Token调用。因为目前合作伙伴不能自己买产品，所以没有自己的包年/包月产品。
调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起退订，存在主从资源关系的资源为：
- 云主机为主资源，对应的从资源为云硬盘
- 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）
- 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽
调用该接口后，您还可以调用“查询退款订单的金额详情”接口查询退订订单对应的金额来自哪些订单。

URI

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

参数说明请参见下表。

表1 URI参数说明
参数	是否必选	取值范围	描述
domain_id	是	最大长度：64	客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
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-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
  "resourceIds": ["53fa7828774df68b","72a256456xdf45g"],
  "unSubType":2,
  "unsubscribeReasonType":2,
  "unsubscribeReason":"xxxxxxx"
}

响应消息

响应参数

参数	参数类型	描述
error_code	String	状态码。具体请参见4。
error_msg	String	错误描述信息。
orderIds	List<String>	客户退订订单ID的列表信息。

参数

参数类型

描述

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"]
}

状态码

状态码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	已冻结，不能执行此操作。