查询云经销商账户余额
功能介绍
华为云总经销商(一级经销商)可以查询关联的云经销商(二级经销商)的账户余额。
接口约束
- 该接口只允许使用合作伙伴AK/SK或者Token调用。
- 华为云总经销商查询云经销商的账户余额时,只允许使用华为云总经销商的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/accounts/partner-accounts/balances
参数说明请参见下表。
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
indirect_partner_id |
否 |
String |
最大长度:64 |
云经销商ID。 获取方法请参见查询云经销商列表。 华为云总经销商(一级经销商)查询云经销商(二级经销商)余额时,需要携带该参数;除此之外,此参数不做处理。否则只能查询自己的账户余额。 |
请求消息
请求参数
无。
请求示例
GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/balances?indirect_partner_id=0977ffa9f20010790f0fc003f6900520 HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
状态码。具体请参考状态码。只有失败才返回该字段。 |
error_msg |
String |
错误描述信息。只有失败才返回该字段。 |
account_balances |
List<AccountBalance> |
账户余额列表。 具体请参见表2 |
参数 |
参数类型 |
描述 |
---|---|---|
account_id |
String |
账户标识。 |
account_type |
Integer |
账户类型:
|
amount |
Double |
账户余额。 |
currency |
String |
币种。 CNY:人民币。 |
measure_id |
Integer |
度量单位。 1:元。 |
designated_amount |
Double |
专款专用余额。 |
credit_amount |
Double |
总信用额度。只有account_type取值为2时,该字段才有效。 |
memo |
String |
备注。 |
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "account_balances": [ { "account_id": "AT0010169C22C887F8", "account_type": 1, "amount": 100, "currency": "CNY", "designated_amount": 0.0, "credit_amount": 0.0, "measure_id": 1, "memo": null } ] }
状态码
- 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
- 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。
HTTP状态码 |
错误码 |
描述 |
---|---|---|
200 |
CBC.5001 |
非合作伙伴。 |
400 |
CBC.99000037 |
您没有操作该云经销商的权限。 |
403 |
CBC.0151 |
访问拒绝。 |
500 |
CBC.0999 |
其他错误。 |