defender

Get hosts

Returns hosts that are banned or for which some violations have been detected

get/defender/hosts

Request

Base URL
/api/v2 (relative, and the document was published on a file host, not at the API’s origin)
Auth
- HTTP bearer
- or API key in header X-SFTPGO-API-KEY
TypeScript
https://skmtc.dev/kanton-bern/apis/sftpgo/docs/defender/hosts/get.ts
A function with typed inputs. Its response is checked against the schema.

Response

successful operation

idstring

ipstring

scoreinteger

the score increases whenever a violation is detected, such as an attempt to log in using an incorrect password or invalid username. If the score exceeds the configured threshold, the IP is banned. Omitted for banned IPs

ban_timestring date-time

date time until the IP is banned. For already banned hosts, the ban time is increased each time a new violation is detected. Omitted if the IP is not banned

Changes

No recorded changes to this operation across all 1 revision of this API.

Get hosts

Request

Response 200OK

Changes

Response