退订包年/包月资源
功能介绍
客户购买包年/包月资源后,支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分,退订后资源将无法使用。
客户在费用中心退订已购买的包年包月资源请参见这里。
- 首先要成功支付包年/包月产品,产生一条开通成功的包年/包月资源,才能进行退订。
- 调用接口后,如果某个主资源有对应的从资源,系统会将主资源和从资源一起退订,主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
- 注意:如ECS主机挂载新购的云硬盘,但此硬盘不是该ECS主资源的从资源,主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。
- 您正在退订使用中的资源,请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复,若您要保留资源,仅退订未使用的续费周期,请退订续费周期。
接口约束
该接口只允许使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/orders/subscriptions/resources/unsubscribe
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
resource_ids |
是 |
List<String> |
列表最大长度:10 |
资源ID列表。 最大支持1次性输入10个资源ID,只能输入主资源ID和与其有关联关系的子资源ID。整机场景下只能输入主资源ID。 哪些资源是主资源请根据“查询客户包年/包月资源列表”接口响应参数中的“is_main_resource”来标识。 |
unsubscribe_type |
是 |
Integer |
[1-2] |
退订类型,取值如下:
|
unsubscribe_reason_type |
否 |
Integer |
[1-5] |
退订理由分类,取值如下:
|
unsubscribe_reason |
否 |
String |
最大长度:512 |
退订原因,一般由客户输入。 |
请求示例
POST https://bss-intl.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 |
状态码。 具体请参见状态码。 |
error_msg |
String |
错误描述信息。 |
order_ids |
List<String> |
客户退订订单ID的列表信息。 |
fail_resource_infos |
List<FailResourceInfo> |
失败的资源信息列表。有退订失败的资源时,该字段才有值。具体请参见表FailResourceInfo。 该字段为预留字段。 |
表 FailResourceInfo
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
状态码。 具体请参见状态码。 该字段为预留字段。 |
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":[] }
状态码
- 状态码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.99003652 |
软开云套餐不能退订。 |
400 |
CBC.99003654 |
存在带宽加油包,不允许退订续费周期。 |
400 |
CBC.99003656 |
已冻结,不能执行此操作。 |
400 |
CBC.99006066 |
查询费用信息错误。 |
403 |
CBC.0151 |
访问拒绝。 |
400 |
CBC.99003651 |
交易正在进行中,不可以退订。 |
500 |
CBC.0999 |
其他错误。 |