账户余额查询
更新时间：2025-08-21
接口描述
本接口用来查询账号的余额。
权限说明
请求发起人需要具有合法的 AccessKeyID 和 SecretAccessKey 才能发起请求，请参考鉴权认证。
注意事项
如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden
错误信息：AccessDenied。
请求结构
Plain Text
1POST /v{version}/finance/cash/balance
2HTTP/1.1
3Host: billing.baidubce.com
4ContentType: application/json; charset=utf-8
5Content-Length: <Content_Length>
6Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
无需其他请求参数。
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| cashBalance | BigDecimal | 用户余额 |
请求示例
说明：获取余额信息
Plain Text
1POST /v1/finance/cash/balance HTTP/1.1
2Host: billing.baidubce.com
3Date: Wed, 06 Apr 201920 06:34:40 GMT
4Authorization: AuthorizationString响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: d4591fcf-025b-46bc-81eb-91ddda4e27bc
3Server: BWS
4Date: Tue, 09 Apr 2019 11:01:10 GMT
5Content-Type: application/json;charset=UTF-8
6{
7 "cashBalance": 850.0000
8}Model对象定义
UserBalance 详情
| 参数名称 | 类型 | 描述 |
|---|---|---|
| cashBalance | BigDecimal | 用户余额 |