Freezing a Customer Account
Function
A partner can freeze an account of a customer associated with the partner by reseller model.
Visit Freezing a Customer Account to learn about how to freeze a customer account.
Constraints
This API can be invoked using the partner AK/SK or token only.
URI
POST /v2/partners/sub-customers/freeze
Request
Request Parameters
Parameter |
Mandatory |
Type |
Value Range |
Description |
---|---|---|---|---|
customer_ids |
Yes |
List<String> |
A maximum of 10 IDs |
IDs of customers whose accounts are to be frozen. You can call the API in Querying Customers to obtain the customer ID. |
reason |
Yes |
String |
A maximum of 256 characters |
Account freezing reason. |
Example Request
POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/freeze HTTP/1.1 Content-Type: application/json X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_ids": [ "065024********e90f44c01cbccfa280", "065faa********ce0fddc007a6cb6f40" ], "reason": "Arrears" }
Response
Parameter |
Type |
Value Range |
Description |
---|---|---|---|
error_code |
String |
A maximum of 20 characters |
Error code. This field is not returned when the operation is successful or partially failed. For details, see Returned Values. |
error_msg |
String |
A maximum of 2,000 characters |
Error description. This field is not returned when the operation is successful or partially failed. |
error_details |
List<ErrorDetail> |
- |
Error cause description. This field is returned only when the operation is partially failed. For details, see Table 1. |
Parameter |
Type |
Value Range |
Description |
---|---|---|---|
error_code |
String |
A maximum of 20 characters |
Error code. For details, see Returned Values. The returned status code is 200. |
error_msg |
String |
A maximum of 2,000 characters |
Error message. |
id |
String |
A maximum of 256 characters |
ID. This parameter corresponds to customer_ids. |
Example Response
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_details":[] }
Returned Values
HTTP Value |
Error Code |
Description |
---|---|---|
400 |
CBC.0100 |
Parameter error. |
400 |
CBC.99000000 |
You do not have the operation permission to this customer. |
400 |
CBC.99005024 |
This API cannot be invoked because the association type of the customer is incorrect. |
403 |
CBC.0150 |
Invalid operation. |
403 |
CBC.0151 |
Access denied. |
500 |
CBC.0999 |
Other errors. |
