5.13.4 api pcap live

Funkce api/pcap/live slouží ke spuštění zachytávání chunk paketů.

Skupiny služeb privilegií
  • Služba je System.

  • Privilegia jsou Systém – řízení.

Metody

  • GET

  • POST

Požadavek

Požadavek obsahuje parametry ve formátu URL (nebo application/x-www-form-urlencoded při použití metody POST).


Tabulka 1. Parametry požadavku
Název parametruPovinnýOčekávané hodnotyVýchozí hodnotaPopis

duration

Ne

Celé číslo, které definuje délku stahování v sekundách

doba neurčitá

Definuje dobu trvání zachytávání paketů. Je-li parametr vynechán nebo roven 0, doba trvání je neurčitá (tj. dokud není stahování zastaveno funkcí api/pcap/live/stop nebo ukončeno cílovým zařízením).


Příklad požadavku

URL: https://192.168.1.1/api/pcap/live?duration=10


Odpověď

Zařízení začne streamovat chunky po úspěšném požadavku.


Příklad použití jazyka Python pro stažení zachycených paketů
command = requests.post( "https://" + address + "/api/pcap/live?duration=120", verify=False, stream=True, auth=HTTPBasicAuth("admin", "pass") ) with open("trace.pcap", 'wb') as f: for chunk in command.iter_content(chunk_size=None): f.write(chunk)
Pokud jedno zachytávání paketů už probíhá, není možné spustit další.