文档首页/ 客户运营能力/ API参考/ 待下线接口/ 管理账户/ 查询账户余额（旧）
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

查询账户余额（旧）

功能介绍

客户可以查询自身的账户余额。

该接口即将下线，“查询账户余额”新接口请参考查询账户余额。

Web UI

客户登录费用中心进入“总览”页面，在“可用额度”区域可以查询自身的账户余额。

REST API

客户在自建平台查询自身的账户余额。

客户查询自身的账户余额的时候，只允许使用客户自身的AK/SK或者Token调用。

  1. URI

    GET /v1.0/{domain_id}/customer/account-mgr/balances

    参数说明请参见下表。

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    domain_id

    是

    最大长度：64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

    此参数暂不校验。
  1. 请求消息

    请求参数

    无。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/balances HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参见4。

    error_msg

    String

    错误描述信息。

    account_balances

    List<AccountBalance>

    账户余额列表。

    具体请参见表2

    debtAmount

    Number

    欠款总金额。

    measureId

    Integer

    度量单位：

    • 1：元
    • 2：角
    • 3：分

    currency

    String

    币种。

    CNY：人民币。
    表2 AccountBalance

    参数

    参数类型

    描述

    account_id

    String

    账户标识。

    account_type

    Integer

    账户类型。

    • 1：余额
    • 2：信用
    • 5：奖励
    • 7：保证金

    amount

    Double

    余额。

    currency

    String

    币种。

    CNY：人民币。

    值为空代表人民币。

    designated_amount

    Double

    专款专用余额。

    credit_amount

    Double

    总信用额度，仅信用账户存在该字段。

    measure_unit

    Integer

    度量单位。

    1：元

    memo

    String

    备注。

    type

    String
    • 0：华为云账户
    • 1：伙伴拨款账户

      仅当客户关联合作伙伴且关联类型为代售模式时，才会存在伙伴拨款账户。

    响应示例

    HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  

{
	"error_code": "CBC.0000",
	"error_msg": "success",
	"account_balances": [{
			"account_id": "AT001016B6A58D3D60",
			"account_type": 1,
			"amount": 20810.92,
			"currency": "CNY",
			"designated_amount": 14999.98,
			"credit_amount": null,
			"measure_unit": 1,
			"memo": null,
			"type": "1"
		},
		{
			"account_id": "AT001016B6A58D3D81",
			"account_type": 5,
			"amount": 0,
			"currency": "CNY",
			"designated_amount": 0,
			"credit_amount": null,
			"measure_unit": 1,
			"memo": null,
			"type": "1"
		}
	],
	"debtAmount": 0,
	"measureId": 1,
	"currency": "CNY"
}

  1. 状态码
    • 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
    • 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    500

    CBC.0999

    其他错误。

    403

    CBC.0151

    访问拒绝。

    400

    CBC.0100

    参数错误。
父主题： 管理账户

相关文档