Rescan host
Changed onStarts a one-shot scan of this host's addresses and nothing else, answering "is this host still there, and is its data current?" without sweeping the whole subnet.
The scan runs on the daemon that last discovered this host, which is evidence it can reach the address. Where the daemon has an interface with a MAC on the address's subnet it ARPs the target, which sees a live host even when every port is firewalled. Every other address, on a MAC-less interface (a point-to-point tunnel) or on a subnet the daemon reaches through a router, is probed by TCP. An address that doesn't answer comes back as not found. A loopback address is reached locally and is excluded from the target set.
Daemons at or below last_without_routed_rescan only rescan addresses on subnets they have an interface on, and the request is refused when the host has none.
Returns the session, which streams progress over /api/v1/live-updates/stream like any other scan. A Queued phase means the daemon is busy; it will start when the running scan finishes.
Request
- Base URLhttps://app.scanopy.net
- URLhttps://app.scanopy.net/api/v1/hosts/{id}/rescan
- Auth
- API key in header Authorization
- or API key in cookie session_id
Path parameters
Host ID
Response
Rescan session started
Example response
{
"data": {
"warnings": [
{
"daemon_version": "0.18.0",
"last_unsupported_daemon_version": "0.18.0"
}
]
},
"meta": {
"api_version": 1,
"server_version": "0.19.4"
}
}Changes
- breaking
added
subschema #56to the//response propertyoneOflist for the response status
- breaking
- warning
added the new
DaemonDroppedSessionenum value to the/////response property for the response status - warning
added the new
DaemonOfflineenum value to the/////response property for the response status - warning
added the new
SessionSilentenum value to the/////response property for the response status
- warning