GetDomainHttpCodeDetailedData

描述

本接口用于获取域名不同粒度（1分钟、5分钟、1小时、1天）的实时Http状态码访问次数及占比数据，用于绘制状态码占比曲线图。
当粒度为1小时或者1天时，取该粒度范围内所含5分钟点的累加和
时效性：5分钟
支持查询最近三个月内，最大跨度为90天的数据
支持域名（CdnType/Domain）、区域、省份、运营商、协议类型、 IP类型、粒度条件下查询
当Areas选项有且仅有CN时，Provinces和Isps选项才可生效，其余情况均走缺省设置，否则查询会失败
单次查询总返回数据点不超过10000个，域名数量不得超过1000个，且单次查询时间跨度至少包含一个时间粒度点（如，粒度为5分钟的时候，单次查询起止时间应大于等于5分钟)

请求语法

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

请求参数

参数名	必选	类型及范围	说明
StartTime	是	String	获取数据起始时间点，日期格式按ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:10+0800
EndTime	是	String	结束时间需大于起始时间；获取日期格式按照ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:15+0800
Interval	否	Long	统计粒度，取值为 1：1分钟粒度；取值为 5：5分钟粒度；60：1小时粒度；1440：1天粒度; 5分钟以上粒度的值取该粒度时间段内的5分钟粒度的累加和,缺省为5分钟粒度. 1分钟粒度查询范围最大跨度为24小时，5分钟粒度查询范围最大跨度为31天，其余粒度查询范围最大跨度为90天
CdnType	是	String	产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：图片小文件
Domains	否	String	当前账户下选择时间段内正在运行状态的加速域名，可输入需要查询的域名，支持批量域名查询，多个域名用逗号（半角）分隔，缺省为全部域名
Areas	否	String	网民分布区域简称，具体见【使用须知】，支持多区域查询，多个区域用逗号（半角）分隔，缺省为全部区域
Provinces	否	String	省份区域名称，枚举类型表见【使用须知】；支持省份批量查询，多个省份用逗号（半角）分隔，缺省为全部省份（当Areas选项有且仅有中国大陆选项时，此类型生效）
Isps	否	String	运营商名称，枚举类型表见【使用须知】；只允许输入一种类型，缺省为全部运营商，（当Areas选项有且仅有中国大陆选项时，此类型生效）
IpType	否	String	IP类型，取值为ipv4:ipv4类型数据;ipv6:ipv6类型数据；单选，缺省为全部IP类型
Schema	否	String	协议类型，取值为http:http协议数据; https:https协议数据；quic：quic协议数据，单选，缺省为全部协议类型
CodeType	否	String	状态码分类，取值为：2xx/3xx/4xx/5xx，默认为全部状态码类型
ResultType	否	String	统计结果数据展示方式，此处表示是否按照域名维度展开，支持不展开（unexpand）、按照具体域名维度展开（domain），按照具体状态码维度展开（code）、展开（expand）缺省为不展开（unexpand）方式

返回参数

参数名	类型及范围	说明
StartTime	String	开始时间
EndTime	String	结束时间
Interval	Long	粒度
CdnType	String	产品类型
Domains	String	域名列表，逗号（半角）间隔
Areas	String	区域，逗号（半角）间隔
Provinces	String	省份区域
Isps	String	运营商
IpType	String	IP类型
Schema	String	协议类型
ResultType	String	是否展开，以及展开的维度
CodeType	String	状态码分类，取值为：2xx/3xx/4xx/5xx
Datas	Datas[]	每个时间粒度的各种Http状态码数据及占比

Datas

参数名	类型及范围	说明
Condition	Condition	查询条件
HttpCodeData	HttpCodeData[]	Http状态码

Condition

参数名	类型及范围	说明
Domains	String	域名列表，逗号（半角）间隔

HttpCodeData

参数名	类型及范围	说明
Time	String	时间点
CodeType	CodeType[]	Http状态码类型占比统计，类型取值为2xx、3xx、4xx、5xx
CodeDetailDatas	CodeDetailDatas[]	Http具体状态码占比统计，如200/404等

CodeType

参数名	类型及范围	说明
CodeType	Srting	Http状态码类型
Pv	Long	此状态码类型总访问次数
Proportion	Double	此状态码类型总访问占比

CodeDetailDatas

参数名	类型及范围	说明
Code	Srting	Http具体状态码
Pv	Long	状态码访问次数
Proportion	Double	状态码占总访问次数占比

示例

请求示例

GET方式：

GET /2020-06-30/statistics/GetDomainHttpCodeDetailedData?StartTime=2020-09-01T08%3a00%2b0800&EndTime=2020-09-01T08%3a05%2b0800&Interval=5&CdnType=video&Domains=www.test.com&Areas=CN&Provinces=beijing&Isps=&IpType=&Schema=&CodeType=2xx,4xx&ResultType=
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainHttpCodeDetailedData
x-version: 2020-06-30

POST方式：

POST /2020-06-30/statistics/GetDomainHttpCodeDetailedData
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainHttpCodeDetailedData
x-version: 2020-06-30
Content-Type: application/json
{
    "StartTime":"2020-09-01T08:00+0800",
    "EndTime":"2020-09-01T08:05+0800",
    "Interval":5,
    "CdnType":"video",
    "Domains":"www.test.com",
    "Areas":"CN",
    "Provinces":"beijing",
    "Isps":"",
    "IpType":"",
    "Schema":"",
    "CodeType":"2xx,4xx",
    "ResultType":""
}

返回示例

{
    "StartTime": "2020-09-01T08:00+0800",
    "EndTime": "2020-09-01T08:05+0800",
    "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",
    "CodeType":"2xx,4xx",
    "ResultType": "unexpand",
    "Datas": [
        {
            "Condition":
                {
                    "Domains":"www.test.com"
                },
            "httpcodeData": 
            [
                {
                    "Time":"2020-09-01T08:00+0800",
                    "CodeType":
                    [
                        {
                            "CodeType":"2xx",
                    		"PV":300,
                    		"Proportion":50
                        },
                        {
                            "CodeType":"4xx",
                    		"PV":300,
                    		"Proportion":50
                        }
                    ]
                },
                {
                    "Time":"2020-09-01T08:05+0800",
                    "CodeType":
                    [
                        {
                            "CodeType":"2xx",
                    		"PV":300,
                    		"Proportion":50
                        },
                        {
                            "CodeType":"4xx",
                    		"PV":300,
                    		"Proportion":50
                        }
                    ]
                },
            ]
        }
    ],
    "RequestId": "7f9c419a-3f57-433b-8399-a6fcb68c8d8e"
}

文档导读

上一篇：服务状态码占比查询

下一篇：回源状态码查询

纯净模式常规模式

纯净模式

点击可全屏预览文档内容