GetServerData

描述

本接口用于获取域名不同粒度（5分钟、1小时、1天）的服务及回源数据，含flow：流量，单位为 byte；bandwidth：带宽，单位为 bps；request：请求数，单位为次；qps：平均每秒请求次数，单位：次
当粒度为1小时或者1天时，带宽取该粒度范围内所含5分钟点的最大峰值点
统计方式：按照server IP归属来进行统计
支持查询最近一年内，最大跨度为90天的数据（不同粒度支持查询跨度不一样）
支持域名（CdnType/Domain）、区域、协议类型、IP类型、粒度多维度数据查询
单次查询总返回数据点不超过10000个，域名数量不得超过1000个，且单次查询时间跨度至少包含一个时间粒度点（如，粒度为5分钟的时候，单次查询起止时间应大于等于五分钟)

请求语法

本接口请求需要包含指定目录/2020-06-30/statistics/GetServerData和公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数名	必选	类型及范围	说明
StartTime	是	String	获取数据起始时间点，日期格式按ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:10+0800
EndTime	是	String	结束时间需大于起始时间；获取日期格式按照ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:15+0800
Metric	否	String	指定查询指标，支持的类型有：flow：流量，单位为 byte；bandwidth：带宽，单位为 bps；request：请求数，单位为次；qps：平均每秒请求次数，单位：次，支持批量数据查询，多个类型用逗号（半角）分隔，默认为全部类型
DataType	否	String	数据类型，取值为edge：服务数据； origin：回源数据；一次查询只允许查询一个类型，缺省为 edge
Interval	否	Long	统计粒度，取值为5：5分钟粒度；60：1小时粒度；1440：1天粒度； 5分钟及以上粒度的带宽值均取该粒度时间段内的5分钟粒度的峰值点，缺省为5分钟粒度； 1分钟粒度查询范围最大跨度为24小时，5分钟粒度查询范围最大跨度为31天其余粒度查询范围最大跨度为90天
CdnType	是	String	产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：图片小文件
Domains	否	String	当前账户下选择时间段内正在运行状态的加速域名，可输入需要查询的域名，支持批量域名查询，多个域名用逗号（半角）分隔，缺省为全部域名
Regions	否	String	区域简称，具体见【使用须知】，支持多区域查询，多个区域用逗号（半角）分隔，缺省为全部区域
Schema	否	String	协议类型，取值为http:http协议数据; https:https协议数据；quic：quic协议数据，单选，缺省为全部协议类型
ResultType	否	String	统计结果数据展示方式，支持不展开和展开，缺省为不展开（unexpand）展开支持全部展开（expand）和按照某个查询维度展开，具体包含：域名（domain）、协议类型（schema）

返回参数

参数名	类型及范围	说明
StartTime	String	开始时间
EndTime	String	结束时间
Metric	String	本次查询指标
DataType	String	数据类型
Interval	Long	粒度
CdnType	String	产品类型
Domains	String	域名列表，逗号（半角）间隔
Regions	String	区域，逗号（半角）间隔
Schema	String	协议类型
ResultType	String	是否展开，以及展开的维度，逗号（半角）间隔
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
Datas	Datas[]	不同条件下的统计数据

Datas

参数名	类型及范围	说明
参数名	类型及范围	说明
Condition	Condition[]	查询条件
Data	Data[]	查询数据

Condition

参数名	类型及范围	说明
Domains	String	域名列表，逗号（半角）间隔
DataType	String	查询数据类型，服务数据/回源数据
Regions	String	区域，逗号（半角）间隔
Schema	String	协议类型，按查询条件展示，无此条件，则不展示

Data

参数名	类型及范围	说明
Time	String	时间点
Bandwidth	Long	对应时间点带宽/回源带宽峰值，按查询条件展示，无此条件，则不展示
Flow	Long	对应时间点流量/回源流量值，按查询条件展示，无此条件，则不展示
Request	Long	对应时间点请求数/回源请求数，按查询条件展示，无此条件，则不展示
Qps	Long	对应时间点 QPS/回源QPS数据，按查询条件展示，无此条件，则不展示

示例

请求示例

GET方式：

GET /2020-06-30/statistics/GetServerData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&Metric=flow&DataType=edge&Interval=5&CdnType=video&Regions=CN&Schema=&ResultType=
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetServerData
x-version: 2020-06-30

POST方式：

POST /2020-06-30/statistics/GetServerData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetServerData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime":"2020-09-01T08:00+0800",
    "EndTime":"2020-09-01T08:05+0800",
    "Metric":"flow",
    "DataType": "edge",
    "Interval": 5,
    "CdnType": "video",
    "Regions": "CN",
    "Schema": "",
    "ResultType": ""
}

返回示例

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "Metric": "flow",
    "DataType": "edge",
    "Interval": 5,
    "CdnType": "video",
    "Domains": "www.test.com",
    "Regions": "CN",
    "Schema": "http,https,quic",
    "ResultType": "unexpand",
    "Datas": [
        {
            "Condition": {
                "DataType": "edge"
            },
            "Data": [
                {
                    "Time": "2020-09-01T08:00+0800",
                    "Flow": 286003.30000000005
                }
            ]
        }
    ],
    "RequestId": "f5d2fe42-57d1-4934-bc8d-511ef6780f71"
}

文档导读

上一篇：访问数据查询

下一篇：服务状态码占比查询

纯净模式常规模式

纯净模式

点击可全屏预览文档内容