更新时间:2025-07-28 GMT+08:00

查询客户预算调整记录

功能介绍

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

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

接口约束

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

调试

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

URI

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

参数说明请参见下表。

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

customer_id

String

最大长度:64

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

indirect_partner_id

String

最大长度:64

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

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-TokenMIIPAgYJKoZIhvcNAQcCo...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

其他错误。