规则查询过滤器
功能介绍
查询过滤器。
调用方法
请参见如何调用API。
URI
GET /v1/criterion-filters
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
system_tag |
否 |
String |
参数解释: 引擎名称。 约束限制: 不涉及。 取值范围: sonarqube,wordstool,clangtidy,codemars,secbrella,cppcheck,apiengine,eslint,fixbotengine-java,fixbotengine-cxx,oat,pylint,SQLGuardian,cmetrics,codecheckrevive,clippy,detektout,cjlint,flake8,LuaGuardian,thirdpartycheck,FossScan,Infer_Java,testengine。 默认取值: 不涉及。 |
severitys |
否 |
String |
参数解释: 缺陷严重等级。 约束限制: 不涉及。 取值范围:
默认取值: "0,1,2,3",默认全部查询 |
languages |
否 |
String |
参数解释: 规则语言,多个以英文逗号分隔。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
search |
否 |
String |
参数解释: 关键字搜索。 约束限制: 不涉及。 取值范围: 不涉及 默认取值: 不涉及。 |
set_id |
否 |
String |
参数解释: 规则集ID,通过查询规则集列表接口可获取到规则集ID。 约束限制: 不涉及。 取值范围: 32位规则集ID。 默认取值: 不涉及。 |
status |
否 |
String |
参数解释: 规则集规则是否为启用状态。 约束限制: 不涉及。 取值范围:
默认取值: enable。 |
inherit |
否 |
String |
参数解释: 继承类型。 约束限制: 不涉及。 取值范围:
默认取值: 默认为null,查询所有继承类型规则。 |
onlines |
否 |
String |
参数解释: 上线状态。 约束限制: 不涉及。 取值范围:
默认取值: 1 |
show_tool_version |
否 |
String |
参数解释: 展示版本。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
tool_version |
否 |
String |
参数解释: 工具版本。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
cwe_search |
否 |
String |
参数解释: cwe搜索。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
compile |
否 |
String |
参数解释: 是否为编译类规则。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
security |
否 |
String |
参数解释: 安全与质量分类。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
industry_standards |
否 |
String |
参数解释: 业界标准。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
source_type |
否 |
String |
参数解释: 规则创建类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
project_id |
否 |
String |
参数解释: 项目的32位uuid,通过查询项目列表接口查询项目列表获取。 约束限制: 不涉及。 取值范围: 32位项目id。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
operator |
是 |
String |
参数解释: 操作人,填写账号用户名。 约束限制: 不涉及 取值范围: 字符串长度不少于1,不超过128。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
httpStatus |
String |
参数解释: HTTP响应状态,接口响应成功时为"OK",接口响应失败时为其他HTTP状态码。如INTERNAL_SERVER_ERROR为接口内部异常,BAD_REQUEST是参数校验异常。 取值范围:
|
result |
CriterionFilterInfo object |
参数解释: 规则过滤器。 取值范围: 不涉及。 |
status |
String |
参数解释: 接口响应状态。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
languageInfoList |
Array of FilterUnit objects |
参数解释: 语言过滤器列表。 取值范围: 不涉及。 |
severityInfoList |
Array of FilterUnit objects |
参数解释: 告警等级过滤器列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
filterKey |
String |
参数解释: 过滤器指标名。 取值范围:
|
filterValue |
Integer |
参数解释: 过滤器指标对应的数值。 取值范围: 不涉及。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
查询过滤器。
GET https://{endpoint}/v1/criterion-filters?system_tag=secbrella&languages=JAVA&tool_version=202507&onlines=1
响应示例
状态码:200
query filters and counts by filter
{ "httpStatus" : "OK", "result" : { "languageInfoList" : [ { "filterKey" : "java", "filterValue" : 4709 } ], "severityInfoList" : [ { "filterKey" : "1", "filterValue" : 209 } ] }, "status" : "success" }
状态码:400
Bad Request
{ "error_code" : "CC.00000000", "error_msg" : "网络繁忙,请稍后再试。" }
状态码:401
Unauthorized
{ "error_code" : "CC.00000003", "error_msg" : "认证信息过期。" }
状态码
状态码 |
描述 |
---|---|
200 |
query filters and counts by filter |
400 |
Bad Request |
401 |
Unauthorized |
错误码
请参见错误码。