setban "subnet" "command" ( bantime absolute )
Attempts to add or remove an IP/Subnet from the banned list.
Arguments:
1. subnet (string, required) The IP/Subnet (see getpeerinfo for nodes IP) with an optional netmask (default is /32 = single IP)
2. command (string, required) 'add' to add an IP/Subnet to the list, 'remove' to remove an IP/Subnet from the list
3. bantime (numeric, optional, default=0) 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)
4. absolute (boolean, optional, default=false) If set, the bantime must be an absolute timestamp expressed in UNIX epoch time
Result:
null (json null)
Examples:
> spacexpanse-cli setban "192.168.0.6" "add" 86400
> spacexpanse-cli setban "192.168.0.0/24" "add"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "setban", "params": ["192.168.0.6", "add", 86400]}' -H 'content-type: text/plain;' http://127.0.0.1:11998/
[
{
"name": "subnet",
"detailsLines": [],
"properties": [
"string",
"required"
],
"description": "The IP/Subnet (see getpeerinfo for nodes IP) with an optional netmask (default is /32 = single IP)"
},
{
"name": "command",
"detailsLines": [],
"properties": [
"string",
"required"
],
"description": "'add' to add an IP/Subnet to the list, 'remove' to remove an IP/Subnet from the list"
},
{
"name": "bantime",
"detailsLines": [],
"properties": [
"numeric",
"optional",
"default=0"
],
"description": "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)"
},
{
"name": "absolute",
"detailsLines": [],
"properties": [
"boolean",
"optional",
"default=false"
],
"description": "If set, the bantime must be an absolute timestamp expressed in UNIX epoch time"
}
]