退订包年/包月资源

功能介绍

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

客户在费用中心退订已购买的包年包月资源请参见这里。

首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。
调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起退订，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。
调用该接口后，您还可以调用“查询退款订单的金额详情”接口查询退订订单对应的金额来自哪些订单。
您正在退订使用中的资源，请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复，若您要保留资源，仅退订未使用的续费周期，请退订续费周期。

接口约束

该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴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]	退订类型，取值如下： 1：退订资源及其已续费周期。 2：只退订资源已续费周期，不退订资源。
unsubscribe_reason_type	否	Integer	[1-5]	退订理由分类，取值如下： 1：产品不好用 2：产品功能无法满足需求 3：不会操作/操作过于复杂 4：对服务不满意 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。该字段为预留字段。

参数

参数类型

描述

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	其他错误。