setban

Back to network

Summary

Attempts to add or remove an IP/Subnet from the banned list.

Description

Attempts to add or remove an IP/Subnet from the banned list.

Arguments

  • subnet (STR, required): The IP/Subnet (see getpeerinfo for nodes IP) with an optional netmask (default is /32 = single IP)
  • command (STR, required): 'add' to add an IP/Subnet to the list, 'remove' to remove an IP/Subnet from the list
  • bantime (NUM): time in seconds how long (or until when if [absolute] is set) the IP is banned (0 or empty means using the default time of 24h which can also be overwritten by the -bantime startup argument)
  • absolute (BOOL): If set, the bantime must be an absolute timestamp expressed in UNIX epoch time

Results

  • value (NONE): No description.

Examples

qbit-cli setban "192.168.0.6" "add" 86400

qbit-cli setban "192.168.0.0/24" "add"

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "setban", "params": ["192.168.0.6", "add", 86400]}' -H 'content-type: application/json' http://127.0.0.1:8352/