Method: projects.sources.findings.patch

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.

HTTP request

PATCH https://securitycenter.googleapis.com/v1/{finding.name=projects/*/sources/*/findings/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
finding.name

string

The relative resource name of the finding. Example: "organizations/{organization_id}/sources/{source_id}/findings/{findingId}", "folders/{folder_id}/sources/{source_id}/findings/{findingId}", "projects/{projectId}/sources/{source_id}/findings/{findingId}".

Query parameters

Parameters
updateMask

string (FieldMask format)

The FieldMask to use when updating the finding resource. This field should not be specified when creating a finding.

When updating a finding, an empty mask is treated as updating all mutable fields and replacing sourceProperties. Individual sourceProperties can be added/updated by using "sourceProperties." in the field mask.

Request body

The request body contains an instance of Finding.

Response body

If successful, the response body contains an instance of Finding.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.