{"type":"api","title":"url filtering devices list","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/d2f02ba2-fd0d-3a26-bcc5-feafc8f24d17","info":{"title":"Monitoring and Troubleshooting","description":"Includes API operations for the following:\n- Real-time monitoring\n- Accessing statistics APIs and statistics bulk APIs\n- Retrieving device state\n- Managing alarms and events\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Monitoring - Security Policy"],"summary":"url filtering devices list","description":"Get url filtering devices list ","operationId":"getPostUrlFilteringByQuery","requestBody":{"description":"Stats query string","content":{"application/json":{"schema":{"type":"object"},"examples":{"url filtering pass device query":{"description":"url filtering pass device query","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","type":"date","value":["24"],"operator":"last_n_hours"},{"field":"name","type":"string","value":["Financial Services"],"operator":"equal"},{"field":"pass","type":"string","value":["0"],"operator":"greater"},{"field":"type","type":"string","value":["urlf_category"],"operator":"in"}]},"aggregation":{"field":[{"property":"host_name","sequence":1},{"property":"siteid","sequence":2},{"property":"src_ip","sequence":3},{"property":"dst_ip","sequence":4}],"metrics":[{"property":"entry_time","type":"top_hits","size":1}]}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceSecuritySecurityapiParameterExampleUrlfilteringpassdevice"},"url filtering block device query":{"description":"url filtering block device query","value":{"query":{"condition":"AND","rules":[{"field":"entry_time","type":"date","value":["24"],"operator":"last_n_hours"},{"field":"name","type":"string","value":["Gambling"],"operator":"equal"},{"field":"block","type":"string","value":["0"],"operator":"greater"},{"field":"type","type":"string","value":["urlf_category"],"operator":"in"}]},"aggregation":{"field":[{"property":"host_name","sequence":1},{"property":"siteid","sequence":2},{"property":"src_ip","sequence":3},{"property":"dst_ip","sequence":4}],"metrics":[{"property":"entry_time","type":"top_hits","size":1}]}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceSecuritySecurityapiParameterExampleUrlfilteringblockdevice"},"url filtering exempt white/black list device query":{"description":"url filtering exempt white/black list device query","value":{"aggregation":{"field":[{"property":"host_name","sequence":1},{"property":"siteid","sequence":2},{"property":"src_ip","sequence":3},{"property":"dst_ip","sequence":4}],"metrics":[{"property":"entry_time","type":"top_hits","size":1}]},"query":{"condition":"AND","rules":[{"value":["24"],"field":"entry_time","type":"date","operator":"last_n_hours"},{"value":["0"],"field":"whiteblack_list_hit_cnt","type":"number","operator":"greater"},{"value":["urlf"],"field":"type","type":"string","operator":"in"}]}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceSecuritySecurityapiParameterExampleUrlfilteringexemptwitblklistdevice"},"amp device query":{"description":"amp device query","value":{"aggregation":{"field":[{"property":"host_name","sequence":1},{"property":"siteid","sequence":2},{"property":"src_ip","sequence":3},{"property":"dst_ip","sequence":4}],"metrics":[{"property":"entry_time","type":"top_hits","size":1}]},"query":{"condition":"AND","rules":[{"value":["48"],"field":"entry_time","type":"date","operator":"last_n_hours"},{"value":["pdf"],"field":"filename","type":"string","operator":"equal"},{"value":["0"],"field":"disposition","type":"string","operator":"equal"},{"value":["file_reputation_alert"],"field":"type","type":"string","operator":"in"}]}},"$$ref":"#/components/examples/ComViptelaVmanageServerDeviceSecuritySecurityapiParameterExampleAmpdevice"}}}},"required":true},"responses":{"200":{"description":"search results matching criteria","content":{"application/json":{"schema":{"type":"array","items":{"required":["entry_time"],"type":"object","properties":{"device_ip":{"type":"string","example":"1.1.1.1"},"entry_time":{"type":"integer","format":"int64","example":1639897200000},"host_name":{"type":"string","example":"vm1"},"site_name":{"type":"string","example":"sjc"}},"$$ref":"#/components/schemas/DeviceLists"}}}}},"400":{"description":"bad input parameter"}},"x-roles-required":"Security-read,Device Monitoring-read","method":"post","path":"/security/policy/urlf/device"}}