getSiteCapturingStatus
GET https://{{host}}/api/v1/sites/:site_id/pcaps/capture
Response Parameters
Name | Type | Description |
---|---|---|
type | string | packet capture type, for example: new_assoc, client, wired, wireless, radiotap, gateway |
aps | []string | List of target APs to capture packets |
ok | []string | List of target APs successfully configured to capture packets |
failed | []string | List of APs where configuration attempt failed |
gateways | dict | Information on gateways to capture packets on if a gateway capture type is specified |
switches | dict | Information on switches to capture packets on if a switch capture type is specified. irb port interface is automatically added to capture as needed to ensure all desired packets are captured. |
id | string | unique id for the capture |
max_num_packets | int | max number of packets configured by user |
num_packets | int | total number of packets captured by all AP, not applicable for type [client, new_assoc] |
tcpdump_expression | string | tcpdump expression provided by the user (common) |
wired_tcpdump_expression | string | wiredtcpdumpexpression provided by the user when type = ‘wired’ |
radiotap_tcpdump_expression | string | radiotaptcpdumpexpression expression provided by the user when type = ‘rdiotap’ |
scan_tcpdump_expression | string | scantcpdumpexpression provided by the user when type = ‘scan’ |
wireless_tcpdump_expression | string | wirelesstcpdumpexpression provided by the user when type = ‘wireless’ |
pcap_aps | dict | contains AP specific configuration selected by user during scan pcap. |
RESPONSES
status: OK
{"type":"radiotap","max_pkt_len":128,"includes_mcast":false,"ssid":null,"ap_mac":null,"client_mac":"60a10a773412","max_num_packets":1000,"num_packets":999,"duration":300,"id":"87093aed-94d6-4310-83a9-d7248c9e2d93","tcpdump_expression":"vlan and icmp","started_time":1435080709,"aps":["5c5b350e001c","5c5b350e001b"],"ok":["5c5b350e001c","5c5b350e001b"],"failed":[],"pcap_aps":{"5c5b35000010":{"band":"6","bandwidth":"20","channel":133,"tcpdump_expression":null}}}