Search Report¶
-
TruStar.
search_reports
(search_term=None, enclave_ids=None, from_time=None, to_time=None, tags=None, excluded_tags=None)¶ Uses the search_reports_page method to create a generator that returns each successive report.
Parameters: - search_term (str) – The term to search for. If empty, no search term will be applied. Otherwise, must be at least 3 characters.
- enclave_ids (list(str)) – list of enclave ids used to restrict reports to specific enclaves (optional - by default reports from all of user’s enclaves are returned)
- from_time (int) – start of time window in milliseconds since epoch (optional)
- to_time (int) – end of time window in milliseconds since epoch (optional)
- tags (list(str)) – Name (or list of names) of tag(s) to filter reports by. Only reports containing ALL of these tags will be returned. (optional)
- excluded_tags (list(str)) – Reports containing ANY of these tags will be excluded from the results.
Returns: The generator of Report objects. Note that the body attributes of these reports will be
None
.