文档首页 > > API参考> 管理账单> 查询资源详单

查询资源详单

分享
更新时间: 2020/05/29 GMT+08:00

功能介绍

客户在客户自建平台查询自己的资源详单,用于反映各类资源的消耗情况。

注意事项:

  • 该接口只允许使用客户AK/SK或者Token调用。
  • 由于资源消费呈现的是资源维度的8位小数原始消费金额,实际从账户扣费时按2位小数进行扣费(即扣到分),会存在精度差异,所以,不推荐消费汇总和资源消费直接对账。

URI

POST /v2/bills/customer-bills/res-records/query

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

cycle

String

最大长度:8

消费月份,格式为YYYY-MM。

例如2019-01。

说明:

不支持2019年1月份之前的资源详单。

cloud_service_type

String

最大长度:64

云服务类型编码,例如ECS的云服务类型编码为“hws.service.type.ec2”。具体请参见云服务类型

resource_type

String

最大长度:64

资源类型编码,例如ECS的VM为“hws.resource.type.vm”。具体请参见资源类型

region

String

最大长度:64

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

res_instance_id

String

最大长度:64

资源实例ID。

charge_mode

Integer

-

支付方式。

  • 1 : 包年/包月
  • 3: 按需
  • 10: 预留实例

bill_type

Integer

-

账单类型。

  • 1:消费-新购
  • 2:消费-续订
  • 3:消费-变更
  • 4:退款-退订
  • 5:消费-使用
  • 8:消费-自动续订
  • 9:调账-补偿
  • 14:消费-服务支持计划月末扣费
  • 16:调账-扣费

enterprise_project_id

String

最大长度:64

企业项目ID。

include_zero_record

Boolean

-

返回是否包含应付金额为0的记录。

  • true: 包含
  • false: 不包含

offset

Integer

[0-最大整数]

偏移量。默认为0。

limit

Integer

[1-1000]

页面大小。默认为10。

请求示例

POST https://bss.myhuaweicloud.com/v2/bills/customer-bills/res-records/query HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "cycle": "2018-12",
  "cloud_service_type": "hws.service.type.ec2",
  "resource_type": "hws.resource.type.vm",
  "region": "cn-north-1",
  "res_instance_id": "76*****7f",
  "charge_mode": 1,
  "bill_type": 1,
  "enterprise_project_id": "6***f3-3**4-4**2-9a3e-a****c24",
  "include_zero_record": "true",
  "offset": 1,
  "limit": 10
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:16

状态码。具体请参考状态码。只有失败才会返回这个参数。

error_msg

String

最大长度:1024

错误描述信息。只有失败才会返回这个参数。

monthly_records

List<MonthlyBillRes>

-

资源费用记录数据。

具体请参见表1

total_count

Integer

-

结果集数量,只有成功才返回这个参数。

currency

String

最大长度:3

货币单位代码:

CNY:人民币

表1 MonthlyBillRes

参数

参数类型

取值范围

描述

cycle

String

最大长度:8

消费月份,格式为YYYY-MM。

例如2020-01。

cloud_service_type

String

最大长度:256

云服务类型编码,例如ECS的云服务类型编码为“hws.service.type.ec2”。具体请参见云服务类型

region

String

最大长度:256

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

resource_Type_code

String

最大长度:64

资源类型编码,例如ECS的VM为“hws.resource.type.vm”。具体请参见资源类型

res_instance_id

String

最大长度:256

资源实例ID。

resource_name

String

-

资源名称。客户在创建资源的时候,可以输入资源名称,有些资源也可以在管理资源时,修改资源名称。

resource_tag

String

-

资源标签。客户在管理资源的时候,可以设置资源标签。

consume_amount

BigDecimal

-

客户购买云服务类型的消费金额,包含代金券、现金券,精确到小数点后8位。

cash_amount

BigDecimal

-

现金支付金额

credit_amount

BigDecimal

-

信用额度支付金额。

coupon_amount

BigDecimal

-

代金券支付金额。

flexipurchase_coupon_amount

BigDecimal

-

现金券支付金额。

stored_card_amount

BigDecimal

-

储值卡支付金额。

bonus_amount

BigDecimal

-

奖励金支付金额(用于现网客户未使用完的奖励金)。

debt_amount

BigDecimal

-

欠费金额。

adjustment_amount

BigDecimal

-

欠费核销金额。

official_amount

BigDecimal

-

官网价。

discount_amount

BigDecimal

-

对应官网价折扣金额。

measure_id

Integer

[1-3]

金额单位:

  • 1:元
  • 2:角
  • 3:分

enterprise_project_id

String

-

企业项目ID。

enterprise_project_name

String

-

企业项目名称。

charge_mode

Integer

-

支付方式:

  • 1 : 包年/包月
  • 3: 按需
  • 10: 预留实例

bill_type

Integer

-

账单类型。

  • 1:消费-新购
  • 2:消费-续订
  • 3:消费-变更
  • 4:退款-退订
  • 5:消费-使用
  • 8:消费-自动续订
  • 9:调账-补偿
  • 14:消费-服务支持计划月末扣费
  • 16:调账-扣费

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
  "total_count": 1,
  "currency": "CNY",
  "monthly_records": [
    {
      "cycle": "2020-01",
      "cloud_service_type": "hws.service.type.ec2",
      "region": "cn-north-1",
      "resource_Type_code": "hws.resource.type.vm",
      "res_instance_id": "003*****016f",
      "resource_name": null,
      "resource_tag": null,
      "consume_amount": 0,
      "measure_id": 3,
      "enterprise_project_id": "0",
      "enterprise_project_name": null,
      "charge_mode": 1,
      "bill_type": 1
    }
  ]
}

状态码

HTTP状态码

错误码

错误描述

200

N/A

N/A

400

CBC.0100

输入参数校验失败。

403

CBC.0151

访问拒绝。

500

CBC.0999

未知错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问