全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询省份+运营商请求数

最近更新时间:2024-03-27 15:08:38

查询省份+运营商请求数(GetProvinceAndIspPvData)

接口描述

本接口用于获取域名在中国大陆地区各省份及各运营商的请求数数据,** 仅包括服务请求数,单位:次**

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

  • 支持批量域名查询,多个域名ID用逗号(半角)分隔

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

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

  • 时效性:5分钟延迟

  • 接口性能:接口最大吞吐量为10000,即Province个数*Isp个数*DomainId个数*(EndTime-StartTime)/统计粒度 <= 10000
    注:在获取多个域名多个省份区域多个运营商合并值时,Province个数、Isp个数和DomainId个数按照1计算

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

  • 使用场景:

    • 客户查询单个域名或多个域名在各个省份及运营商的合并后的请求数数据,用于绘制一条请求数线图

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

  • 签名机制

    • Service取值:cdn

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

请求语法

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

请求参数

参数名

类型

是否必须

描述

StartTime

String

Y

获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800

EndTime

String

Y

结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800

CdnType

String

Y

产品类型,live:流媒体直播

DomainIds

String

N

域名ID,缺省为当前产品类型下的全部域名,可输入需要查询的域名ID,支持批量域名查询,多个域名ID用逗号(半角)分隔

Provinces

String

N

省份区域名称, 枚举类型表见使用须知,支持多省份区域查询,多个省份区域用逗号(半角)分隔,缺省为全部省份区域

Isps

String

N

运营商名称,枚举类型表见使用须知,支持多运营商查询,多个运营商用逗号(半角)分隔,缺省为全部运营商

ResultType

Long

Y

取值为0:多域名多省份区域多运营商数据做合并;1:每个域名每个省份区域的每个运营商数据分别返回。

Granularity

Long

N

统计粒度,取值为 5(默认):5分钟粒度;10:10分钟粒度;20:20分钟粒度;60:1小时粒度;240:4小时粒度;480:8小时粒度;1440:1天粒度

返回参数

参数名

类型

描述

StartTime

String

开始时间

EndTime

String

结束时间

CdnType

String

产品类型

DomainIds

String

域名ID列表,逗号(半角)间隔

Provinces

String

省份区域,逗号(半角)间隔,枚举类型表见使用须知

Isps

String

运营商,逗号(半角)分隔,枚举类型表见使用须知

ResultType

Long

取值为0:多域名多省份区域多运营商数据做合并;1:每个域名每个省份区域的每个运营商数据分别返回

Granularity

Long

统计粒度,取值为 5:5分钟粒度;10:10分钟粒度;20:20分钟粒度;60:1小时粒度;240:4小时粒度;480:8小时粒度;1440:1天粒度

Datas

PvDataByTime[]

每个时间粒度的请求数数据

PvDataByTime

参数名

类型

描述

Time

String

时间点

Pv

Long

服务请求数(单位:次 ) (所选域名在所选省份区域及运营商的服务请求数数据合并值)

Domains

PvDataByDomain[]

每个域名的详细请求数数据(仅当ResultType取值为1时返回此项数据)

PvDataByDomain

参数名

类型

描述

DomainId

String

域名ID

Pv

Long

服务请求数(单位:次 ) (所选域名在所选省份区域及运营商的服务请求数数据合并值)

Provinces

PvDataByProvince[]

该域名在每个省份区域的请求数详细数据

PvDataByProvince

参数名

类型

描述

Province

String

省份区域

Pv

Long

服务请求数(单位:次 ) (该域名在该省份区域的服务请求数数据)

Isps

PvDataByIsp[]

该域名在该省份每个运营商的请求数详细数据

PvDataByIsp

参数名

类型

描述

Isp

String

运营商

Pv

Long

服务请求数(单位:次 )(该域名在该省份区域该运营商的服务请求数数据)

请求示例

GET方式:

GET /2016-09-01/statistics/GetProvinceAndIspPvData?StartTime=2019-08-21T16%3A00%2B0800&EndTime=2019-08-22T18%3A00%2B0800&CdnType=live&DomainIds=2D09702&Provinces=shandong&Isps=&ResultType=1&Granularity=1440 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization: authorization string
x-action: GetProvinceAndIspPvData
x-version: 2016-09-01

POST方式:

POST  /2016-09-01/statistics/GetProvinceAndIspPvData 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization: authorization string
x-action: GetProvinceAndIspPvData
x-version: 2016-09-01
Content-Type: application/json
{
    "StartTime": "2019-08-21T16:00+0800",
    "EndTime": "2019-08-22T18:00+0800",
    "CdnType": "live",
    "DomainIds": "2D09702",
    "Provinces": "shandong",
    "Isps": "",
    "ResultType": 1,
    "Granularity": 1440
}

返回示例

{
    "StartTime": "2019-08-21T16:00+0800",
    "EndTime": "2019-08-22T18:00+0800",
    "CdnType": "live",
    "DomainIds": "2D09702",
    "ResultType": 1,
    "Granularity": 1440,
    "Provinces": "shandong",
    "Isps": "UN,CM,CT,CTT,PBS,CE,Other",
    "Datas": [
        {
            "Time": "2019-08-22T00:00+0800",
            "Pv": 69,
            "Domains": [
                {
                    "DomainId": "2D09702",
                    "Pv": 69,
                    "Provinces": [
                        {
                            "Province": "shandong",
                            "Pv": 69,
                            "Isps": [
                                {
                                    "Isp": "PBS",
                                    "Pv": 0
                                },
                                {
                                    "Isp": "CE",
                                    "Pv": 0
                                },
                                {
                                    "Isp": "UN",
                                    "Pv": 0
                                },
                                {
                                    "Isp": "CT",
                                    "Pv": 69
                                },
                                {
                                    "Isp": "Other",
                                    "Pv": 0
                                },
                                {
                                    "Isp": "CM",
                                    "Pv": 0
                                },
                                {
                                    "Isp": "CTT",
                                    "Pv": 0
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

错误码

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

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈