查询95计费资源用量汇总-ListResourceUsageSummary

功能介绍

客户在自建平台查询自己的资源使用量汇总。

当前仅支持查询CDN、OBS、IEC和VPC四种云服务类型的资源用量汇总，仅针对95计费场景。
使用量汇总列表只包含月汇总金额和资源ID，若要查询具体某个资源的用量明细，请调用查询资源用量明细接口获取。

接口约束

该接口只允许使用客户AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见策略授权参考。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
描述
访问级别
资源类型（*为必须）
条件键
别名
billing:resourcePackages:view
授予查看资源包，剩余量汇总，使用明细查询/导出的权限
list
-
-
-

授权项	描述	访问级别	资源类型（*为必须）	条件键	别名
billing:resourcePackages:view	授予查看资源包，剩余量汇总，使用明细查询/导出的权限	list	-	-	-

URI

GET /v2/bills/customer-bills/resources/usage/summary

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：边缘固定带宽资源类型和云服务类型的对应关系可调用根据云服务类型查询资源列表接口获取。
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峰值资源类型和使用量类型的对应关系可调用查询使用量类型列表接口获取。
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/summary?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
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数	参数类型	取值范围	描述
error_code	String	最大长度：16	状态码。具体请参考状态码。只有失败才会返回这个参数。
error_msg	String	最大长度：1024	错误描述信息。只有失败才会返回这个参数。
summary_usage_info_list	List<StatUsageSummaryInfo>	最大个数：1000	统计值，按照资源ID维度返回的月度统计结果。具体请参见表3。说明：每月2日20点后可查询上月数据；若查询当月数据，则只返回资源ID。
total_count	Integer	--	总条数。

表3 StatUsageSummaryInfo
参数	参数类型	取值范围	描述
resource_id	String	最大长度：64	资源ID。
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接口获取。若所有带宽为空，则该字段为空。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "total_count": 2,
    "summary_usage_info_list": [
        {
            "resource_id": "resourceinstanceid-00-000-0001",
            "actual_days": "0.1",
            "band_width": "66.56",
            "monthly_guaranteed_band_width": null,
            "monthly_peak_band_width": null,
            "band_width_measure_id": 51
        },
        {
            "resource_id": "resourceinstanceid-00-000-0002",
            "actual_days": "0.1",
            "band_width": "66.56",
            "monthly_guaranteed_band_width": null,
            "monthly_peak_band_width": null,
            "band_width_measure_id": 51
        }
    ]
}