客户运营能力客户运营能力

更新时间:2021/09/08 GMT+08:00
分享

退订包年/包月资源

功能介绍

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

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

  • 首先要成功支付包年/包月产品,产生一条开通成功的包年/包月资源,才能进行退订。
  • 调用接口后,如果某个主资源有对应的从资源,系统会将主资源和从资源一起退订,主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。
  • 注意:如ECS主机挂载新购的云硬盘,但此硬盘不是该ECS主资源的从资源,主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。
  • 该接口支持5天无理由全额退订,具体规则请参见“退订规则说明”。

接口约束

该接口只允许使用客户AK/SK或者Token调用

调试

您可以在API Explorer中直接运行调试该接口。

URI

POST /v2/orders/subscriptions/resources/unsubscribe

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

resource_ids

List<String>

列表最大长度:10

资源ID列表。

最大支持1次性输入10个资源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.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的列表信息。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
  "order_ids": [
    "CS19040119281JMYC"
  ]
}

状态码

HTTP状态码

错误码

描述

400

CBC.0100

参数错误。

400

CBC.7281

您的账号已被冻结,无法续订/退订。

400

CBC.99003001

资源已过期。

400

CBC.99003002

资源被锁定。

400

CBC.99003004

资源存在依赖。

400

CBC.99003005

资源正在开通。

400

CBC.99003006

云服务类型不支持。

400

CBC.99003100

当前操作的资源中,有资源包含在您的待支付的订单,不能进行当前操作。

400

CBC.99003124

订单已退订,请勿重复退订。

400

CBC.99003128

资源无已续费周期或续费周期已生效,不支持退订续费周期。

400

CBC.99003144

您有处理中的订单,不能进行当前操作。

400

CBC.99003185

云服务必须整体退订。

400

CBC.99003640

有加油包的资源,不能退订。

400

CBC.99003652

软开云套餐不能退订。

400

CBC.99005042

资源无法找到或者不能退订。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品