最近更新时间:2024-01-31 10:42:09
本接口用于获取客户带宽数据,单位 Mbps,进制1000。
支持按指定的起止时间查询且两者需要同时指定,最多只能查 31 天跨度数据。
支持运营商、省及实例维度批量查询。
本接口一次最多返回1w条数据,粒度固定为5分钟。
本接口请求需要包含公共请求Header和该接口所特有的请求参数,具体请求语句参照下文请求示例。
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
start | 是 | string | 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,使用URL编码,格式为:YYYY-MM-DDThh:mm+0800,例:2023-08-19T00%3A00%2B0800 |
end | 是 | string | 结束时间需大于起始时间,日期格式按ISO8601表示法,北京时间,使用URL编码,格式同上 |
job_id | 否 | string | 实例id,支持多实例查询,用逗号(半角)分隔,默认所有实例id |
ipprovince | 否 | string | 支持多省份查询,用逗号(半角)分隔,默认所有省份 |
ipisp | 否 | string | 支持多运营商查询,用逗号(半角)分隔,默认所有运营商 |
bill_instance_id | 否 | string | 支持多账单查询,用逗号(半角)分隔,默认所有账单 |
result_type | 否 | string | 分组返回数据,支持多选,可选值包括:job_id, ipprovince,ipisp,bill_instance_id,默认合并带宽返回 |
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
data | 是 | BpsDataByTime[] | 5分钟粒度的带宽数据 |
request_id | 是 | string | 请求ID |
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
bandiwdth | 是 | float | 带宽,单位 Mbps,进制 1000,精确到小数点后两位 |
time | 是 | string | 日期格式按ISO8601表示法,北京时间,格式同上 |
job_id | 否 | string | 实例id |
ipprovince | 否 | string | 省份 |
ipisp | 否 | string | 运营商 |
bill_instance_id | 否 | string | 账单id |
https://eds.api.ksyun.com?Action=ListBandwidths&end=2023-04-02T00%3A00%2B0800&start=2023-04-01T00%3A00%2B0800&bill_instance_id=xx-id-1,xx-id-2&result_type=bill_instance_id,ipisp
HTTP/1.1
Host: eds.api.ksyun.com
X-Amz-Date: 20220923T081534Z
Authorization: AWS4-HMAC-SHA256 Credential=AKLT670uY8l8QnmpbhZ8qSmnbw/20220923/cn-shanghai-3/eds/aws4_request, SignedHeaders=host;x-amz-date, Signature=9383ac8614291b334b75cf1b5ba35ca8dd3d6facfdb9e5892ddb54a03572cb5b
{
"data": [
{
"bandwidth": 23515,
"bill_instance_id": "xx-id-1",
"ipisp": "移动",
"time": "2023-04-01T00:00+0800"
},
{
"bandwidth": 11367.62,
"bill_instance_id": "xx-id-1",
"ipisp": "联通",
"time": "2023-04-01T00:00+0800"
},
{
"bandwidth": 458.63,
"bill_instance_id": "xx-id-2",
"ipisp": "电信",
"time": "2023-04-01T00:00+0800"
},
.....
{
"bandwidth": 418.63,
"bill_instance_id": "xx-id-1",
"ipisp": "联通",
"time": "2023-04-01T23:55+0800"
},
{
"bandwidth": 143.47,
"bill_instance_id": "xx-id-2",
"ipisp": "电信",
"time": "2023-04-01T23:55+0800"
}
],
"request_id": "9b6edc75-a5f9-45dc-8b1d-b0071bfaa887"
}
纯净模式