更新时间：2021/06/24 GMT+08:00
退订包年/包月资源
功能介绍
客户购买包年/包月资源后，支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分，退订后资源将无法使用。
Web UI
客户可在费用中心退订已购买的包年/包月资源。
- 进入“退订管理”页面。
开通了企业组织多级管理服务的客户可以在“退订管理”的下拉选项框中筛选该客户下各个子组织的名称，查询各子组织的可退订记录。
- 单击“创建成功资源退订”页签。
- 单个资源退订与批量退订可使用不同的操作方式：
- 查看退订信息，退订资源。
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>
列表最大长度：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的列表信息。
响应示例
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"] }
父主题： 管理包年/包月资源
