调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-waf:ModifyUserLogFieldConfig

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	WAF 实例 ID。说明您可以通过调用 DescribeInstance 接口查看当前 WAF 实例 ID。	waf_v2_public_cn-fou****
FieldList	string	是	需投递的日志字段列表。使用"a,b,c,……"格式表示。说明需要包含所有必选日志字段, 您可以通过调用 DescribeCommonLogFields 接口查看 WAF 日志服务支持的日志字段信息。当日志字段中包含 request_header时，需要使用投递扩展配置（ExtendConfig）参数指定需要投递的请求头。	account,acl_action,acl_rule_id,acl_rule_type,acl_test,antiscan_action,antiscan_rule_id,antiscan_rule_type,antiscan_test,body_bytes_sent,bypass_matched_ids
ExtendConfig	string	否	日志投递扩展配置。以一系列参数构造的 JSON 格式转化成字符串。说明详细信息，请参见日志投递扩展配置参数描述。	{\"request_header\":\"App-Id,channelCode\"}
DeliveryType	string	否	投递类型。取值： sls：阿里云日志服务。	sls
LogDeliveryStrategy	string	否	日志投递策略，支持多个策略。以一系列参数构造的 JSON 数组格式转化成字符串。说明详细信息，请参见日志投递策略参数描述。	[{\"logType\":\"blockLog\",\"rate\":100},{\"logType\":\"normalRequestLog\",\"rate\":100},{\"logType\":\"checkLog\",\"rate\":100}]
RegionId	string	否	WAF 实例所属地域。取值： cn-hangzhou：表示中国内地。 ap-southeast-1：表示非中国内地。	cn-hangzhou
ResourceManagerResourceGroupId	string	否	阿里云资源组 ID。	rg-acfm***q

日志投递策略（LogDeliveryStrategy）参数描述

参数描述

名称	类型	是否必选	示例值	描述
logType	String	必选	blockLog	日志类型。取值： - blockLog：表示拦截日志。 - normalRequestLog：表示正常请求日志。 - checkLog：表示检测日志。
rate	Integer	必选	90	日志采样比。取值范围为[1-100]。

日志投递扩展配置（ExtendConfig）参数描述

参数描述

名称	类型	是否必选	示例值	描述
request_header	String	必选	blockLog	日志投递的请求头。最多支持 5 个，使用"a,b,c,……"格式表示。重要当投递日志字段中包含 request_header 时，该配置必须填写，否则会导致所有字段默认配置修改失败。

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次请求的 ID。	E2D63742-9BAA-*****

示例

正常返回示例

JSON格式

{
  "RequestId": "E2D63742-9BAA-*****"
}

错误码

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

变更历史

更多信息，参考变更详情。