创建BotM流量检测条件
功能介绍
创建BotM流量检测条件
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/waf/policy/{policy_id}/bot-manager/traffic-detection-condition
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
project_id |
policy_id |
是 |
String |
policyId |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
enterprise_project_id |
否 |
String |
您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
租户token |
Content-Type |
是 |
String |
内容类型 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
condition |
否 |
TrafficDetectionConditionDTO object |
流量检测条件 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
参数解释: Id,唯一标识当前流量检测条件。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_field |
否 |
String |
参数解释: 匹配字段(类别),标识流量筛选的字段类型(如url表示URL路径)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_field_index |
否 |
String |
参数解释: 子字段,匹配字段的细分维度(如无则不填)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
logical_operator |
否 |
String |
参数解释: 逻辑运算符,标识匹配条件的逻辑关系(如contain表示包含)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_contents |
否 |
Array of strings |
参数解释: 匹配内容,符合筛选条件的具体值列表(如特定URL路径)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
value_list_res |
否 |
String |
参数解释: 引用表Id,关联预设的匹配内容列表ID(如无则不填)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: Id,唯一标识当前流量检测条件。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_field |
String |
参数解释: 匹配字段(类别),标识流量筛选的字段类型(如url表示URL路径)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_field_index |
String |
参数解释: 子字段,匹配字段的细分维度(如无则不填)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
logical_operator |
String |
参数解释: 逻辑运算符,标识匹配条件的逻辑关系(如contain表示包含)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
match_contents |
Array of strings |
参数解释: 匹配内容,符合筛选条件的具体值列表(如特定URL路径)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
value_list_res |
String |
参数解释: 引用表Id,关联预设的匹配内容列表ID(如无则不填)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
encoded_authorization_message |
String |
编码 (加密) 后的详细拒绝原因,用户可以自行调用 STS 服务的decode-authorization-message接口进行解码,可参考STS5联调自验证。IAM5鉴权错误时才会返回此字段。 |
details |
Array of IAM5ErrorDetails objects |
调用下游服务的报错信息集合,IAM5鉴权错误时才会返回此字段。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
encoded_authorization_message |
String |
编码 (加密) 后的详细拒绝原因,用户可以自行调用 STS 服务的decode-authorization-message接口进行解码,可参考STS5联调自验证。IAM5鉴权错误时才会返回此字段。 |
details |
Array of IAM5ErrorDetails objects |
调用下游服务的报错信息集合,IAM5鉴权错误时才会返回此字段。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误信息 |
encoded_authorization_message |
String |
编码 (加密) 后的详细拒绝原因,用户可以自行调用 STS 服务的decode-authorization-message接口进行解码,可参考STS5联调自验证。IAM5鉴权错误时才会返回此字段。 |
details |
Array of IAM5ErrorDetails objects |
调用下游服务的报错信息集合,IAM5鉴权错误时才会返回此字段。 |
请求示例
{ "enable" : true }
响应示例
状态码:200
请求成功
{ "id" : "cond-8f7e6d5c", "match_field" : "request_header", "match_field_index" : "User-Agent", "logical_operator" : "not_contain", "match_contents" : [ "bot", "crawler", "spider" ], "value_list_res" : "vl-1a2b3c4d" }
状态码
状态码 |
描述 |
---|---|
200 |
请求成功 |
400 |
请求失败 |
401 |
token权限不足 |
500 |
服务器内部错误 |
错误码
请参见错误码。