GET - 查询所有过滤器

介绍查询所有过滤器的步骤。

接口介绍

获取当前系统上包含所有过滤器的列表。

请求方式（HTTP/1.1）

GET

接口地址

https://UCSS_URL/qkact/v1/filters/

请求参数

参数名称 参数位置 值 是否必须 描述
Content-Type header application/json 是 定义网络文件的类型和网页的编码。
Authorization header Basic base64("client-id:access-token") 是 base64加密的Http Basic认证。
即Basic 加密串，如Basic dXNlcjp1c2Vy。
注： client-id是客户端ID，access-token是在获取认证时返回的值。
User-Agent header QKAct-External-Client 是 检查浏览页面的访问者在用什么操作系统（包括版本号）浏览器（包括版本号）和用户个人偏好的代码。

返回结果（查询成功示例）

{
    "status":  0,
    "filters": [
        {
            "id": "abcd123-4567-8910-a475-0022647abcde",
            " sources":[
                {"user":{"value-type":"ip","value":"192,168,1,10"}},
                {"user": {"value-type":"ip","value":"192,168,1,21"}}],
            "destinations":[
                {"value-type":"url","value":"www,taobao,com"},
                {"value-type":"ip","value": "124,127,119,214"}],
            "policy-id": "abcd6c8-73ec-11df-a475-0022647abcde",
            "is-exception": false
        },
        {
            "id": "cdba123-4567-11df-a475-0022647abcde",
            "sources":[
                {"group":{"value-type":"LDAP","value":"cn=accouting,ou=groups,dc=skyguard,dc=com"},
                    "user":{"value-type":"LDAP","value":"cn=Samuel,ou=Beijing,dc=skyguard,dc=com"}},
                {"group":{"value-type":"LDAP","value":"cn=dev,ou=groups,dc=skyguard,dc=com"},
                    "user":{"value-type":"name","value":"Samuel Chen"}}],
            "policy-id": "abcd6c8-73ec-11df-a475-0022647abcde",
            "is-exception": true
        },
        {
            "id": "cadb123-4567-11df-a475-0022647abcde",
            "sources":[
                {"group":{"value-type":"name","value":"accounting"},
                    "user":{"value-type":"name","value":"Samuel"}}],
            "destinations":[
                {"value-type":"url","value": "www,taobao,com"}],
            "policy-id": "cddd123-4567-11df-a475-0022647abcde",
            "is-exception": false
        }
    ]
}
返回值参数定义如下表所示：
参数名 说明
status 请求是否成功，成功为0，失败为1。
filters 过滤器列表，包含当前系统下所有的过滤器。
id 过滤器ID。字段类型为String。
sources 来源，包括user和group两种。
user user的value-type包含email、ip、ip-range等配置字段，参考章节获取详细信息：过滤器源user的value-type参数说明。
group group的value-type包含name和LDAP配置字段，参考章节获取详细信息：过滤器源group的value-type参数说明。
policy-id 策略ID（对应UCSS策略UUID）
destinations 目标。destinations的value-type包含email、url、ip等配置字段，参考章节获取详细信息：过滤器目标的value-type参数说明。
is-exception 是否是例外规则。字段类型为boolean。

查询失败的返回结果示例

Content-Type: application/json
 
{
	 "status":  1,
	 "reason": "Invalid id"
}