v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13186168.0 KB
projects

SearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for alerts" using functions such as has_alert in the query string. The parent field in SearchFindingsRequest should have the format: projects/{project} Example to search for findings for a specific issue: has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")

get/v1beta/{+parent}/findings:search

Path parameters

parentstring required

Required. Parent of the findings. Format: vaults/{vault}

Query parameters

orderBystring

Optional. Order by criteria in the csv format: "field1,field2 desc" or "field1,field2" or "field1 asc, field2".

pageSizeinteger

Optional. Page size.

pageTokenstring

Optional. Page token.

querystring

Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship query has_alert. Example: - has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")

Response

Successful response