CDN加速

查询边缘节点状态码详情

更新时间：2023-03-28 17:39:48

适用产品

CDN Pro

接口描述

获取一段时间内的边缘状态码统计信息。可以使用查询参数指定时间段、协议和数据粒度。通过在请求体中传递filters对象可进一步指定查询范围。此报表的数据延迟最长可达30分钟。

调用频率

单用户调用频率：300/5min

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Params 参数

参数名称描述
*startdateString
查询范围的开始时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：startdate=2019-10-30T00:00:00Z。 根据type参数对应的粒度，您指定的开始时间可能被向前取整为最近的分钟、小时或天。例如，如果您指定 startdate=2019-09-05T03:14:01Z&type=hourly，则返回从2019-09-05T03:00:00Z开始的数据。
*enddateString
查询范围的结束时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：enddate=2019-11-14T00:00:00Z。根据type参数对应的粒度，您指定的结束时间可能被向后取整为最近的分钟、小时或天。例如，如果您指定 enddate=2019-09-05T03:14:01Z&type=hourly，则返回截止到2019-09-05T04:00:00Z的数据。
*typeString
取值范围: fiveminutes,hourly,daily,monthly 指定返回数据的粒度，支持5分钟，小时，日，月粒度。默认情况下，我们以UTC 00:00:00作为一天的开始。如果您希望指定不同的时区，可以附加时区标识，即-12、-11、-10、-9、-8、-7、-6、-5、-4、-3、-2、-1、+1、+2、+3、+4、+5、+6、+7、+8、+9、+10、+11、+12。例如，type=daily+8表示使用UTC+8时区指定一天的开始时间。
schemeString
取值范围: [ 0 .. 5 ] 字符 取值范围: http,https,all 默认值: all 指定查询HTTP与/或HTTPS协议的数据。默认查询全部2种协议的数据。

Body 参数

参数名称描述
filtersObject
指定查询条件过滤报表数据。
hostnamesList
指定加速域名进行查询。可使用泛域名，如*.domain.com。如果未指定，将返回所有加速域名的数据。

返回参数

Body 参数

参数名称描述
dataNameString
对返回数据的简要描述。
dataUnitString
取值范围: counts 计量单位。对于状态码报表接口，单位为'次数'，表示某个状态码出现的次数。
dataSeriesList
不同时间点的状态码统计信息。
timestampString
RFC 3339格式的日期，表示每个时间段的开始时间。
detailsList
statusCodeString
HTTP状态码，例如'200'。
dataInteger
取值范围: >= 0 状态码出现的次数。

错误码

错误代码（code）描述（message）HTTP状态码语义
InvalidTypeInvalid parameter 'type': 'invalidReportType'. The report type must be 'fiveminutes', 'hourly', 'daily'(with optional timezone) or 'monthly'(with optional timezone).400type参数取值无效。必须是'fiveminutes'，'hourly'，'daily'（可携带时区标识），或'monthly'（可携带时区标识）。
InvalidTimeSpanThe max time span of 'hourly' report must be no more than 92 days.400以小时为粒度进行查询时，查询的时间跨度不能超过92天。

示例

200
400
200
请求示例
复制代码 复制成功
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://open.chinanetcenter.com/cdn/report/statusCodeDetails?startdate=2023-01-01T00:00:00Z&enddate=2023-01-02T00:00:00Z&type=daily" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"filters": {"hostnames": ["domain.info"]}}'
返回示例
复制代码 复制成功
{
    "dataName": "edge status code",
    "dataUnit": "counts",
    "dataSeries": [
        {
            "timestamp": "2019-11-04T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 219
                },
                {
                    "statusCode": "404",
                    "data": 1
                }
            ]
        },
        {
            "timestamp": "2019-11-05T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 209
                }
            ]
        },
        {
            "timestamp": "2019-11-06T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 206
                },
                {
                    "statusCode": "404",
                    "data": 1
                },
                {
                    "statusCode": "504",
                    "data": 1
                }
            ]
        },
        {
            "timestamp": "2019-11-07T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 104
                }
            ]
        },
        {
            "timestamp": "2019-11-08T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 320
                },
                {
                    "statusCode": "404",
                    "data": 7
                }
            ]
        },
        {
            "timestamp": "2019-11-09T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 198
                }
            ]
        },
        {
            "timestamp": "2019-11-10T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 198
                }
            ]
        },
        {
            "timestamp": "2019-11-11T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 396
                }
            ]
        },
        {
            "timestamp": "2019-11-12T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 199
                }
            ]
        },
        {
            "timestamp": "2019-11-13T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 198
                }
            ]
        },
        {
            "timestamp": "2019-11-14T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 204
                },
                {
                    "statusCode": "502",
                    "data": 2
                },
                {
                    "statusCode": "504",
                    "data": 1
                }
            ]
        },
        {
            "timestamp": "2019-11-15T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 161
                }
            ]
        },
        {
            "timestamp": "2019-11-16T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 174
                }
            ]
        },
        {
            "timestamp": "2019-11-17T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 175
                }
            ]
        },
        {
            "timestamp": "2019-11-18T00:00:00Z",
            "details": [
                {
                    "statusCode": "200",
                    "data": 376
                }
            ]
        }
    ]
}
本篇文档内容对您是否有帮助？
有帮助
我要反馈
提交成功！非常感谢您的反馈，我们会继续努力做到更好！