文档首页/ 合作伙伴中心/ API参考/ 管理交易/ 管理客户预算/ 设置客户预算-UpdateSubCustomerBudget
更新时间：2026-03-24 GMT+08:00
查看PDF
分享

设置客户预算-UpdateSubCustomerBudget

功能介绍

当伙伴需要首次设置或调整客户预算大小时，可调用此接口完成客户预算的设置。首次设置，未指定超预算时冻结类型，则默认为手动冻结。

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

华为云总经销商（一级经销商）需为云经销商授权对其拓展的子客户设置预算的权限，才可为云经销商子客户设置预算。

具体操作步骤详见为云经销商授权对其拓展的子客户设置预算的权限。

接口约束

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

调试

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

授权信息

接口对应的权限项如下：

权限项

权限项名称

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

URI

POST /v2/partners/sub-customers/budget

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

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

budget_amount

是

BigDecimal

(0-2147483647]

调整的目标金额。

单位：元。精确至小数点后2位。

cancel_partner_frozen

否

String

-

是否在设置客户预算的同时解除账号冻结：

  • 0：否
  • 1：是

默认值为0。

此参数不携带或携带值为空串或携带值为null时，默认为0。

indirect_partner_id

否

String

最大长度：64

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

budget_type

否

String

-

预算模式：

  • MONTHLY：月度预算
  • PACKAGE：一次性预算

默认值为MONTHLY。

此参数不携带或携带值为null时，默认为MONTHLY。此参数携带值不支持空串。

frozen_operate_type

否

Integer

   

设置超预算时是否自动冻结

此参数不携带或携带值为null或携带值为空时，字段不生效。

请求示例

POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/budget HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "customer_id": "053a48736500d5f40ffec01689b88480",
    "budget_amount": 100,
    "cancel_partner_frozen": 0,
    "indirect_partner_id": "0b5e9b********0c0f0fc00874a9e000",
    "budget_type":"MONTHLY",
    "frozen_operate_type": 0
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度：20

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

error_msg

String

最大长度：2000

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

响应示例

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

状态码

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

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.50000030

云经销商预算额度已不足，无法进行设置预算。

400

CBC.50000033

您授权云经销商预算设置权限已取消，云经销商无法进行预算设置。

400

CBC.99000000

无对该客户的操作权限。

400

CBC.99000037

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

400

CBC.99005024

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

403

CBC.0151

访问拒绝。

403

CBC.0150

非法操作。

500

CBC.0999

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