
# 查询资源消费记录-ListCustomerselfResourceRecords
#### 功能介绍
客户在自建平台查询每个资源的消费明细数据。
客户登录费用中心查询资源消费记录请参见[这里](https://support.huaweicloud.com/usermanual-billing/bills-topic_new_1000102.html)。
资源消费明细记录会有小时级延迟。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的"允许查看子账号消费信息"的申请。申请方法见"[变更子账号权限](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0084759962.html)"。
- 支持查看近3年的数据。
#### 接口约束
- 该接口只允许使用客户AK/SK或者Token调用。
- 该接口只能查询同一个月内的资源消费记录，不支持跨月份查询资源消费记录。
- 当月数据查询结果仅供参考，不作为对账依据；华为云非月结用户当月最终流水和明细账单可在次月3日上午10点后查看和导出对账，月结用户可在次月4日10点后查看和导出对账（月中会发生包括但不限于以下少数场景：延迟出账，退款，调账，欠费核销等）。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ListCustomerselfResourceRecords)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                           | 描述          | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 |
  |:---|:---|:---|:---|:---|:---|
  | billing:billDetail:view（推荐使用） | 授予查看账单明细的权限 | read | -           | -   | -  |
     
  
 
#### URI
GET /v2/bills/customer-bills/res-fee-records
URL参数说明请参见下表。
表1消息头参数 
| 参数         | 是否必选 | 参数类型   | 取值范围    | 描述                                                                            |
|:---|:---|:---|:---|:---|
| X-Language | 否    | String | 最大长度：10 | 语言。 en_US：英文 zh_CN：中文 |
   
表2查询参数 
| 参数                    | 是否必选 | 参数类型    | 取值范围       | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|:---|
| cycle                 | 是    | String  | 最大长度：10    | 查询的资源消费记录所在账期，东八区时间，格式：YYYY-MM。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| charge_mode           | 否    | String  | 最大长度：4     | 计费模式。 - 1：包年/包月  - 3：按需  - 10：预留实例  - 11：节省计划   此参数不携带时，不作为筛选条件；不支持携带值为空或携带值为空串或携带值为null。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| cloud_service_type    | 否    | String  | 最大长度：64    | 云服务类型编码，例如OBS的云服务类型编码为"hws.service.type.obs"。您可以调用[查询云服务类型列表-ListServiceTypes](https://support.huaweicloud.com/api-oce/zh-cn_topic_0000001256679455.html)接口获取。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| region                | 否    | String  | 最大长度：64    | 云服务区编码，例如："cn-north-1"。具体请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)对应云服务的"区域"列的值。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| bill_type             | 否    | Integer | -          | 账单类型。 - 1：消费-新购  - 2：消费-续订  - 3：消费-变更  - 4：退款-退订  - 5：消费-使用  - 8：消费-自动续订  - 9：调账-补偿  - 12：消费-按时计费  - 13：消费-退订手续费  - 14：消费-服务支持计划月末扣费  - 16：调账-扣费  - 18：消费-按月付费  - 20：退款-变更  - 23：消费-节省计划抵扣  - 24：退款-包年/包月转按需  - 25：消费-抹零补扣  - 103：消费-按年付费   此参数不携带或携带值为空时，不作为筛选条件。 |
| offset                | 否    | Integer | \[0-最大整数\] | 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2\~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| limit                 | 否    | Integer | \[1-1000\] | 每次查询的数量限制。默认值为10。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| resource_id           | 否    | String  | 最大长度：64    | 资源ID。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| enterprise_project_id | 否    | String  | 最大长度：64    | 企业项目标识（企业项目ID）。 - default项目对应ID：0  - 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1  - 其余项目对应ID获取方法请参见[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。   此参数不携带或携带值为空或携带值为空串或携带值为null时，不作为筛选条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| include_zero_record   | 否    | Boolean | -          | 返回是否包含应付金额为0的记录。 - true：包含  - false：不包含   此参数不携带或携带值为空时，不作为筛选条件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| method                | 否    | String  | 最大长度：64    | 查询资源消费记录的方式。 - oneself：客户自己  - sub_customer：企业子客户  - all：客户自己和企业子客户   此参数不携带或携带值为空时，默认值为"all"，如果没有企业子客户，取值为all时查询的是客户自己的资源消费记录。 说明： 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的"允许查看子账号消费信息"的申请。申请方法见"[变更子账号权限](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0084759962.html)"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| sub_customer_id       | 否    | String  | 最大长度：64    | 企业子账号ID。 此参数携带值为空串时，不作为筛选条件。 说明： - 如果method取值不为sub_customer，则该参数无效。  - 如果method取值为sub_customer，则该参数不能为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| trade_id              | 否    | String  | 最大长度：64    | 订单ID或交易ID。 - 账单类型为1、2、3、4、8和103时此处为订单ID。  - 账单类型为其它场景时此处为交易ID，为扣费维度的唯一标识。 例如非月末扣费时为应收ID；月末扣费时为账单ID。    此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。 说明： 按账期、按天类型统计时字段不生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| bill_date_begin       | 否    | String  | 最大长度：10    | 查询的资源消费记录的开始日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的第一天。 说明： - 必须和cycle（即资源的消费账期）在同一个月。    - bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。  - 按账期类型统计时字段不生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bill_date_end         | 否    | String  | 最大长度：10    | 查询的资源消费记录的结束日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的最后一天。 说明： - 必须和cycle（即资源的消费账期）在同一个月。  - bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。  - 按账期类型统计时字段不生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| statistic_type        | 否    | Integer | -          | 统计类型。默认值为3。 - 1：按账期  - 2：按天  - 3：按明细   该参数不携带或携带值为空时，取默认值3。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 请求消息
**请求参数**
无。
**请求示例**
```
GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/res-fee-records?cycle=2020-09&charge_mode=1&method=sub_customer&sub_customer_id=05b5fef62300d2ad0f98c00befba72c0&trade_id= CS1908201442ZLEPW476&bill_date_begin=2020-09-01&bill_date_end=2020-09-30&statistic_type=1 HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
```
#### 响应消息
**响应参数**
| 参数          | 参数类型                   | 取值范围      | 描述                                                                             |
|:---|:---|:---|:---|
| error_code  | String                 | 最大长度：16   | 状态码。具体请参考[状态码]。只有失败才会返回这个参数。                |
| error_msg   | String                 | 最大长度：1024 | 错误描述信息。只有失败才会返回这个参数。                                                           |
| fee_records | List\<ResFeeRecordV2\> | -         | 资源费用记录数据。 具体请参见[表3]。 |
| total_count | Integer                | -         | 结果集数量，只有成功才返回这个参数。                                                             |
| currency    | String                 | 最大长度：3    | 货币单位代码： CNY：人民币                                      |
   
 表3ResFeeRecordV2 
| 参数                          | 参数类型       | 取值范围      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| bill_date                   | String     | 最大长度：20   | 资源消费记录的日期。 格式：YYYY-MM-DD。按照东八区时间截取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bill_type                   | Integer    | -         | 账单类型。 - 1：消费-新购  - 2：消费-续订  - 3：消费-变更  - 4：退款-退订  - 5：消费-使用  - 8：消费-自动续订  - 9：调账-补偿  - 12：消费-按时计费  - 13：消费-退订手续费  - 14：消费-服务支持计划月末扣费  - 16：调账-扣费  - 18：消费-按月付费  - 20：退款-变更  - 23：消费-节省计划抵扣  - 24：退款-包年/包月转按需  - 25：消费-抹零补扣  - 103：消费-按年付费                                                                                                                                                                                                                         |
| customer_id                 | String     | 最大长度：64   | 消费客户的账号ID。 - 如果是普通客户或者企业子查询消费记录，只能查询到自身的消费记录，则这个地方显示的是自身的客户ID  - 如果是企业主查询消费记录，可以查询到自身以及企业子的消费记录，这个地方是消费的实际客户ID，如果是企业主自身消费，为企业主ID，如果这条消费记录是某个企业子客户的消费，这个地方的ID是企业子账号ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| region                      | String     | 最大长度：64   | 云服务区编码，例如："cn-north-1"。具体请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)对应云服务的"区域"列的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| region_name                 | String     | 最大长度：64   | 云服务区名称，例如："华北-北京"。具体请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)对应云服务的"区域名称"列的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| cloud_service_type          | String     | 最大长度：64   | 云服务类型编码，例如OBS的云服务类型编码为"hws.service.type.obs"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| resource_type               | String     | 最大长度：64   | 资源类型编码，例如ECS的VM为"hws.resource.type.vm"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| cloud_service_type_name     | String     | 最大长度：200  | 云服务类型名称。例如ECS的云服务类型名称为"弹性云服务器"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| resource_type_name          | String     | 最大长度：200  | 资源类型名称。例如ECS的资源类型名称为"云主机"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| effective_time              | String     | 最大长度：32   | 费用对应的资源使用的开始时间，按需、分期有效，包年/包月该字段保留。 格式：yyyy-MM-dd'T'HH:mm:ss'Z'。按照UTC时间截取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| expire_time                 | String     | 最大长度：32   | 费用对应的资源使用的结束时间，按需、分期有效，包年/包月该字段保留。 格式：yyyy-MM-dd'T'HH:mm:ss'Z'。按照UTC时间截取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| resource_id                 | String     | 最大长度：128  | 资源ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| resource_name               | String     | 最大长度：256  | 资源名称。 说明： 该参数返回值为用户在下单资源时手动填写的内容，不支持国际化。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| resource_tag                | String     | 最大长度：8192 | 资源标签。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| product_id                  | String     | 最大长度：64   | 产品ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| product_name                | String     | 最大长度：256  | 产品名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| product_spec_desc           | String     | 最大长度：512  | 产品的规格描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| sku_code                    | String     | 最大长度：64   | SKU编码，在账单中唯一标识一个资源的规格。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| spec_size                   | BigDecimal | -         | 产品的实例大小，仅线性产品有效。 说明： 线性产品是指订购时需要指定大小的产品。例如硬盘在订购时需选择10G、20G等不同大小规格。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| spec_size_measure_id        | Integer    | -         | 产品实例大小的单位，仅线性产品有该字段。 您可以调用[查询度量单位列表-ListMeasureUnits](https://support.huaweicloud.com/api-oce/qct_00006.html)接口获取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| trade_id                    | String     | 最大长度：64   | 订单ID或交易ID，扣费维度的唯一标识。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| id                          | String     | 最大长度：256  | 唯一标识。 按账期、按天类型统计时不返回唯一标识。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| trade_time                  | String     | 最大长度：32   | 交易时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z'。按照UTC时间截取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| enterprise_project_id       | String     | 最大长度：128  | 企业项目标识（企业项目ID）。 - default项目对应ID：0  - 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：null  - 其余项目对应ID获取方法请参见[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| enterprise_project_name     | String     | 最大长度：256  | 企业项目的名称。 说明： 该参数返回值为用户手动填写的内容，不支持国际化。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| charge_mode                 | String     | 最大长度：32   | 计费模式。 - 1：包年/包月  - 3：按需  - 10：预留实例  - 11：节省计划                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| order_id                    | String     | 最大长度：64   | 订单ID。 说明： 包年/包月资源的使用记录才有该字段，按需资源则为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| period_type                 | String     | -         | 周期类型： - 19：年  - 20：月  - 24：天  - 25：小时  - 5：一次性                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| usage_type                  | String     | -         | 资源使用量的类型，您可以调用[查询使用量类型列表-ListUsageTypes](https://support.huaweicloud.com/api-oce/qct_00004.html)接口获取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| usage                       | BigDecimal | -         | 资源的使用量。 说明： 查询包周期资源，不返回资源的使用量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| usage_measure_id            | Integer    | -         | 资源使用量的度量单位，您可以调用[查询度量单位列表-ListMeasureUnits](https://support.huaweicloud.com/api-oce/qct_00006.html)接口获取。 说明： 查询包周期资源，不返回资源使用量的度量单位。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| free_resource_usage         | BigDecimal | -         | 套餐内使用量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| free_resource_measure_id    | Integer    | -         | 套餐内使用量的度量单位，您可以调用[查询度量单位列表-ListMeasureUnits](https://support.huaweicloud.com/api-oce/qct_00006.html)接口获取。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ri_usage                    | BigDecimal | -         | 预留实例使用量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ri_usage_measure_id         | Integer    | -         | 预留实例使用量单位。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| unit_price                  | BigDecimal | -         | 产品的单价。 - 按需产品的单价，只有简单定价，不分档的场景会返回。    - 包周期产品的单价，只有包周期的如下场景会返回： - 包周期订购/续订/降配/升配/扩容  - 简单定价，不分档    - 预留实例的单价，只有如下场景下会返回： - 订购/续订/降配/升配/扩容/按时计费  - 简单定价，不分档                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| unit                        | String     | 最大长度：64   | 产品的单价单位。 - 线性产品的单价单位为"元/{线性单位}/月"或"元/{线性单位}/小时"等。  - 非线性产品的单价单位为"元/月"或"元/小时"等。   说明： - "线性单位"为线性产品（即订购时需要指定大小的产品）的大小的单位，比如硬盘的线性单位为GB，带宽的线性单位为Mbps。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| official_amount             | BigDecimal | -         | 官网价，华为云商品在官网上未叠加应用商务折扣、促销折扣等优惠的销售价格。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| discount_amount             | BigDecimal | -         | 优惠金额，用户使用云服务享受折扣优惠如商务折扣、伙伴授予折扣以及促销优惠等减免的金额。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| amount                      | BigDecimal | -         | 应付金额，用户使用云服务享受折扣优惠后需要支付的费用金额，包括现金券和储值卡和代金券金额，精确到小数点后2位。 说明： amount的值等于cash_amount，credit_amount，coupon_amount，flexipurchase_coupon_amount，stored_card_amount，bonus_amount，debt_amount，adjustment_amount的总和。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 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 | -         | 欠费核销金额。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| measure_id                  | Integer    | -         | 金额单位。 - 1：元                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| formula                     | String     | 最大长度：2048 | 实付金额计算公式。当前只包含如下场景： - 按需非线性定价 {使用量}【使用量】/{单位转化率}【单位转换】\*{单价}【单价】-{优惠金额}【优惠金额】-{抹零金额}【抹零金额】-{代金券抵扣}【代金券抵扣】     - 按需线性定价 {使用量}【使用量】/{单位转化率}【单位转换】\*{线性大小}【规格】\*{单价}【单价】-{优惠金额}【优惠金额】-{抹零金额}【抹零金额】-{代金券抵扣}【代金券抵扣】     - 包年包月新购和续订非线性定价 {周期数}【周期数】/{周期转化率}【周期转换】\*{单价}【单价】-{优惠金额}【优惠金额】-{代金券抵扣}【代金券抵扣】     - 包年包月新购和续订线性定价 {周期数}【周期数】/{周期转化率}【周期转换】\*{线性大小}【规格】\*{单价}【单价】-{优惠金额}【优惠金额】-{代金券抵扣}【代金券抵扣】   - 包年包月（一次性）新购和续订非线性定价 {单价}【单价】-{优惠金额}【优惠金额】-{代金券抵扣}【代金券抵扣】   - 包年包月（一次性）新购和续订线性定价 {线性大小}【规格】\*{单价}【单价】-{优惠金额}【优惠金额】-{代金券抵扣}【代金券抵扣】    说明： - 实付金额计算公式得到的金额值等于amount - coupon_amount的差值。  - 按账期、按天类型查询时不返回计算公式。   |
| sub_service_type_code       | String     | 最大长度：64   | 整机的子云服务的自身的云服务类型编码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| sub_service_type_name       | String     | 最大长度：200  | 整机的子云服务的自身的云服务类型名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| sub_resource_type_code      | String     | 最大长度：64   | 整机的子云服务的自身的资源类型编码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| sub_resource_type_name      | String     | 最大长度：200  | 整机的子云服务的自身的资源类型名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| sub_resource_id             | String     | 最大长度：64   | 整机的子云服务的自身的资源ID，资源标识。（如果为预留实例，则为预留实例标识）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| sub_resource_name           | String     | 最大长度：256  | 整机的子云服务的自身的资源名称，资源标识。（如果为预留实例，则为预留实例标识） 说明： 该参数返回值为用户在下单资源时手动填写的内容，不支持国际化。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| consume_time                | String     | 最大长度：64   | 消费时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z'。按照UTC时间截取。 - 包年/包月：与账单交易时间一致。  - 按需/分期：为账单的计费开始时间和结束时间。   说明： - 当统计类型statistic_type=3时，该字段才有值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| relative_order_id           | String     | 最大长度：64   | 客户订单关联的订单ID。 说明： 当order_id为组合交易订单且为包年/包月资源时，该字段才有值，当查询为普通订单时，此字段返回为空。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| account_name                | String     | 最大长度：128  | 消费客户的登录名称。 - 如果是普通客户或者企业子客户查询消费记录，只能查询到客户自己的消费记录，且此处显示的是客户自己的客户登录名称。  - 如果是企业主查询消费记录，可以查询到企业主以及企业子客户的消费记录，此处为消费的实际客户登录名称。如果是企业主自己的消费记录，则为企业主的客户登录名称；如果是某个企业子客户的消费记录，则此处为企业子的客户登录名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| period_num                  | BigDecimal | -         | 周期数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
**响应示例**
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "fee_records": [
        {
            "bill_date": "2020-12-06",
            "bill_type": 1,
            "customer_id": "52190d93cb844a249c70fd1e1d416f8b",
            "region": "cn-north-1",
            "region_name": "CN North-Beijing1",
            "cloud_service_type": "hws.service.type.vpc",
            "resource_type": "hws.resource.type.pm",
            "effective_time": "2020-12-06T11:06:55Z",
            "expire_time": "2020-12-07T11:06:55Z",
            "resource_id": "4251f987c09c4d97a6b4784e4661f8ce",
            "resource_name": "hws.service.type.vpcname",
            "resource_tag": "resourceTag",
            "product_id": "90301-686010-0--0",
            "product_name": "全动态BGP弹性IP_包月_北京一 北京四",
            "product_spec_desc": "动态BGP弹性IP",
            "sku_code": "5_bgp",
            "spec_size": 40,
            "spec_size_measure_id": 0,
            "trade_id": "BC0883684711",
            "id": "037e8a2b-bde9-4820-9801-5f9eb5153cba_1",
            "trade_time": "2020-12-06T11:07:00Z",
            "enterprise_project_id": "0",
            "enterprise_project_name": "default",
            "charge_mode": "1",
            "order_id": "CS21100100328BXN3",
            "period_type": "20",
            "usage_type": "sdjhgkf",
            "usage": 101,
            "usage_measure_id": 1,
            "free_resource_usage": 123,
            "free_resource_measure_id": 1,
            "ri_usage": 30,
            "ri_usage_measure_id": 0,
            "unit_price": 0,
            "unit": "元/1个(次)",
            "official_amount": 34.96,
            "discount_amount": 0.002,
            "amount": 34.96,
            "cash_amount": 1.23,
            "credit_amount": 1.24,
            "coupon_amount": 0.33,
            "flexipurchase_coupon_amount": 22.5,
            "stored_card_amount": 12.13,
            "bonus_amount": 2.4,
            "debt_amount": -4.87,
            "adjustment_amount": 2.58,
            "measure_id": 1,
            "consume_time":null,
            "formula": "（2月）【周期数】/（1）【周期转换】*（5997.5641元/月）【单价】-0.00【优惠金额】-0.00【代金券抵扣】",
            "relative_order_id":"ECS******PU70955",
            "account_name": "bei******7",
            "period_num": 1
        },
        {
            "bill_date": "2020-12-05",
            "bill_type": 1,
            "customer_id": "52190d93cb844a249c70fd1e1d416f8b",
            "region": "cn-north-1",
            "region_name": "CN North-Beijing1",
            "cloud_service_type": "hws.service.type.vpc",
            "resource_type": "hws.resource.type.ip",
            "effective_time": "2020-12-05T11:06:55Z",
            "expire_time": "2020-12-06T11:06:55Z",
            "resource_id": "4251f987c09c4d97a6b4784e4661f8ce",
            "resource_name": "hws.service.type.vpcname",
            "resource_tag": "resourceTag",
            "product_id": "00301-110660-0--0",
            "product_name": "调试15_4核8G_linux 包年",
            "product_spec_desc": "调试15_4核8G_linux",
            "sku_code": "comtest15.linux",
            "spec_size": 40,
            "spec_size_measure_id": 0,
            "trade_id": "BC0883684711",
            "id": "037e8a2b-bde******9eb5153cba_1",
            "trade_time": "2020-12-05T11:07:00Z",
            "enterprise_project_id": "0",
            "enterprise_project_name": "default",
            "charge_mode": "1",
            "order_id": "BC0883684711",
            "period_type": "20",
            "usage_type": "dsfhjgbk",
            "usage": 147,
            "usage_measure_id": 1,
            "free_resource_usage": 258,
            "free_resource_measure_id": 1,
            "ri_usage": 30,
            "ri_usage_measure_id": 0,
            "unit_price": 0,
            "unit": "元/1个(次)",
            "official_amount": 0.81,
            "discount_amount": 0.01,
            "amount": 0.81,
            "cash_amount": 2.25,
            "credit_amount": 1.23,
            "coupon_amount": 0.07,
            "flexipurchase_coupon_amount": 0.4,
            "stored_card_amount": 0.34,
            "bonus_amount": 4.63,
            "debt_amount": -8.11,
            "adjustment_amount": 3.69,
            "measure_id": 1,
            "sub_service_type_code": null,
            "sub_service_type_name": null,
            "sub_resource_type_code": null,
            "sub_resource_type_name": null,
            "sub_resource_id": null,
            "sub_resource_name": null,
            "consume_time":null,
            "formula": "（2月）【周期数】/（1）【周期转换】*（5997.5641元/月）【单价】-0.00【优惠金额】-0.00【代金券抵扣】",
            "relative_order_id":"ECS******PU70955",
            "account_name": "bei******7",
            "period_num": 1
        }
    ],
    "total_count": 2,
    "currency": "CNY"
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码      | 错误描述  |
|:---|:---|:---|
| 400     | CBC.0100 | 参数错误。 |
| 403     | CBC.0151 | 访问拒绝。 |
| 500     | CBC.0999 | 未知错误。 |
   
