Reference documentation and code samples for the Google Cloud Security Command Center V2 Client class GroupFindingsRequest.
Request message for grouping by findings.
Generated from protobuf message google.cloud.securitycenter.v2.GroupFindingsRequest
Namespace
Google \ Cloud \ SecurityCenter \ V2Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ parent |
string
Required. Name of the source to groupBy. If no location is specified, finding is assumed to be in global. The following list shows some examples: + |
↳ filter |
string
Expression that defines the filter to apply across findings. The expression is a list of one or more restrictions combined via logical operators |
↳ group_by |
string
Required. Expression that defines what assets fields to use for grouping. The string value should follow SQL syntax: comma separated list of fields. For example: "parent,resource_name". |
↳ page_token |
string
The value returned by the last |
↳ page_size |
int
The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000. |
getParent
Required. Name of the source to groupBy. If no location is specified, finding is assumed to be in global.
The following list shows some examples:
organizations/[organization_id]/sources/[source_id]+organizations/[organization_id]/sources/[source_id]/locations/[location_id]folders/[folder_id]/sources/[source_id]folders/[folder_id]/sources/[source_id]/locations/[location_id]projects/[project_id]/sources/[source_id]projects/[project_id]/sources/[source_id]/locations/[location_id]To groupBy across all sources provide a source_id of-. The following list shows some examples:organizations/{organization_id}/sources/-organizations/{organization_id}/sources/-/locations/[location_id]folders/{folder_id}/sources/-folders/{folder_id}/sources/-/locations/[location_id]projects/{project_id}/sources/-projects/{project_id}/sources/-/locations/[location_id]
| Returns | |
|---|---|
| Type | Description |
string |
|
setParent
Required. Name of the source to groupBy. If no location is specified, finding is assumed to be in global.
The following list shows some examples:
organizations/[organization_id]/sources/[source_id]+organizations/[organization_id]/sources/[source_id]/locations/[location_id]folders/[folder_id]/sources/[source_id]folders/[folder_id]/sources/[source_id]/locations/[location_id]projects/[project_id]/sources/[source_id]projects/[project_id]/sources/[source_id]/locations/[location_id]To groupBy across all sources provide a source_id of-. The following list shows some examples:organizations/{organization_id}/sources/-organizations/{organization_id}/sources/-/locations/[location_id]folders/{folder_id}/sources/-folders/{folder_id}/sources/-/locations/[location_id]projects/{project_id}/sources/-projects/{project_id}/sources/-/locations/[location_id]
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getFilter
Expression that defines the filter to apply across findings.
The expression is a list of one or more restrictions combined via logical
operators AND and OR.
Parentheses are supported, and OR has higher precedence than AND.
Restrictions have the form <field> <operator> <value> and may have a -
character in front of them to indicate negation. Examples include:
- name
- security_marks.marks.marka
The supported operators are:
=for all value types.>,<,>=,<=for integer values.:, meaning substring matching, for strings. The supported value types are:- string literals in quotes.
- integer literals without quotes.
- boolean literals
trueandfalsewithout quotes. The following field and operator combinations are supported: - name:
= - parent:
=,: - resource_name:
=,: - state:
=,: - category:
=,: - external_uri:
=,: - event_time:
=,>,<,>=,<=Usage: This should be milliseconds since epoch or an RFC3339 string. Examples:event_time = "2019-06-10T16:07:18-07:00"event_time = 1560208038000 - severity:
=,: - security_marks.marks:
=,: - resource:
- resource.name:
=,: - resource.parent_name:
=,: - resource.parent_display_name:
=,: - resource.project_name:
=,: - resource.project_display_name:
=,: - resource.type:
=,:
| Returns | |
|---|---|
| Type | Description |
string |
|
setFilter
Expression that defines the filter to apply across findings.
The expression is a list of one or more restrictions combined via logical
operators AND and OR.
Parentheses are supported, and OR has higher precedence than AND.
Restrictions have the form <field> <operator> <value> and may have a -
character in front of them to indicate negation. Examples include:
- name
- security_marks.marks.marka
The supported operators are:
=for all value types.>,<,>=,<=for integer values.:, meaning substring matching, for strings. The supported value types are:- string literals in quotes.
- integer literals without quotes.
- boolean literals
trueandfalsewithout quotes. The following field and operator combinations are supported: - name:
= - parent:
=,: - resource_name:
=,: - state:
=,: - category:
=,: - external_uri:
=,: - event_time:
=,>,<,>=,<=Usage: This should be milliseconds since epoch or an RFC3339 string. Examples:event_time = "2019-06-10T16:07:18-07:00"event_time = 1560208038000 - severity:
=,: - security_marks.marks:
=,: - resource:
- resource.name:
=,: - resource.parent_name:
=,: - resource.parent_display_name:
=,: - resource.project_name:
=,: - resource.project_display_name:
=,: - resource.type:
=,:
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getGroupBy
Required. Expression that defines what assets fields to use for grouping.
The string value should follow SQL syntax: comma separated list of fields. For example: "parent,resource_name".
| Returns | |
|---|---|
| Type | Description |
string |
|
setGroupBy
Required. Expression that defines what assets fields to use for grouping.
The string value should follow SQL syntax: comma separated list of fields. For example: "parent,resource_name".
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getPageToken
The value returned by the last GroupFindingsResponse; indicates
that this is a continuation of a prior GroupFindings call, and
that the system should return the next page of data.
| Returns | |
|---|---|
| Type | Description |
string |
|
setPageToken
The value returned by the last GroupFindingsResponse; indicates
that this is a continuation of a prior GroupFindings call, and
that the system should return the next page of data.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getPageSize
The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
| Returns | |
|---|---|
| Type | Description |
int |
|
setPageSize
The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
static::build
| Parameters | |
|---|---|
| Name | Description |
parent |
string
Required. Name of the source to groupBy. If no location is specified, finding is assumed to be in global. The following list shows some examples:
To groupBy across all sources provide a source_id of
|
groupBy |
string
Required. Expression that defines what assets fields to use for grouping. The string value should follow SQL syntax: comma separated list of fields. For example: "parent,resource_name". |
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\SecurityCenter\V2\GroupFindingsRequest |
|