更新时间:2024-08-27 GMT+08:00

解冻客户账号

功能介绍

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

伙伴登录合作伙伴中心解冻客户账号请参见这里

解冻类型要与账号当前冻结类型一致,否则解冻失败。

接口约束

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

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/partners/sub-customers/unfreeze

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_ids

List<String>

最大个数:10

需要解冻的客户账号ID列表。

您可以调用查询客户列表接口获取customer_id。

reason

String

最大长度:256

解冻原因。

indirect_partner_id

String

最大长度:64

云经销商ID。获取方法请参见查询云经销商列表。如果需要解冻云经销商的子客户,必须携带该字段。除此之外,此参数不做处理。

unfreeze_type

String

-

解冻类型。

  • ACCOUNT:解冻账号
  • ACCOUNT_AND_RESOURCE:解冻账号与资源

默认值:ACCOUNT

此参数不携带、为null时取默认值,不支持空串,有枚举校验。

请求示例

POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/unfreeze HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
	"customer_ids": [
		"065024********e90f44c01cbccfa280",
		"065faa********ce0fddc007a6cb6f40"
	],
	"reason": "The customer has topped up its account.",
        "indirect_partner_id": "0b5e9b********0c0f0fc00874a9e000",
        "unfreeze_type": "ACCOUNT"
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

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

具体请参见状态码

error_msg

String

最大长度:2000

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

error_details

List<ErrorDetail>

-

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

具体请参见表1

表1 ErrorDetail

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

返回码。具体请参见状态码

注意,此时返回的状态码全部为200。

error_msg

String

最大长度:2000

返回码的描述信息。

id

String

最大长度:256

标识ID。该参数对应的是customer_ids。

响应示例

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

状态码

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

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.99000000

无对该客户的操作权限。

400

CBC.99000035

非合作伙伴子客户。

400

CBC.99000037

您没有操作该云经销商的权限。

200

CBC.99005024

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

200

CBC.50000053

解冻类型与客户实际的冻结类型不一致,解冻客户账号失败。

403

CBC.0150

非法操作。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。