调用ModifyLogRetrievalStatus为指定域名开启或关闭日志检索功能。
说明 日志检索功能已经升级为WAF日志服务功能,更多信息,请参见WAF日志服务。该接口仅适用于保有日志检索功能的存量用户。如果您需要为域名开启或关闭WAF日志服务,请调用ModifyLogServiceStatus。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyLogRetrievalStatus |
要执行的操作。取值:ModifyLogRetrievalStatus。 |
Domain | String | 是 | www.example.com |
已添加的域名名称。 说明 您可以调用DescribeDomainNames查询所有已经添加的域名。
|
Enabled | Integer | 是 | 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"
}
错误码
访问错误中心查看更多错误码。