finding_statistics_v2s

Creates, updates, deletes, gets or lists a finding_statistics_v2s resource.

Overview

Name	finding_statistics_v2s
Type	Resource
Id	aws.securityhub.finding_statistics_v2s

Fields

The following fields are returned by SELECT queries:

get_finding_statistics_v2

Name	Datatype	Description
group_by_results	array	Aggregated statistics about security findings based on specified grouping criteria.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_finding_statistics_v2	select	region		Returns aggregated statistical data about findings. You can use the Scopes parameter to define the data boundary for the query. Currently, Scopes supports AwsOrganizations, which lets you aggregate findings from your entire organization or from specific organizational units. Only the delegated administrator account can use Scopes. GetFindingStatisticsV2 uses securityhub:GetAdhocInsightResults in the Action element of an IAM policy statement. You must have permission to perform the securityhub:GetAdhocInsightResults action.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_finding_statistics_v2

Returns aggregated statistical data about findings. You can use the Scopes parameter to define the data boundary for the query. Currently, Scopes supports AwsOrganizations, which lets you aggregate findings from your entire organization or from specific organizational units. Only the delegated administrator account can use Scopes. GetFindingStatisticsV2 uses securityhub:GetAdhocInsightResults in the Action element of an IAM policy statement. You must have permission to perform the securityhub:GetAdhocInsightResults action.

SELECT
group_by_results
FROM aws.securityhub.finding_statistics_v2s
WHERE region = '{{ region }}' -- required
;