调用ModifyLogRetrievalStatus为指定域名开启或关闭日志检索功能。

说明 日志检索功能已经升级为WAF日志服务功能,更多信息,请参见WAF日志服务。该接口仅适用于保有日志检索功能的存量用户。如果您需要为域名开启或关闭WAF日志服务,请调用ModifyLogServiceStatus

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyLogRetrievalStatus

要执行的操作。取值:ModifyLogRetrievalStatus

Domain String www.example.com

已添加的域名名称。

说明 您可以调用DescribeDomainNames查询所有已经添加的域名。
Enabled Integer 1

是否开启日志检索功能,取值:

  • 0:表示关闭。
  • 1:表示开启。
说明 只有为域名开启日志检索功能后,WAF才会记录该域名的访问请求日志。如果您关闭日志检索功能,则处于关闭状态期间的访问请求日志不会被记录;即使重新开启日志检索功能,您也无法查询到停用期间的访问请求日志。
InstanceId String waf_elasticity-cn-0xldbqt****

要操作的WAF实例ID。

说明 您可以调用DescribeInstanceInfo查询WAF实例的ID。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String D7861F61-5B61-46CE-A47C-6B19160D5EB0

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyLogRetrievalStatus
&Domain=www.example.com
&Enabled=1
&InstanceId=waf_elasticity-cn-0xldbqt****
&<公共请求参数>

正常返回示例

XML 格式

<ModifyLogRetrievalStatusResponse>
	  <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
</ModifyLogRetrievalStatusResponse>

JSON 格式

{
    "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

错误码

访问错误中心查看更多错误码。