调用DescribeDcdnWafFilterInfo查询自定义防护规则中匹配条件的匹配字段、逻辑符和匹配内容等信息。

使用说明

单用户调用频率:20次/秒。

调试

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

请求参数

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

系统规定参数。取值:DescribeDcdnWafFilterInfo

DefenseScenes String custom_acl

防护策略类型列表,多个用逗号(,)分隔。目前支持以下场景:

  • waf_group:Web基础防护
  • custom_acl:自定义防护策略
  • whitelist:白名单
说明 不传时,代表返回全部信息。
Language String cn

设置返回信息语言。取值范围:

  • en(默认):英文
  • cn:简体中文

返回数据

名称 类型 示例值 描述
RequestId String 153ca2cd-3c01-44be-204c-64dbc6c88630

请求ID。

Content Array of FilterInfo

查询到的信息。

DefenseScene String custom_acl

防护策略类型,同请求参数的DefenseScene。

Fields Array of Field

匹配条件信息。

ExtendField String 自定义Header

匹配字段的扩展tip,无此字段或此字段为空表示无扩展字段。

MatchField String Header

匹配字段。

LogicalSymbol Array of Logic

逻辑符。

Type String multi

可输入的匹配内容个数,取值:

  • multi:可输入多个匹配内容。
  • single:仅可输入单个匹配内容。
  • none:不能输入。
Symbol String match-one

代码内部传给后端逻辑符。

Tip String 可以输入多个,最多50个,按回车键确认

匹配内容中显示的提示信息。

MaxLength Integer 50

匹配内容可输入的最大个数限制,根据Type取值不同,该参数取值如下:

  • 取值为multi时,表示可输入的最大个数限制。
  • 取值为single时,该参数为1。
  • 取值为none时,该参数为0。
Description String 等于多值之一

控制台显示逻辑符。

Regexp Object

正则表达式。

Pattern String ^\S+$

正则表达式。

ErrMsg String 字段不能为空

匹配不上正则表达式的错误信息。

示例

请求示例

http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnWafFilterInfo
&Language=cn
&DefenseScenes=custom_acl
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDcdnWafFilterInfoResponse>
    <RequestId>153ca2cd-3c01-44be-204c-64dbc6c88630</RequestId>
    <Content>
        <DefenseScene>custom_acl</DefenseScene>
        <Fields>
            <ExtendField>自定义Header</ExtendField>
            <MatchField>Header</MatchField>
            <LogicalSymbol>
                <Type>multi</Type>
                <Symbol>match-one</Symbol>
                <Tip>可以输入多个,最多50个,按回车键确认</Tip>
                <MaxLength>50</MaxLength>
                <Description>等于多值之一</Description>
                <Regexp>
                    <Pattern>^\S+$</Pattern>
                    <ErrMsg>字段不能为空</ErrMsg>
                </Regexp>
            </LogicalSymbol>
        </Fields>
    </Content>
</DescribeDcdnWafFilterInfoResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "153ca2cd-3c01-44be-204c-64dbc6c88630",
  "Content" : [ {
    "DefenseScene" : "custom_acl",
    "Fields" : [ {
      "ExtendField" : "自定义Header",
      "MatchField" : "Header",
      "LogicalSymbol" : [ {
        "Type" : "multi",
        "Symbol" : "match-one",
        "Tip" : "可以输入多个,最多50个,按回车键确认",
        "MaxLength" : 50,
        "Description" : "等于多值之一",
        "Regexp" : {
          "Pattern" : "^\\S+$",
          "ErrMsg" : "字段不能为空"
        }
      } ]
    } ]
  } ]
}

错误码

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