查询客户预算调整记录
接口约束
该接口只允许使用解决方案提供商或华为云总经销商(一级经销商)的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/partners/sub-customers/budget/records
参数说明请参见下表。
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
customer_id |
是 |
String |
最大长度:64 |
客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
indirect_partner_id |
否 |
String |
最大长度:64 |
云经销商ID。获取方法请参见查询云经销商列表。如果华为云总经销商(一级经销商),需要查询云经销商的子客户预算设置历史记录,必须携带该字段。 |
operation_type |
否 |
String |
最大长度:10 |
操作类别。
此参数不携带时,查询所有类型数据。此参数携带值不支持为空或者空串。 |
budget_type |
否 |
String |
最大长度:10 |
预算模式。
此参数不携带时,查询所有类型数据。此参数携带值不支持为空或者空串。 |
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 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
budget_amount |
BigDecimal |
[0-2147483647] |
预算金额。 |
operation_type |
String |
最大长度:10 |
操作类别。
|
operation_time |
String |
最大长度:20 |
操作时间。 UTC时间,格式为:yyyy-MM-ddTHH:mm:ssZ |
operator |
String |
最大长度:64 |
操作员或系统system。 |
budget_type |
String |
最大长度:10 |
预算模式:
|
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 |
其他错误。 |