数据对比

最近更新时间:2021-04-27 15:25:23

查看PDF

GetDomainRequestPeriodRatioData

描述

  • 本接口用于获取域名不同粒度(1分钟、5分钟、1小时、1天)的统计数据,含flow:流量,单位为 byte;bandwidth:带宽,单位为 bps;request:请求数,单位为 次;qps:平均每秒请求次数,单位:次/秒
    当粒度为1小时或者1天时,带宽取该粒度范围内所含5分钟点的最大峰值点

  • 支持查询最近一年内,最大跨度为31天的数据

  • 国内细化数据查询,支持到域名(CdnType/Domain)、区域、省份、运营商、协议类型、IP类型、粒度 多维度数据查询

  • 当Areas选项有且仅有CN时,Provinces和Isps选项才可生效,其余情况均走默认,否则查询会失败

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

请求语法

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

请求参数

参数名 必选 类型及范围 说明
CurrentPeriodStartTime String 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
CurrentPeriodEndTime String 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
PriorPeriodStartTime String 获取数据起始时间点,不可与CurrentPeriodStartTime相同,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
PriorPeriodEndTime String 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如: 2016-08-01T21:14+0800
Metric String 指定查询指标,单选,支持的类型为:flow:流量,单位为 byte;bandwidth:带宽,单位为 bps;request:请求数,单位为 次;qps:平均每秒请求次数,单位:次
CdnType String 产品类型,只允许输入一种类型,取值为file:大文件下载,video:音视频点播,page:图片小文件,live:流媒体直播
Interval Long 统计粒度,取值为 1:1分钟粒度;取值为 5:5分钟粒度;60:1小时粒度;1440:1天粒度;5分钟及以上粒度的带宽值均取该粒度时间段内的5分钟粒度的峰值点。默认为5分钟粒度1分钟粒度查询范围最大跨度为24小时5分钟粒度查询范围最大跨度为31天其余粒度查询范围最大跨度为31天
Domains String 当前账户下选择时间段内正在运行状态的加速域名,可输入需要查询的域名,支持批量域名查询,多个域名用逗号(半角)分隔,缺省为全部域名
Areas String 网民分布区域简称,具体见下附录说明,支持多区域查询,多个区域用逗号(半角)分隔,缺省为全部区域
Provinces String 省份区域名称, 枚举类型表见使用须知;支持省份批量查询,多个省份用逗号(半角)分隔,缺省为全部省份(当Areas选项有且仅有中国大陆选项时,此类型生效),具体Provinces见下附录说明
Isps String 运营商名称,枚举类型表见使用须知;只允许输入一种类型,缺省为全部运营商,(当Areas选项有且仅有中国大陆选项时,此类型生效),具体ISP见下附录说明
IpType String IP类型,取值为Ipv4:IPv4类型数据;Ipv6:IPv6类型数据;单选,缺省为全部IP类型
Schema String 协议类型, 取值为http:http协议数据; https:https协议数据;quic:quic协议数据,单选,缺省为全部协议类型
ResultType String 统计结果数据展示方式,支持不展开和按一种维度展开,缺省为 不展开(unexpand)可展开维度包含:区域(area)、域名(domain)、省份(province)、运营商(isp)、IP类型(ip)、协议类型(schema),

返回参数

参数名 类型及范围 说明
CurrentPeriodStartTime String 开始时间
CurrentPeriodEndTime String 结束时间
PriorPeriodStartTime String 开始时间
PriorPeriodEndTime String 结束时间
Metric String 本次查询指标
Interval Long 粒度
CdnType String 产品类型
Domains String 域名列表,逗号(半角)间隔
Areas String 区域,逗号(半角)间隔
Provinces String 省份区域
Isps String 运营商
IpType String IP类型
SchemaType String 协议类型
ResultType String 是否展开,以及展开的维度
Datas Datas[] 不同条件下的统计数据
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

Datas

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

Condition

参数名 类型及范围 说明
Domains String 域名列表,逗号(半角)间隔
Areas String 区域,逗号(半角)间隔
Provinces String 省份区域,按查询条件展示,无此条件,则不展示
Isps String 运营商,按查询条件展示,无此条件,则不展示
IpType String IP类型,按查询条件展示,无此条件,则不展示
SchemaType String 协议类型,按查询条件展示,无此条件,则不展示

Data

参数名 类型及范围 说明
CurrentPeriodTime String 当前时间点
PriorPeriodTime String 对比时间点
CurrentPeriodValue Long 当前范围内此时间点对应的查询数据值,不同的条件此处对应的值不一样,具体见下flow:流量,单位为 byte;bandwidth:带宽,单位为 bps;request:请求数,单位为 次;qps:平均每秒请求次数,单位:次
PriorPeriodValue Long 对比的时间范围内此时间点对应的查询数据值,不同的条件此处对应的值不一样,具体见下flow:流量,单位为 byte;bandwidth:带宽,单位为 bps;request:请求数,单位为 次;qps:平均每秒请求次数,单位:次
PeriodRatio Double 环比百分数,单位“%”,小数点后保留两位数据计算方法:(当期时间点数值-对比时间点数值)/对比时间点数值*100%

示例

请求示例

GET方式:

GET /2020-06-30/statistics/GetDomainRequestPeriodRatioData?CurrentPeriodStartTime=2020-09-01T08%3a00%2b0800&CurrentPeriodEndTime=2020-09-01T08%3a05%2b0800&PriorPeriodStartTime=2020-09-02T08%3a00%2b0800&PriorPeriodEndTime=2020-09-02T08%3a05%2b0800&Metric=flow&Areas=CN&Provinces=beijing&CdnType=video&ResultType=
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainRequestPeriodRatioData
x-version: 2020-06-30

POST方式:

POST /2020-06-30/statistics/GetDomainRequestPeriodRatioData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainRequestPeriodRatioData
x-version: 2020-06-30
Content-Type: application/json
{
    "CurrentPeriodStartTime":"2020-09-01T08:00+0800",
    "CurrentPeriodEndTime":"2020-09-01T08:05+0800",
    "PriorPeriodStartTime":"2020-09-02T08:00+0800",
    "PriorPeriodEndTime":"2020-09-02T08:05+0800",
    "Metric":"flow",
    "Areas":"CN",
    "Provinces":"beijing",
    "CdnType":"video",
    "ResultType":""
}

返回示例

{
    "CurrentPeriodStartTime": "2020-09-01T08:00+0800",
    "CurrentPeriodEndTime": "2020-09-01T08:05+0800",
    "PriorPeriodStartTime": "2020-09-02T08:00+0800",
    "PriorPeriodEndTime": "2020-09-02T08:05+0800",
    "Metric": "flow",
    "Interval": 5,
    "CdnType": "video",
    "Domains": "www.test.com",
    "Areas": "CN",
    "Provinces": "beijing",
    "Isps": "PBS,CT,CTT,CE,UN,CM,Other",
    "IpType": "ipv4,ipv6",
    "Schema": "http,https,quic",
    "ResultType": "unexpand",
    "RequestId": "e421e643-178f-4d5e-91a2-f9ee632daf08",
    "Datas": [
        {
            "Condition": {},
            "Data": [
                {
                    "CurrentPeriodTime": "2020-09-01T08:00+0800",
                    "PriorPeriodTime": "2020-09-02T08:00+0800",
                    "CurrentPeriodValue": 0,
                    "PriorPeriodValue": 0,
                    "PeriodRatio": 0.0
                }
            ]
        }
    ]
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈