信用额度查询
更新时间：2026-01-29
接口描述
本接口用来查询账户的信用额度信息。
权限说明
请求发起人需要具有合法的 AccessKeyID 和 SecretAccessKey 才能发起请求，请参考鉴权认证。
注意事项
如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden
错误信息：AccessDenied。
请求路径
POST /v1/finance/supervisor/credit/quota
请求结构
Plain Text
1{
2 "accountIds":[]
3}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 参数位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| accountIds | List | requestBody | 需要查询余额的accountId列表，最大长度1000 | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| result | List< SupervisorCreditQuota > | 额度信息列表, 只返回有效的配额信息 |
请求示例
说明：获取授信额度信息列表。
Plain Text
1{
2 "accountIds":["90d8baxxxxxxxxxxxxxxxxxxxxxx05a61"]
3}响应示例
Plain Text
1{
2 "result":[{
3 "accountId":"90d8baxxxxxxxxxxxxxxxxxxxxxx05a61",
4 "accountType":"SUB_ACCOUNT",
5 "loginName":"test_xxx",
6 "ouName":"root",
7 "comment":"测试",
8 "quota":999999999999.0000,
9 "remainQuota":999999999999.0000,
10 "beginTime":"2022-12-14T16:00:00Z",
11 "expireTime":"2026-12-09T04:15:53Z"
12 }]
13}数据类型
Model对象定义
SupervisorCreditQuota 详情
只返回当前为EFFECTIVE的记录，已过期的不返回，不返回缓冲期。
| 参数名称 | 类型 | 描述 |
|---|---|---|
| accountId | String | 用户id |
| accountType | String | 账户类型， MASTER_ACCOUNT-主账户、SUB_ACCOUNT-子账户 |
| loginName | String | 登录名 |
| ouName | String | 组织单元名 |
| comment | String | 备注 |
| quota | BigDecimal | 授信额度总额，单位元 |
| remainQuota | BigDecimal | 剩余授信额度，单位元（突破额度可能是负数） |
| beginTime | Date | 授信开始时间 |
| expireTime | Date | 授信过期时间 |
SDK请求样例
使用sdk bce-sdk-java:0.10.407 及以上版本 maven依赖
Plain Text
1<dependency>
2 <groupId>com.baidubce</groupId>
3 <artifactId>bce-java-sdk</artifactId>
4 <version>0.10.407</version>
5</dependency>
Plain Text
1private static void sampleForCreditQuotaQuery() {
2
3 BceCredentials credentials = new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY);
4 BillingClient client = new BillingClient(
5 new BillingClientConfiguration().withEndpoint(ENDPOINT).withCredentials(credentials)
6 );
7
8 SupervisorCreditQuotaQueryRequest request = new SupervisorCreditQuotaQueryRequest();
9 request.setAccountIds(Lists.newArrayList(TEST_ACCOUNT_ID));
10
11 SupervisorCreditQuotaResponse response = client.creditQuotaQuery(request);
12
13 System.out.println("==================================");
14 System.out.println("SupervisorCreditQuota response result:");
15 System.out.println(" result: " + JsonUtils.toJsonString(response.getResult()));
16 System.out.println("==================================");
17 }
18}