CDN

查询峰值带宽接口

最近更新时间:2020-09-15 09:42:57

GetPeakBandwidthData

描述

本接口用于获取域名带宽峰值,峰值时间点,单位bps

  • 峰值带宽计算方法:在选定时间段内,取每5分钟有效带宽值进行降序排列,最高带宽就是峰值带宽
  • RealTime,峰值时间点,取每5分钟一个时间点,最高峰出现的时间点即为峰值时间
  • 最多可获取最近一年内93天跨度的数据
  • 单次查询域名数量不得超过1000个,且单次查询时间跨度至少包含一个时间粒度点(如,粒度为5分钟的时候,单次查询起止时间应大于等于五分钟)。

请求参数

参数名 必选 类型及范围 说明
StartTime String 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
EndTime String 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
CdnType String 产品类型,只允许输入一种类型,取值为file:大文件下载,video:音视频点播,page:图片小文件,live:流媒体直播
DomainIds String 域名ID,缺省为当前产品类型下的全部域名,可输入需要查询的域名ID,支持批量域名查询,多个域名ID用逗号(半角)分隔
Regions String 区域名称, 取值为CN:中国大陆,HK:香港,TW:台湾,AS:亚洲其他,NA:北美洲,SA:南美洲,EU:欧洲,AU:大洋洲,AF:非洲,支持多区域查询,多个区域用逗号(半角)分隔,,缺省为 CN

返回参数

参数 类型 描述
StartTime String 开始时间
EndTime String 结束时间
CdnType String 产品类型
DomainIds String 域名ID列表,逗号(半角)间隔
Regions String 区域,逗号(半角)间隔
PeakBw Long 峰值带宽 (单位bps)
RealTime String 峰值时间点

示例

请求示例

GET方式:

GET /2016-09-01/statistics/GetPeakBandwidthData?DomainIds=2D08X0G&StartTime=2019-03-06T00%3A00%2B0800&EndTime=2019-05-15T00%3A15%2B0800&CdnType=file&Regions=CN 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetPeakBandwidthData
x-version: 2016-09-01

POST方式:


POST /2016-09-01/statistics/GetPeakBandwidthData 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetPeakBandwidthData
x-version: 2016-09-01
Content-Type: application/json
{
    "DomainIds": "2D08X0G",
    "StartTime": "2019-03-06T00:00+0800",
    "EndTime": "2019-05-15T00:15+0800",
    "CdnType": "file",
    "Regions": "CN"
}

返回示例

{
    "StartTime": "2019-03-06T00:00+0800",
    "EndTime": "2019-05-15T00:15+0800",
    "CdnType": "file",
    "DomainIds": "2D08X0G",
    "Regions": "CN",
    "PeakBw": 0,
    "RealTime": ""
}

金山云,开启您的云计算之旅

免费注册