GET /qvm/saved_searches/{saved_search_id}/vuln_instances

Creates the Vulnerability Instances search. This search will return a maximum of 100,000 results.

Table 1. GET /qvm/saved_searches/{saved_search_id}/vuln_instances resource details
MIME Type
application/json

Table 2. GET /qvm/saved_searches/{saved_search_id}/vuln_instances request parameter details
Parameter	Type	Optionality	Data Type	MIME Type	Description
saved_search_id	path	Required	Number (Integer)	text/plain	ID of saved search
fields	query	Optional	String	text/plain	Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.
Range	header	Optional	String	text/plain	Optional - Use this parameter to restrict the number of elements that are returned in the list to a specified range. The list is indexed starting at zero.
filter	query	Optional	String	text/plain	Optional - This parameter is used to restrict the elements in a list base on the contents of various fields.

Table 3. GET /qvm/saved_searches/{saved_search_id}/vuln_instances response codes
HTTP Response Code	Unique Code	Description
201		The vulnerability instance search is queued.
404	1002	null
500	1020	null

Response Description

The responses returns a task ID.

Response Sample


{
    "id": 42,
    "retention_period_in_days": 42,
    "status": "String <one of: CANCELLED, CANCELING, CANCEL_REQUESTED, COMPLETED, CONFLICT, EXCEPTION, INITIALIZING, INTERRUPTED, PAUSED, PROCESSING, QUEUED, RESUMING>"
}