Method: projects.sources.findings.setState

Updates the state of a finding.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. 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}".

Request body

The request body contains data with the following structure:

JSON representation
{
  "state": enum (State),
  "startTime": string
}
Fields
state

enum (State)

Required. The desired State of the finding.

startTime

string (Timestamp format)

Required. The time at which the updated state takes effect.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

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.