v1

latestOpenAPI 3.1.02026-07-26363186558.0 KB
threatintelligence

Get a finding by name.

get/v1beta/projects/{project}/findings/{finding}

Path parameters

projectstring required

Resource ID segment making up resource name. It identifies the resource within its parent collection as described in https://google.aip.dev/122.

findingstring required

Resource ID segment making up resource name. It identifies the resource within its parent collection as described in https://google.aip.dev/122.

Headers

x-goog-user-projectstring required

Your organization's project ID

Response

Successful operation

namestring

Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding}

providerstring required

Required. Logical source of this finding (name of the sub-engine).

displayNamestring required

Required. A short descriptive title for the finding <= 250 chars. EX: "Actor 'baddy' offering $1000 for credentials of 'goodguy'".

severitynumber float

Optional. Deprecated: Use the severity_analysis field instead. Base severity score from the finding source.

reoccurrenceTimesstring[]

Output only. When identical finding (same labels and same details) has re-occurred.

aiSummarystring

Optional. AI summary of the alert.

alertstring

Optional. Name of the alert that this finding is bound to.

configurationsstring[]

Optional. Configuration names that are bound to this finding.