Help Center > > API Reference> Transaction Management> Managing Customers' Budgets> Querying Customers' Budgets

Querying Customers' Budgets

Updated at: Jun 17, 2021 GMT+08:00

Function

This API is used to query the budget of a customer for the partner to determine whether to adjust the budget.

Click here to learn about how to query the budget of a customer.

Constraints

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

URI

GET /v2/partners/sub-customers/budget

The following table describes the parameters.

Table 1 Query parameters

Parameter

Mandatory

Type

Value Range

Description

customer_id

Yes

String

Maximum length: 64 characters

Customer account ID. You can call the API in Querying Customers to obtain the customer ID.

Request

Request Parameters

None

Example Request

GET https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/budget?customer_id=06ffbcd46880d3f30f62c001a49be460 HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

Response

Response Parameters

Parameter

Type

Value Range

Description

error_code

String

Maximum length: 20 characters

Error code. For details, see Returned Values. This parameter is returned only when a failure occurs.

error_msg

String

Maximum length: 2000 characters

Error description. This parameter is returned only when a failure occurs.

budget_amount

BigDecimal

-

Initial budget.

used_amount

BigDecimal

-

Used budget. The data displayed in the system may have certain deviation and latency.

measure_id

Integer

-

Unit:

1: dollar

currency

String

Maximum length: 4 characters

Currency:

USD

Example Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "budget_amount": 50.0,
    "used_amount": 1.0,
    "measure_id": 1,
    "currency": "USD"
}

Returned Values

HTTP Value

Error Code

Description

400

CBC.0100

Parameter error.

400

CBC.99005024

This API cannot be invoked because the association type of the customer is incorrect.

403

CBC.0151

Access denied.

403

CBC.0150

Invalid operation.

500

CBC.0999

Other errors.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel