GetRealTimeHitRateData

描述

本接口用于获取域名的实时流量命中率、请求数命中率数据，用于绘制命中率饼图。
支持查询最近一年内，最大跨度为90天的数据
支持批量域名查询
时效性：5分钟

请求语法

本接口请求需要包含指定目录/2020-06-30/statistics/GetRealTimeHitRateData和公共请求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
HitRatetype	否	String	命中率类型，取值为取值为flowhitrate:流量命中率;reqhitrate:请求数命中率，单选，缺省为流量命中率，
CdnType	是	String	产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：图片小文件，当CdnType和Domains两个条件同时存在时，进行强校验。
Domains	否	String	当前账户下选择时间段内正在运行状态的加速域名，可输入需要查询的域名，支持批量域名查询，多个域名用逗号（半角）分隔，缺省为全部域名，当CdnType和Domains两个条件同时存在时，进行强校验。
ResultType	否	String	统计结果数据展示方式，支持不展开（unexpand）、按域名（domain）维度展开共2种展开方式，缺省为不展开（unexpand）

返回参数

参数名	类型及范围	说明
StartTime	String	开始时间
EndTime	String	结束时间
HitRatetype	String	命中率类型
CdnType	String	产品类型
Domains	String	域名列表，逗号（半角）间隔
ResultType	String	是否展开，以及展开的维度
Datas	Datas[]	不同条件下的统计数据
RequestId	String	请求ID

Datas

参数名	类型及范围	说明
Condition	Condition[]	查询条件
DetailData	DetailData	命中率

Condition

参数名	类型及范围	说明
Domains	String	域名列表，逗号（半角）间隔

DetailData

参数名	类型及范围	说明
HitPv	Long	Hit状态的访问次数，即服务请求数-回源请求数
MissPv	Long	Miss状态的访问次数，即回源请求数
HitPvProportion	Double	Hit状态访问次数占比，即HitPv/(HitPv+SrcPv)，单位为：%
MissPvProportion	Double	Miss状态访问次数占比，即SrcPv/(HitPv+SrcPv)，单位为：%
HitFlow	Long	Hit状态的访问流量，即服务流量-回源流量
MissFlow	Long	Miss状态的访问流量，即回源流量
HitFlowProportion	Double	Hit状态访问流量占比，即HitFlow/(HitFlow+MissFlow)，单位为：%
MissFlowProportion	Double	Miss状态访问流量占比，即MissFlow/(HitFlow+MissFlow)，单位为：%

示例

请求示例

GET方式：

GET /2020-06-30/statistics/GetRealTimeHitRateData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&HitRatetype=flowhitrate&CdnType=video&ResultType=
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetRealTimeHitRateData
x-version: 2020-06-30

POST方式：

POST /2020-06-30/statistics/GetRealTimeHitRateData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetRealTimeHitRateData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime":"2020-09-01T08:00+0800",
    "EndTime":"2020-09-01T08:05+0800",
    "HitRatetype":"flowhitrate",
    "CdnType":"video",
    "ResultType":""
}

返回示例

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "HitRatetype": "flowhitrate",
    "CdnType": "video",
    "Domains": "www.test.com",
    "ResultType": "unexpand",
    "RequestId": "bb26fc61-3a1b-48fd-be86-aef8f0f27319",
    "Datas": [
        {
            "Condition": {},
            "DetailData": {
                "HitFlow": 270767,
                "MissFlow": 15236,
                "MissFlowProportion": 0.05327211259450502,
                "HitFlowProportion": 0.946726838466549
            }
        }
    ]
}

文档导读

上一篇：请求命中率详情查询

下一篇：02_服务数据对比

纯净模式常规模式

纯净模式

点击可全屏预览文档内容