Method: projects.findings.search

findings.search is a more powerful version of findings.list that supports complex queries like "findings for issues" using functions such as has_issue and has_asset in the query string. Example to search for findings for a specific issue: has_issue("name=\"projects/project-12345/issues/issue-12345\""))

HTTP request


GET https://threatintelligence.googleapis.com/v1beta/{parent=projects/*}/findings:search

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Parent of the findings. Format: projects/{project}

Query parameters

Parameters
query

string

Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship queries has_issue and has_asset. Examples: - has_issue("name="projects/project-12345/issues/issue-12345"") - has_asset("name="projects/project-12345/assets/asset-12345"")
orderBy

string

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

string

Optional. Page token.
pageSize

integer

Optional. Page size.

Request body

The request body must be empty.

Response body

Response message for findings.search.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "findings": [
    {
      object (Finding)
    }
  ],
  "nextPageToken": string
}
Fields
findings[]

object (Finding)

List of findings.
nextPageToken

string

Page token.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.