Method: organizations.sources.findings.setState

Updates the state of a finding.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The relative resource name of the finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/finding/{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.