查询命中率

查询命中率（GetHitRateData）

接口描述

本接口用于获取域名某一时间段内流量命中率、请求数命中率数据，用于绘制命中率饼图

• 支持按指定的起止时间查询，两者需要同时指定

• 支持批量域名查询，多个域名ID用逗号（半角）分隔

• 最多可获取最近一年内93天跨度的数据

• 时效性：5分钟延迟

• 单次查询域名数量不得超过1000个，且单次查询时间跨度至少包含一个时间粒度点（如，粒度为5分钟的时候，单次查询起止时间应大于等于五分钟)。

• 使用场景：

  • 客户查询单个域名或多域名合并后在某一时间段内实时命中率求和数据，用于绘制命中率饼图

• 说明：

  • Hit访问次数=服务请求数-回源请求数

  • Miss访问次数=回源请求数

  • Hit访问流量=服务流量-回源流量

  • Miss访问流量=回源流量

• 签名机制：

  • Service取值：cdn

• 接入地址：cdn.api.ksyun.com︎

请求语法

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

请求参数

返回参数

HitRateData

请求示例

GET方式：

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

POST方式：

POST  /2016-09-01/statistics/GetHitRateData 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization: authorization string
x-action: GetHitRateData
x-version: 2016-09-01
Content-Type: application/json

{
    "DomainIds": "2D08X0G",
    "StartTime": "2019-05-06T00:00+0800",
    "EndTime": "2019-05-15T00:15+0800",
    "CdnType": "live"
}

返回示例

{
    "StartTime": "2019-05-06T00:00+0800",
    "EndTime": "2019-05-15T00:15+0800",
    "DomainIds": "2D08X0G",
    "CdnType": "live",
    "Datas": [
        {
            "HitPv": 0,
            "MissPv": 0,
            "HitPvProportion": 0.0,
            "MissPvProportion": 100.0,
            "HitFlow": 0,
            "MissFlow": 0,
            "HitFlowProportion": 0.0,
            "MissFlowProportion": 100.0
        }
    ]
}

错误码

此接口为CDN接口，请到使用须知查看错误码详情。