Test scan routes

post

https://cloud.tenable.com/scans/check-auto-targets

Evaluates a list of targets and/or tags against the scan route configuration of scanner groups. Returns the list of missed targets (if any) and the list of matched scanner groups (if any).

Requires the Basic [16] user role or the VM.VM_SCAN.VM_SCAN.READ custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

int32

Defaults to null

Limit the number of missed targets returned in the response.

matched_resource_limit

int32

Defaults to null

Limit the number of matched resource UUIDs returned in the response.

Body Params

network_uuid

string

required

Specify a value as follows:

If your scans involve separate environments with overlapping IP ranges, specify the UUID of the network you want to associate with the results of the auto-routed scan. This value must match the network where you have assigned the scanner groups that you configured for scan routing.
Otherwise, specify the default network (00000000-0000-0000-0000-000000000000).

200Returned if the list of targets or tags was evaluated against the scan route configuration successfully.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred.