最近更新时间:2022-03-17 17:10:29
本接口用于获取域名不同粒度(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 | 产品类型,只允许输入一种类型,取值为wcdn:全站加速 |
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。 |
参数名 | 类型及范围 | 说明 |
---|---|---|
Condition | Condition[] | 查询条件 |
Data | Data[] | 查询数据 |
参数名 | 类型及范围 | 说明 |
---|---|---|
Domains | String | 域名列表,逗号(半角)间隔 |
Areas | String | 区域,逗号(半角)间隔,,枚举类型表见使用须知 |
Provinces | String | 省份区域,按查询条件展示,无此条件,则不展示,枚举类型表见使用须知 |
Isps | String | 运营商,按查询条件展示,无此条件,则不展示,枚举类型表见使用须知 |
IpType | String | IP类型,按查询条件展示,无此条件,则不展示 |
SchemaType | String | 协议类型,按查询条件展示,无此条件,则不展示 |
参数名 | 类型及范围 | 说明 |
---|---|---|
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=wcdn&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": "2022-03-15T15:25+0800",
"CurrentPeriodEndTime": "2022-03-15T15:30+0800",
"PriorPeriodStartTime": "2022-03-15T15:35+0800",
"PriorPeriodEndTime": "2022-03-15T15:40+0800",
"Metric": "flow",
"CdnType": "wcdn",
"Domains": "wcdn-test1.ksc-test.com"
}
返回示例
{
"CurrentPeriodStartTime": "2022-03-15T15:25+0800",
"CurrentPeriodEndTime": "2022-03-15T15:30+0800",
"PriorPeriodStartTime": "2022-03-15T15:35+0800",
"PriorPeriodEndTime": "2022-03-15T15:40+0800",
"Metric": "flow",
"Interval": 5,
"CdnType": "wcdn",
"Domains": "wcdn-test1.ksc-test.com",
"Areas": "CN,HK,TW,MO,US,JP,SG,IN,ID,TH,MY,AU,VN,CA,GB,RU,DE,FR,BR,ZA,AE,PH,KR,Other",
"Provinces": "",
"Isps": "",
"IpType": "ipv4,ipv6",
"ResultType": "unexpand",
"RequestId": "501feb9e-1f05-4fdb-9a90-73ac0ed4d4ae",
"Datas": [
{
"Condition": {},
"Data": [
{
"CurrentPeriodTime": "2022-03-15T15:25+0800",
"PriorPeriodTime": "2022-03-15T15:35+0800",
"CurrentPeriodValue": 75028563,
"PriorPeriodValue": 115064029,
"PeriodRatio": -34.79
}
]
}
]
}
为了帮您快速定位问题,WCDN将错误码集中归类,请到【使用须知】查看详情。
纯净模式