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

冻结客户账号(旧)

功能介绍

伙伴可以冻结转售类客户账号。

该接口即将下线,“冻结客户账号”新接口请参考冻结客户账号

Web UI

转售类客户关联合作伙伴时,默认冻结客户账号,冻结状态下客户无法新购、续订、变更资源,也无法正常使用资源,合作伙伴可以在为客户设置预算时勾选“同步解冻客户账号”,为客户解除账号冻结。

伙伴还可以在“我的客户”页面冻结转售类客户账号。

  1. 使用合作伙伴账号登录华为云
  2. 单击页面右上角账号下拉框中的“伙伴中心”,进入伙伴中心。
  3. 在左侧导航栏中选择“客户业务 > 我的客户”。
  4. 在“客户列表”中选择客户后,单击“操作”列的“冻结账号”,进入冻结账号页面。

  5. 输入“冻结原因”。
  6. 单击“获取邮箱验证码”,获取并输入验证码。
  7. 单击“确认”。

    系统提示冻结账号成功的信息。

    客户账号冻结后,合作伙伴可以单击“操作”列的“解冻账号”为客户解冻账号。

REST API

伙伴在伙伴销售平台可以冻结转售类客户账号,冻结状态下客户无法新购、续订、变更资源,也无法正常使用资源。

该接口只允许使用合作伙伴AK/SK或者Token调用。

  1. URI

    POST /v1.0/{partner_id}/partner/customer-mgr/frozens

    参数说明请参见下表。

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

    此参数暂不校验。

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customerIds

    List<String>

    最大个数:10

    需要冻结的客户ID列表。

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

    reason

    String

    最大长度:256

    冻结原因。

    请求示例

    POST https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/frozens HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ 
    
    {
    	"customerIds": [
    		"06502440a080d5e90f44c01cbccfa280",
    		"065faa30c880d5ce0fddc007a6cb6f40"
    	],
    	"reason": "Arrears"
    }

  1. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:16

    状态码。成功或者部分失败的时候该字段不存在。

    具体请参见4

    error_msg

    String

    最大长度:1024

    错误描述信息。成功或者部分失败的时候该字段不存在。

    failDetail

    list<ErrorDetail>

    -

    错误原因,只有部分失败的时候才返回。

    具体请参见表1

    failNum

    Integer

    -

    失败个数,只有成功或者部分失败的时候才返回。

    successNum

    Integer

    -

    成功个数,只有成功或者部分失败的时候才返回。

    表1 ErrorDetail

    参数

    是否必选

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:16

    返回码。

    具体请参见表2

    error_msg

    String

    最大长度:1024

    返回码的描述信息。

    id

    String

    最大长度:256

    标示ID。该接口对应的是customerId。

    表2 部分失败错误码

    错误码

    描述

    CBC.0999

    其他错误。

    CBC.5004

    无对该客户的操作权限。

    CBC.5024

    客户的关联类型不允许调用该接口。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time
    
    {
    	"failNum": 0,
    	"successNum": 2,
    	"failDetail": []
    }

  1. 状态码
    • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
    • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

    HTTP状态码

    错误码

    错误描述

    500

    CBC.0999

    其他错误。

    400

    CBC.0100

    参数错误。

    403

    CBC.0150

    非法操作。

    400

    CBC.5004

    无对该客户的操作权限。