批量查询客户预算
接口约束
该接口只允许使用解决方案提供商或华为云总经销商的AK/SK或者Token调用。调用的时候必须传递解决方案提供商或华为云总经销商的AK/SK或者Token。
调试
您可以在API Explorer 中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/partners/sub-customers/budget/query
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
customer_ids |
是 |
List<String> |
[1-100] |
客户ID列表，最大支持100个，如果其中有存在不是该伙伴的客户ID或者其中有存在与该伙伴不是转售关联类型的客户ID，在响应中不返回该客户信息。 您可以调用查询客户列表接口获取association_type=3的customer_id。 |
|
indirect_partner_id |
否 |
String |
最大长度：64 |
云经销商ID。获取方法请参见查询云经销商列表。如果需要查询云经销商的子客户列表，必须携带该字段。除此之外，此参数不做处理。 |
请求示例
POST https://bss-intl.myhuaweicloud.com/v2/partners/sub-customers/budget/query HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_ids": ["053a48736500d5f40ffec01689b88480"], " }
响应消息
响应参数
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
error_code |
String |
最大长度：20 |
状态码，具体请参考状态码。只有失败才会返回这个参数。 |
|
error_msg |
String |
最大长度：2000 |
错误描述信息。只有失败才会返回这个参数。 |
|
measure_id |
Integer |
- |
金额单位。 1：元 |
|
currency |
String |
最大长度：4 |
币种。 USD：美金 |
|
budget_infos |
List<BudgetInfo> |
最大长度：100 |
客户预算信息。具体参见表 BudgetInfo |
表2 BudgetInfo
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
customer_id |
String |
最大长度：64 |
客户账号ID。 |
|
budget_amount |
BigDecimal |
- |
初始预算金额。 |
|
used_amount |
BigDecimal |
- |
已经使用的预算。该预算存在一定的时延和误差。 |
|
budget_type |
String |
- |
预算模式： MONTHLY：月度预算 PACKAGE：一次性预算 |
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"measure_id": 1,
"currency": "USD",
"budget_infos":[
{
"customer_id":"053a********d5f40ffec01689b88480",
"budget_amount": 50.0,
"used_amount": 1.0,
"budget_type":"MONTHLY"
},{
"customer_id":"053a********d5f40ffec01689b88481",
"budget_amount": 40.0,
"used_amount": 2.0,
"budget_type":"PACKAGE"
}
]
}
