更新时间:2024-09-26 GMT+08:00

退订包年/包月资源

功能介绍

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

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

  • 首先要成功支付包年/包月产品,产生一条开通成功的包年/包月资源,才能进行退订。
  • 调用接口后,如果某个主资源有对应的从资源,系统会将主资源和从资源一起退订,主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
  • 注意:如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]

退订类型,取值如下:

  • 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-TokenMIIPAgYJKoZIhvcNAQcCo...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

其他错误。