Method: organizations.sources.findings.setState

Updates the state of a finding.

HTTP request

POST https://securitycenter.googleapis.com/v1beta1/{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, accurate to nanoseconds. Example: "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.

IAM Permissions

Requires the following Cloud IAM permission on the name resource:

  • securitycenter.findings.setState

For more information, see the Cloud IAM Documentation.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Security Command Center
Need help? Visit our support page.