# 查询95计费资源用量明细-ListResourceUsage #### 功能介绍 客户在自建平台查询自己的资源使用量明细。 ![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png) 当前仅支持查询CDN、OBS、IEC和VPC四种云服务类型的资源用量明细，仅针对95计费场景。 #### 接口约束 该接口只允许使用客户AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ListResourceUsage)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 描述 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | |:---|:---|:---|:---|:---|:---| | billing:billDetail:view | 授予查看账单明细的权限 | read | - | - | - | #### URI GET /v2/bills/customer-bills/resources/usage/details URL参数说明请参见下表。 表1消息头参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | X-Language | 否 | String | 最大长度：10 | 语言，预留字段。 en_US：英文 zh_CN：中文 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | bill_cycle | 是 | String | 最大长度：7 | 账期，东八区时间，格式为yyyy-MM。 | | service_type_code | 是 | String | 最大长度：64 | 云服务类型，当前仅支持： - hws.service.type.cdn：内容分发网络 - hws.service.type.obs：对象存储服务 - hws.service.type.vpc：虚拟私有云 - hws.service.type.iec：智能边缘云 | | resource_type_code | 是 | String | 最大长度：64 | 资源类型编码，当前仅支持： - hws.resource.type.cdn：CDN - hws.resource.type.obs：云存储 - hws.resource.type.bandwidth：固定带宽 - hws.resource.type.edgebandwidth：边缘固定带宽 资源类型和云服务类型的对应关系可调用[根据云服务类型查询资源列表](https://support.huaweicloud.com/api-oce/qct_00003.html)接口获取。 | | usage_type | 是 | String | 最大长度：64 | 使用量类型编码，当前仅支持： - 95Peak：中国大陆月95峰值带宽_1024进制 - 95peak_1000：中国大陆月95峰值带宽_1000进制 - 95Peak_1000：中国大陆月95峰值带宽_1000进制（若查询1000进制的数据，需查询95peak_1000和95Peak_1000的数据，将响应值做聚合才是完整的数据） - bandwidth95peak：95峰值带宽 - 95peak_plus：增强型95峰值 资源类型和使用量类型的对应关系可调用[查询使用量类型列表](https://support.huaweicloud.com/api-oce/qct_00004.html)接口获取。 | | resource_id | 是 | String | 最大长度：64 | 资源ID，您可以调用[查询资源用量汇总](https://support.huaweicloud.com/api-oce/zh-cn_topic_0000001144806706.html)接口获取。 | | 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。 | #### 请求消息 **请求参数** 无。 **请求示例** ``` GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/resources/usage/details?bill_cycle=2021-07&service_type_code=hws.service.type.cdn&resource_type_code=hws.resource.type.cdn&usage_type=95Peak&offset=0&limit=10&resource_id=resourceinstanceid-00-000-0001 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` #### 响应消息 **响应参数** | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | error_code | String | 最大长度：16 | 状态码。具体请参考[状态码]。只有失败才会返回这个参数。 | | error_msg | String | 最大长度：1024 | 错误描述信息。只有失败才会返回这个参数。 | | actual_days | String | 最大长度：32 | 有效天数，精度最高返回小数点后20位。 说明： - 计算方式为上报的点数/288所得出的值。其中288为一天的点数，5分钟为一个点数单位。 - 计算95费用时，因95费用是按月定价，若实际不足月，则是使用官网价\*折扣\*actual_days/当月天数，来计算费用明细。 | | band_width | String | 最大长度：32 | 计费带宽的按月汇总。 说明： 每月2日20点后可查询上月数据；若查询当月数据，则为空。 | | monthly_guaranteed_band_width | String | 最大长度：32 | 月保底带宽的按月汇总。 说明： - 每月2日20点后可查询上月数据；若查询当月数据，则为空。 - 该字段为预留值，当前始终为空；当场景为95增强时才返回数值。 | | monthly_peak_band_width | String | 最大长度：32 | 月峰值带宽。 说明： - 每月2日20点后可查询上月数据；若查询当月数据，则为空。 - 该字段为预留值，当前始终为空；当场景为95增强时才返回数值。 | | band_width_measure_id | Integer | - | 带宽单位，您可以调用[查询度量单位列表-ListMeasureUnits](https://support.huaweicloud.com/api-oce/qct_00006.html)接口获取。若所有带宽为空，则该字段为空。 | | usage_info_list | List\ | 最大个数：1000 | 使用量明细（5分钟统计值）。具体请参见[表3]。 | | total_count | Integer | - | 总条数。 | 表3StatUsageInfo | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | stat_time | String | 最大长度：20 | 统计时间点，UTC时间，格式为YYYY-MM-DDTHH:MM:SSZ。 | | guaranteed_band_width | String | 最大长度：32 | 保底带宽。 说明： 该字段为预留值，当前始终为空；当场景为95增强时才返回数值。 | | usage | String | 最大长度：32 | 用量。 | | measure_id | Integer | - | 单位，您可以调用[查询度量单位列表-ListMeasureUnits](https://support.huaweicloud.com/api-oce/qct_00006.html)接口获取。带宽和用量使用相同的计量单位。 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "actual_days": "0.1", "band_width": "66.56", "monthly_guaranteed_band_width": null, "monthly_peak_band_width": null, "band_width_measure_id": 51, "total_count": 2, "usage_info_list": [ { "stat_time": "2021-07-01T00:00:00Z", "guaranteed_band_width": null, "usage": "0", "measure_id": 51 }, { "stat_time": "2021-07-01T00:05:00Z", "guaranteed_band_width": null, "usage": "0", "measure_id": 51 } ] } ``` #### 状态码 ![](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 | 未知错误。 |