Setting Customers' Budgets

Function

This API is used to set or adjust a customer's budget.

This API will be brought offline. For details about the new API for setting customers' budgets, see Setting Customers' Budgets.

Web UI

You can log in to the Partner Center to set the budgets your customers.

Use your partner account to log in to Huawei Cloud.
In the upper right corner, choose Partner Center from the drop-down list of your account name to go to the Partner Center.
In the navigation pane, choose Customer Business > Customer Management.
On the displayed page, select the target customer, and click Set Monthly Budget in the Operation column.
Enter a value and click OK.
A message indicating that the monthly budget has been set successfully is displayed.

If partners have enabled the verification code function, a verification code is required.
Click OK.

REST API

You can use REST APIs to set customers' budgets on your sales platform.

This API can be invoked only by the partner account AK/SK or token.

URI

POST /v1.0/{partner_id}/partner/account-mgr/credit

The following table describes the parameters.

Parameter	Mandatory	Value Range	Description
partner_id	Yes	A maximum 64 characters	Partner ID (assigned by Huawei). For details about how to obtain the partner ID, see How Do I Check the Partner ID?

Parameter

Mandatory

Value Range

Description

partner_id

Yes

A maximum 64 characters

Partner ID (assigned by Huawei).

For details about how to obtain the partner ID, see How Do I Check the Partner ID?

Request

Request Parameters

Parameter	Mandatory	Type	Value Range	Description
customerId	Yes	String	A maximum 64 characters	Customer account ID. For details, see How Do I Obtain Customer's customer_id and domain_id Values?
adjustmentAmount	Yes	Double	-	New budget, which can be accurate to two decimal places.
measureId	Yes	Integer	-	Unit: 1: dollar
cancelPartnerFrozen	No	String	1	Whether to unfreeze the account when setting the customer budget. 0: No 1: Yes The default value is 0. If this parameter is not included in the request parameters, is set to "", or is set to null, the default value 0 is used.

Example Request

POST https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/credit HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "customerId": "c8c346e9d924403c9e87c1cfe9b0b13f",
    "adjustmentAmount": 2000,
    "measureId": 1
}

Response

Response Parameters

Parameter	Mandatory	Type	Value Range	Description
error_code	No	String	A maximum of 16 characters	Error code. For details, see 4. This parameter is returned only when a failure occurs.
error_msg	No	String	A maximum of 1024 characters	Error description. This parameter is returned only when a failure occurs.

Example Response

HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time

Returned Values

4xx: This class of HTTP status code is intended for situations in which the error seems to have been caused by the client, for example, the request contains bad syntax or incorrect parameters. You must ensure the request is correct.
5xx: This class of HTTP status code is intended for cases in which the Huawei Cloud server is aware that it has encountered an error or is otherwise incapable of performing the request. In this case, contact Huawei Cloud customer service.

HTTP Status Code	Error Code	Description
400	CBC.0100	Parameter error.
403	CBC.0151	Access denied.
403	CBC.0150	Invalid operation.
500	CBC.0999	Other errors.
500	CBC.5024	This API cannot be invoked because the association type of the customer is incorrect.
500	CBC.50000036	Setting budgets for customers is not allowed because the partner is now in the credit control state.