查询95计费资源用量明细
功能介绍
客户在自建平台查询自己的资源使用量明细。
当前仅支持查询CDN、OBS、IEC和VPC四种云服务类型的资源用量明细，仅针对95计费场景。
接口约束
该接口只允许使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中直接运行调试该接口。
URI
GET /v2/bills/customer-bills/resources/usage/details
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
X-Language |
否 |
String |
最大长度：10 |
语言。 en_US：英文 zh_CN：中文 |
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
bill_cycle |
是 |
String |
最大长度：7 |
账期，东八区时间，格式为yyyy-MM。 |
|
service_type_code |
是 |
String |
最大长度：64 |
云服务类型，当前仅支持：
|
|
resource_type_code |
是 |
String |
最大长度：64 |
资源类型编码，当前仅支持：
资源类型和云服务类型的对应关系可调用根据云服务类型查询资源列表接口获取。 |
|
usage_type |
是 |
String |
最大长度：64 |
使用量类型编码，当前仅支持：
资源类型和使用量类型的对应关系可调用查询使用量类型列表接口获取。 |
|
resource_id |
是 |
String |
最大长度：64 |
资源ID，您可以调用查询资源用量汇总接口获取。 |
|
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位。
说明：
|
|
band_width |
String |
最大长度：32 |
计费带宽的按月汇总。
说明：
每月2日20点后可查询上月数据；若查询当月数据，则为空。 |
|
monthly_guaranteed_band_width |
String |
最大长度：32 |
月保底带宽的按月汇总。
说明：
|
|
monthly_peak_band_width |
String |
最大长度：32 |
月峰值带宽。
说明：
|
|
band_width_measure_id |
Integer |
- |
带宽单位，您可以调用查询度量单位列表接口获取。若所有带宽为空，则该字段为空。 |
|
usage_info_list |
List<StatUsageInfo> |
最大个数：1000 |
使用量明细（5分钟统计值）。具体请参见表3。 |
|
total_count |
Integer |
- |
总条数。 |
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
stat_time |
String |
最大长度：20 |
统计时间点，UTC时间，格式为YYYY-MM-DDTHH:MM:SSZ。 |
|
guaranteed_band_width |
String |
最大长度：32 |
保底带宽。
说明：
该字段为预留值，当前始终为空；当场景为95增强时才返回数值。 |
|
usage |
String |
最大长度：32 |
用量。 |
|
measure_id |
Integer |
- |
单位，您可以调用查询度量单位列表接口获取。带宽和用量使用相同的计量单位。 |
响应示例
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
}
]
}
