退订包年/包月资源(旧)
功能介绍
客户购买包年/包月资源后,支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分,退订后资源将无法使用。
该接口即将下线,“退订包年/包月资源”新接口请参考退订包年/包月资源。
Web UI
客户可在费用中心退订已购买的包年/包月资源。
- 进入“退订管理”页面。
- 单击“创建成功资源退订”页签。
- 单个资源退订与批量退订可使用不同的操作方式:
- 查看退订信息,勾选“我已确认本次退订金额和相关费用”后,单击“退订”。
REST API
客户在自建平台完成包年/包月资源的退订。
首先要成功支付包年/包月产品,产生一条开通成功的包年/包月资源,才能进行退订。
- 该接口只允许使用客户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的列表信息。
响应示例
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
已冻结,不能执行此操作。