查询日志配置详情-网宿科技

返回文档中心

API中心

适用产品

CDN Pro

接口描述

获取日志配置的详细信息。

调用URL： https://open.chinanetcenter.com/cdn/report/logConfigs/*
调用方法：GET

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

请求参数

Path 参数

参数名称	描述
*idInteger	日志配置的id。

返回参数

Body 参数

参数名称

描述

idInteger

取值范围: >= 1 日志配置的ID。

configsGetALogConfigurationResponseConfigs

日志配置。

descriptionString

日志配置描述信息。

hostnamesList

适用该日志配置的域名列表。每个域名必须是完整的FQDN域名如domain.com，或者是带星号的泛域名如*.domain.com。如果该日志配置适用于所有域名，则直接用星号*表示。每个域名有且只能有一个对应的日志配置。

logDownloadFormatString

日志格式。可使用以下变量来自定义日志输出格式：

变量	变量说明
%cachestate	缓存状态，取值为HIT，MISS 或者 REVALIDATE。
%cltip	客户端IP地址。
%cltisp	客户端所属运营商。
%cltport	客户端端口号。
%cltregion	客户端所属区域。
%cpu_ns	此次请求所消耗的CPU时间，以纳秒计算。
%custom1	如果您在加速项目中自定义了日志字段，可以用该变量来获取自定义日志字段1的值。自定义日志字段属于高级功能，如需使用请联系我们的技术支持。
%custom2	如果您在加速项目中自定义了日志字段，可以用该变量来获取自定义日志字段2的值。自定义日志字段属于高级功能，如需使用请联系我们的技术支持。
%hostname	Host 请求头。
%method	HTTP请求方法，例如 GET。
%protocol	HTTP/1.0，HTTP/1.1 或者 HTTP2.0协议。
%querystr	查询参数字符串。
%referer	Referer 请求头。
%reqhdrsize	请求头大小，单位为bytes。
%reqrange	客户端请求所携带的Range请求头。
%reqsize	请求的大小，单位为bytes。包括请求行，请求头和请求体。
%rmtuser	从Authorization请求头解析出的用户名。当您使用HTTP basic对用户请求进行鉴权时，可通过该变量获取用户名。
%rspsize	HTTP响应的大小，单位为bytes。包括响应头和响应体，但不包括TCP/IP/MAC头部开销。
%rsptime	响应时间，单位为毫秒。
%samplerate	采样率，即每几个请求输出一条日志。
%sheme	http或https协议。
%statuscode	响应状态码，例如200。
%srvip	处理此次请求的CDN服务器的IP地址。
%svrnode	CDN服务器所在的节点名称。
%tcprtt	服务器与客户端之间的RTT时长，单位为毫秒。
%ua	User-Agent 请求头。
%uniqueid	此次请求的唯一标识，字符串类型。
%url	完整的URL，包括查询参数字符串。
%utctime	响应时间，以RFC 3339格式表示，例如 2021-10-05T12:34:56Z。

变量如果包含了不可打印的字符（ASCII码<=0x1F 或 >=0x7F的字符），双引号或者反斜杆，则这些字符会被转义，用'\xXX'的格式表示。例如，双引号以'\x22'表示，反斜杆以'\x5C'表示。需要注意的是，空格不会被转义。如果变量包含空格，则必须加上双引号，才能被正确解析。

logDownloadStorageDaysInteger

默认值: 14 取值范围: [ 1 .. 30 ] 日志保存天数。

logDownloadFileSpanMinutesInteger

取值范围: 5,15,30,60,120,240,480,1440 默认值: 30 每几分钟生成日志文件。

lastUpdateTimeString

日志配置最近一次更新时间，以RFC 3339日期格式展示。

creationTimeString

日志配置创建时间，以RFC 3339日期格式展示。

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
InvalidLogConfigId	The specified log config ID does not exist or the caller doesn't have access to this resource.	400	指定的日志配置ID不存在，或者您无访问权限。

示例

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/logConfigs/{id}" \ -X "GET" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json"

#!/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/logConfigs/{id}" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json"

返回示例 复制代码 复制成功{ "id": 1, "configs": { "description": "my log configuration", "hostnames": [ "domain.com" ], "logDownloadFormat": "%cltip %rmtuser [%utctime] \"%method %url %protocol\" %statuscode %rspsize \"%referer\" \"%ua\" %rsptime", "logDownloadStorageDays": 14, "logDownloadFileSpanMinutes": 30 }, "creationTime": "2021-12-14T22:48:08Z", "lastUpdateTime": "2021-12-14T22:48:08Z" }

{
    "id": 1,
    "configs": {
        "description": "my log configuration",
        "hostnames": [
            "domain.com"
        ],
        "logDownloadFormat": "%cltip %rmtuser  [%utctime] \"%method %url %protocol\" %statuscode %rspsize \"%referer\" \"%ua\" %rsptime",
        "logDownloadStorageDays": 14,
        "logDownloadFileSpanMinutes": 30
    },
    "creationTime": "2021-12-14T22:48:08Z",
    "lastUpdateTime": "2021-12-14T22:48:08Z"
}

400

#!/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/logConfigs/{id}" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json"

返回示例 复制代码 复制成功{ "code": "InvalidLogConfigId", "message": "The specified log config ID does not exist or the caller doesn't have access to this resource." }

{
    "code": "InvalidLogConfigId",
    "message": "The specified log config ID does not exist or the caller doesn't have access to this resource."
}

404

#!/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/logConfigs/{id}" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json"

返回示例 复制代码 复制成功{ "code": "InvalidLogConfigId", "message": "The specified log config ID does not exist or the caller doesn't have access to this resource." }

{
    "code": "InvalidLogConfigId",
    "message": "The specified log config ID does not exist or the caller doesn't have access to this resource."
}

本篇文档内容对您是否有帮助？

有帮助

我要反馈

查询日志配置详情

适用产品

接口描述

请求参数

Path 参数

返回参数

Body 参数

错误码

示例

目录

热门产品与方案

快速入口

支持与服务

投资者关系

法律申明

关于网宿

联系我们

业务咨询