查询请求数

查询请求数（GetPvData）

接口描述

• 本接口用于获取域名请求数数据，包括服务请求数、回源请求数，单位：次

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

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

• 支持多区域查询，多个区域用逗号（半角）分隔

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

• 统计粒度：5分钟粒度；10分钟粒度；20分钟粒度；1小时粒度；4小时粒度；8小时粒度；1天粒度；以上粒度的请求数均取该粒度时间段的请求数之和

• 时效性：5分钟延迟

• 统计方式：按照server IP归属来进行统计

• 接口性能：接口最大吞吐量为10000，即Region个数*DomainId个数*(EndTime-StartTime)/统计粒度 <= 10000。注：在获取多个域名多个区域合并值时，Region个数和DomainId个数按照1计算

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

• 使用场景：

  • 客户查询单个域名或多域名合并后实时请求数数据，用于绘制一条请求数线图

  • 客户查询单个域名的详细请求数数据，进行数据保存及数据分析

• 说明：

  • 请求数 ：统计当前域名下资源文件的访问次数

• 签名机制：

  • Service取值：cdn

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

请求语法

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

请求参数

返回参数

PvDataByTime

PvDataByDomain

PvDataByRegion

请求示例

GET方式：

GET /2016-09-01/statistics/GetPvData?StartTime=2016-07-31T21%3A14%2B0800&EndTime=2016-07-31T21%3A16%2B0800&CdnType=live&ResultType=1&Granularity=5&DataType=edge 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/GetPvData 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization: authorization string
x-action: GetPvData
x-version: 2016-09-01
Content-Type: application/json
{
 "StartTime": "2016-07-31T21:14+0800",
 "EndTime": "2016-07-31T21:16+0800",
 "CdnType": "live",
 "ResultType": 1,
 "Granularity": 5,
 "DataType": "edge"
}

返回示例

{
    "StartTime": "2016-07-31T21:14+0800",
    "EndTime": "2016-07-31T21:16+0800",
    "CdnType": "live",
    "DomainIds": "2D09X50,2D09X20",
    "Regions": "CN",
    "ResultType": 1,
    "Granularity": 5,
    "DataType": "edge",
    "Datas": [
        {
            "Time": "2016-07-31T21:15+0800",
            "Pv": 0,
            "Domains": [
                {
                    "DomainId": "2D09X20",
                    "Pv": 0,
                    "Regions": [
                        {
                            "Region": "CN",
                            "Pv": 0
                        }
                    ]
                },
                {
                    "DomainId": "2D09X50",
                    "Pv": 0,
                    "Regions": [
                        {
                            "Region": "CN",
                            "Pv": 0
                        }
                    ]
                }
            ]
        }
    ]
}

错误码

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