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

查询客户预算调整记录-ListSubCustomerBudgetRecords

功能介绍

伙伴可以查询客户的预算调整记录。

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

接口约束

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

调试

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

授权信息

接口对应的权限项如下：

权限项

权限项名称

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

URI

GET /v2/partners/sub-customers/budget/records

参数说明请参见下表。

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

customer_id

是

String

最大长度：64

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

indirect_partner_id

否

String

最大长度：64

云经销商ID。获取方法请参见查询云经销商列表-ListIndirectPartners。如果华为云总经销商（一级经销商），需要查询云经销商的子客户预算设置历史记录，必须携带该字段。

operation_type

否

String

最大长度：10

操作类别。

  • SETTING：设置
  • DELETE：解除关联关系

此参数不携带时，查询所有类型数据。此参数携带值不支持为空或者空串。

budget_type

否

String

最大长度：10

预算模式。

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

此参数不携带时，查询所有类型数据。此参数携带值不支持为空或者空串。

offset

否

Integer

[0-最大整数]

偏移量，从0开始。默认值为0。

说明：

offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。

示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。

示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。

limit

否

Integer

[1-100]

每次查询的数量，默认值为10。

请求消息

请求参数

无。

请求示例

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

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度：20

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

error_msg

String

最大长度：2000

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

total_count

Integer

-

返回总条数。

measure_id

Integer

-

金额单位。

1：元

currency

String

最大长度：4

币种。

USD：美金

record_list

List<BudgetRecordInfo>

最大长度：100

客户预算信息。具体参见表2
表2 BudgetRecordInfo

参数

参数类型

取值范围

描述

budget_amount

BigDecimal

[0-2147483647]

预算金额。

operation_type

String

最大长度：10

操作类别。

  • SETTING：设置
  • DELETE：解除关联关系

operation_time

String

最大长度：20

操作时间。

UTC时间，格式为：yyyy-MM-ddTHH:mm:ssZ

operator

String

最大长度：64

操作员或系统system。

budget_type

String

最大长度：10

预算模式：

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

partner_corp_name

String

最大长度：256

伙伴名称。

说明：

如果预算是由云经销商设置，此处为云经销商伙伴名称。

partner_account_name

String

最大长度：128

伙伴账号名。

说明：

如果预算是由云经销商设置，此处为云经销商伙伴账号名。
响应示例 
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "total_count": 100,
    "measure_id": 1,
    "currency": "USD",
    "record_list":[     
      {              
          "budget_amount": 2147483647,       
          "operation_type": "SETTING",       
          "operation_time": "yyyy-MM-ddTHH:mm:ssZ",       
          "operator": "Op*****01",       
          "budget_type": "MONTHLY",
          "partner_corp_name":"ji********companny",
          "partner_account_name":"ji********_hk"    
       }   
     ]
}

状态码

  • 状态码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

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