批量查询客户预算-ListSubCustomerBudget
接口约束
该接口只允许使用解决方案提供商或华为云总经销商(一级经销商)的AK/SK或者Token调用。
调试
您可以在API Explorer 中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
接口对应的权限项如下:
| 权限项 | 权限项名称 |
|---|---|
| BPC_ITEM_ACCOUNT_010500 | 伙伴信息-基本信息-消费配额-查看消费配额 |
URI
POST /v2/partners/sub-customers/budget/query
请求消息
请求参数
| 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|---|
| customer_ids | 是 | List<String> | [1-100] | 客户ID列表,最大支持100个,如果其中有存在不是该伙伴的客户ID或者其中有存在与该伙伴不是转售关联类型的客户ID,在响应中不返回该客户信息。 您可以调用查询客户列表-ListSubCustomers接口获取association_type=3的customer_id。 |
| indirect_partner_id | 否 | String | 最大长度:64 | 云经销商ID。获取方法请参见查询云经销商列表-ListIndirectPartners。如果需要查询云经销商的子客户预算,必须携带该字段。除此之外,此参数不做处理。 |
请求示例
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"], "indirect_partner_id": "0b5e9b********0c0f0fc00874a9e000" }
响应消息
响应参数
| 参数 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|
| error_code | String | 最大长度:20 | 状态码,具体请参考状态码。只有失败才会返回这个参数。 |
| error_msg | String | 最大长度:2000 | 错误描述信息。只有失败才会返回这个参数。 |
| measure_id | Integer | - | 金额单位。 1:元 |
| currency | String | 最大长度:4 | 币种。 USD:美金 |
| budget_infos | List<BudgetInfo> | 最大长度:100 | 客户预算信息。具体参见表 BudgetInfo |
表2 BudgetInfo
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"
}
]
}
