文档首页/ 合作伙伴中心/ API参考/ 管理交易/ 管理客户预算/ 查询客户预算-ShowSubCustomerBudget
更新时间：2025-11-27 GMT+08:00
查看PDF
分享

查询客户预算-ShowSubCustomerBudget

功能介绍

伙伴可以查询客户的预算，用于判断是否需要调整客户预算大小。

伙伴登录伙伴中心查询客户的预算请单击这里。

接口约束

该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。

调试

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

授权信息

接口对应的权限项如下：

权限项

权限项名称

BPC_ITEM_SUBCUSTSERV_010111|BPC_ITEM_SUBCUSTSERV_010503
  • 销售-客户-客户管理-客户列表-调整信用额度
  • 销售-客户-客户管理-二级经销商子客户-设置月度预算

URI

GET /v2/partners/sub-customers/budget

参数说明请参见下表。

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

客户账号ID。您可以调用查询客户列表-ListSubCustomers接口获取customer_id。

indirect_partner_id

否

String

最大长度：64

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

请求消息

请求参数

无。

请求示例

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

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度：20

状态码，具体请参考状态码。只有失败才会返回这个参数。

error_msg

String

最大长度：2000

错误描述信息。只有失败才会返回这个参数。

budget_amount

BigDecimal

-

初始预算金额。

used_amount

BigDecimal

-

已经使用的预算。该预算存在一定的时延和误差。

measure_id

Integer

-

金额单位。

1：元

currency

String

最大长度：4

币种。

USD：美金

budget_type

String

-

预算模式：

MONTHLY：月度预算

PACKAGE：一次性预算

响应示例

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",
    "budget_type":"MONTHLY"
}

状态码

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

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.99000000

无对该客户的操作权限。

400

CBC.99000037

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

400

CBC.99005024

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

403

CBC.0151

访问拒绝。

403

CBC.0150

非法操作。

500

CBC.0999

其他错误。
父主题： 管理客户预算