查询账户余额-ShowCustomerAccountBalances
接口约束
- 客户查询自身的账户余额的时候，只允许使用客户自身的AK/SK或者Token调用。
- 此接口不适用于伙伴的转售类客户。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见策略授权参考。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
描述
访问级别
资源类型（*为必须）
条件键
别名
billing:balance:view
授予查看收支明细，付款历史记录，消费配额，调账记录，欠费查询的权限
list
-
-
-
URI
GET /v2/accounts/customer-accounts/balances
请求消息
请求参数
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v2/accounts/customer-accounts/balances HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
| 参数 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|
| error_code | String | 最大长度：20 | 状态码。具体请参见状态码。 只有失败才会返回这个参数。 |
| error_msg | String | 最大长度：2000 | 错误描述信息。 只有失败才会返回这个参数。 |
| account_balances | List<AccountBalanceV2> | - | 账户余额列表。 具体请参见表1。 |
| debt_amount | BigDecimal | - | 欠款总金额。 |
| measure_id | Integer | - | 金额的度量单位。
|
| currency | String | 最大长度：4 | 币种。 USD：美元。 |
| 参数 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|
| account_id | String | 最大长度：64 | 账户标识。 |
| account_type | Integer | - | 账户类型。
|
| amount | Bigdecimal | - | 账户余额。 当account_type=2时，信用账户余额为总信用额度，非剩余信用额度。 |
| currency | String | - | 币种。 USD：美元。 |
| designated_amount | Bigdecimal | - | 专款专用余额。 |
| credit_amount | Bigdecimal | - | 总信用额度，仅信用账户存在该字段。 |
| measure_id | Integer | - | 度量单位。
|
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"account_balances": [
{
"account_id": "AT001017264D6E9FF7",
"account_type": 1,
"amount": 0,
"currency": "USD",
"designated_amount": 0,
"credit_amount": 0,
"measure_id": 1
},
{
"account_id": "AT001017264D6EA084",
"account_type": 5,
"amount": 0,
"currency": "USD",
"designated_amount": 0,
"credit_amount": 0,
"measure_id": 1
}
],
"debt_amount": 120.0,
"measure_id": 1,
"currency": "USD"
} 
