class OrganizationsSourcesFindings extends Resource (View source)

The "findings" collection of methods.

Typical usage is:

 $securitycenterService = new Google\Service\SecurityCommandCenter(...);
 $findings = $securitycenterService->organizations_sources_findings;

Methods

create(string $parent, Finding $postBody, array $optParams = [])

Creates a finding. The corresponding source must exist for finding creation to succeed. (findings.create)

group(string $parent, GroupFindingsRequest $postBody, array $optParams = [])

Filters an organization or source's findings and groups them by their specified properties. To group across all sources provide a - as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings, /v1/folders/{folder_id}/sources/-/findings, /v1/projects/{project_id}/sources/-/findings (findings.group)

listOrganizationsSourcesFindings(string $parent, array $optParams = [])

Lists an organization or source's findings. To list across all sources provide a - as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings (findings.listOrganizationsSourcesFindings)

patch(string $name, Finding $postBody, array $optParams = [])

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed. (findings.patch)

setMute(string $name, SetMuteRequest $postBody, array $optParams = [])

Updates the mute state of a finding. (findings.setMute)

setState(string $name, SetFindingStateRequest $postBody, array $optParams = [])

Updates the state of a finding. (findings.setState)

updateSecurityMarks(string $name, SecurityMarks $postBody, array $optParams = [])

Updates security marks. (findings.updateSecurityMarks)

Details

Finding create(string $parent, Finding $postBody, array $optParams = [])

Creates a finding. The corresponding source must exist for finding creation to succeed. (findings.create)

Parameters

string $parent

Required. Resource name of the new finding's parent. Its format should be organizations/[organization_id]/sources/[source_id].

Finding $postBody
array $optParams

Optional parameters.

Return Value

Finding

Exceptions

Exception

GroupFindingsResponse group(string $parent, GroupFindingsRequest $postBody, array $optParams = [])

Filters an organization or source's findings and groups them by their specified properties. To group across all sources provide a - as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings, /v1/folders/{folder_id}/sources/-/findings, /v1/projects/{project_id}/sources/-/findings (findings.group)

Parameters

string $parent

Required. Name of the source to groupBy. Its format is organizations/[organization_id]/sources/[source_id], folders/[folder_id]/sources/[source_id], or projects/[project_id]/sources/[source_id]. To groupBy across all sources provide a source_id of -. For example: organizations/{organization_id}/sources/-, folders/{folder_id}/sources/-, or projects/{project_id}/sources/-

GroupFindingsRequest $postBody
array $optParams

Optional parameters.

Return Value

GroupFindingsResponse

Exceptions

Exception

ListFindingsResponse listOrganizationsSourcesFindings(string $parent, array $optParams = [])

Lists an organization or source's findings. To list across all sources provide a - as the source id. Example: /v1/organizations/{organization_id}/sources/-/findings (findings.listOrganizationsSourcesFindings)

Parameters

string $parent

Required. Name of the source the findings belong to. Its format is organizations/[organization_id]/sources/[source_id], folders/[folder_id]/sources/[source_id], or projects/[project_id]/sources/[source_id]. To list across all sources provide a source_id of -. For example: organizations/{organization_id}/sources/-, folders/{folder_id}/sources/- or projects/{projects_id}/sources/-

array $optParams

Optional parameters.

Return Value

ListFindingsResponse

Exceptions

Exception

Finding patch(string $name, Finding $postBody, array $optParams = [])

Creates or updates a finding. The corresponding source must exist for a finding creation to succeed. (findings.patch)

Parameters

string $name

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

Finding $postBody
array $optParams

Optional parameters.

Return Value

Finding

Exceptions

Exception

Finding setMute(string $name, SetMuteRequest $postBody, array $optParams = [])

Updates the mute state of a finding. (findings.setMute)

Parameters

string $name

Required. The relative resource name of the finding. Example: organizations/{organization_id}/sources/{source_id}/findings/{finding_id}, folders/{folder_id}/sources/{source_id}/findings/{finding_id}, projects/{project_id}/sources/{source_id}/findings/{finding_id}.

SetMuteRequest $postBody
array $optParams

Optional parameters.

Return Value

Finding

Exceptions

Exception

Finding setState(string $name, SetFindingStateRequest $postBody, array $optParams = [])

Updates the state of a finding. (findings.setState)

Parameters

string $name

Required. The relative resource name of the finding. Example: organizations/{organization_id}/sources/{source_id}/findings/{finding_id}, folders/{folder_id}/sources/{source_id}/findings/{finding_id}, projects/{project_id}/sources/{source_id}/findings/{finding_id}.

SetFindingStateRequest $postBody
array $optParams

Optional parameters.

Return Value

Finding

Exceptions

Exception

SecurityMarks updateSecurityMarks(string $name, SecurityMarks $postBody, array $optParams = [])

Updates security marks. (findings.updateSecurityMarks)

Parameters

string $name

The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" " organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/sec urityMarks".

SecurityMarks $postBody
array $optParams

Optional parameters.

Return Value

SecurityMarks

Exceptions

Exception