修改日志配置信息-网宿科技

接口描述

更新日志配置。

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

请求参数

Path 参数

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

Body 参数

参数名称

描述

descriptionString

日志配置描述。

*hostnamesList

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

logDownloadFormatString

默认值: %cltip %rmtuser [%utctime] '%method %url %protocol' %statuscode %rspsize '%referer' '%ua' %rsptime 日志格式。可使用以下变量来自定义日志输出格式：

变量	变量说明
%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 每几分钟生成日志文件。

错误码

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

示例

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 "PATCH" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"description": "log configuration-UPD", "hostnames": ["testdomain.domain.info"], "logDownloadFormat": "%referer %method %rmtuser %scheme %utctime", "logDownloadStorageDays": 9, "logDownloadFileSpanMinutes": 1440}'

#!/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 "PATCH" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"description": "log configuration-UPD", "hostnames": ["testdomain.domain.info"], "logDownloadFormat": "%referer %method %rmtuser %scheme %utctime", "logDownloadStorageDays": 9, "logDownloadFileSpanMinutes": 1440}'

返回示例 复制代码 复制成功{ "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 参数

错误码

示例

目录

热门产品与方案

快速入口

支持与服务

投资者关系

法律申明

关于网宿

联系我们

业务咨询