退订包年/包月资源

功能介绍

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

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

Web UI

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

进入“退订管理”页面。

开通了企业组织多级管理服务的客户可以在“退订管理”的下拉选项框中筛选该客户下各个子组织的名称，查询各子组织的可退订记录。
单击“创建成功资源退订”页签。
单个资源退订与批量退订可使用不同的操作方式：
- 退订单个资源：单击待退订资源所在行的“退订资源”。
- 批量退订：在退订列表中勾选需要退订的资源，单击列表左上角的“退订资源”。
查看退订信息，退订资源。
- 5天无理由全额退订：确认退订信息，单击“退订”。
- 非5天无理由退订：勾选“我已确认本次退订将收取手续费”后，单击“退订”。

REST API

客户在自建平台完成包年/包月资源的退订。

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

该接口只允许使用客户AK/SK或者Token调用。
调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起退订，存在主从资源关系的资源为：
- 云主机为主资源，对应的从资源为云硬盘
- 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）
- 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽
该接口支持5天无理由全额退订，具体规则请参见“退订规则说明”。

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：其他
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-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": "Success",
    "orderIds": ["xxxxxxxxxx"]
}

状态码

状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

状态码	描述
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	您的账号已被冻结，无法续订/退订。