全部文档
当前文档
最近更新时间：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"
}纯净模式