Class: Google::Cloud::SecurityCenter::V2::ListFindingsRequest

Inherits:

Object

Object
Google::Cloud::SecurityCenter::V2::ListFindingsRequest

show all

Extended by:: Protobuf::MessageExts::ClassMethods

Includes:: Protobuf::MessageExts

Defined in:: proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb

Overview

Request message for listing findings.

Instance Attribute Summary collapse

#field_mask ⇒ ::Google::Protobuf::FieldMask
A field mask to specify the Finding fields to be listed in the response.
#filter ⇒ ::String
Expression that defines the filter to apply across findings.
#order_by ⇒ ::String
Expression that defines what fields and order to use for sorting.
#page_size ⇒ ::Integer
The maximum number of results to return in a single response.
#page_token ⇒ ::String
The value returned by the last ListFindingsResponse; indicates that this is a continuation of a prior ListFindings call, and that the system should return the next page of data.
#parent ⇒ ::String
Required.

Instance Attribute Details

#field_mask ⇒ `::Google::Protobuf::FieldMask`

Returns A field mask to specify the Finding fields to be listed in the response. An empty field mask will list all fields.

Returns:

(::Google::Protobuf::FieldMask) —
A field mask to specify the Finding fields to be listed in the response. An empty field mask will list all fields.

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

#filter ⇒ `::String`

Returns 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 true and false without 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: =, :
- resource.folders.resource_folder: =, :
- resource.display_name: =, :.

Returns:

(::String) —
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 true and false without 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: =, :
  - resource.folders.resource_folder: =, :
  - resource.display_name: =, :

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

#order_by ⇒ `::String`

Returns Expression that defines what fields and order to use for sorting. The string value should follow SQL syntax: comma separated list of fields. For example: "name,parent". The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be appended to the field name. For example: "name desc,parent". Redundant space characters in the syntax are insignificant. "name desc,parent" and " name desc , parent " are equivalent.

The following fields are supported: name parent state category resource_name event_time security_marks.marks.

Returns:

(::String) —
Expression that defines what fields and order to use for sorting. The string value should follow SQL syntax: comma separated list of fields. For example: "name,parent". The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be appended to the field name. For example: "name desc,parent". Redundant space characters in the syntax are insignificant. "name desc,parent" and " name desc , parent " are equivalent.

The following fields are supported: name parent state category resource_name event_time security_marks.marks

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

#page_size ⇒ `::Integer`

Returns The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

Returns:

(::Integer) —
The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

#page_token ⇒ `::String`

Returns The value returned by the last ListFindingsResponse; indicates that this is a continuation of a prior ListFindings call, and that the system should return the next page of data.

Returns:

(::String) —
The value returned by the last ListFindingsResponse; indicates that this is a continuation of a prior ListFindings call, and that the system should return the next page of data.

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

#parent ⇒ `::String`

Returns Required. Name of the source the findings belong to. If no location is specified, the default is 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 list 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/{projects_id}/sources/-
projects/{projects_id}/sources/-/locations/{location_id}.

Returns:

(::String) —
Required. Name of the source the findings belong to. If no location is specified, the default is 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 list 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/{projects_id}/sources/-
- projects/{projects_id}/sources/-/locations/{location_id}

# File 'proto_docs/google/cloud/securitycenter/v2/securitycenter_service.rb', line 707

class ListFindingsRequest
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods
end

Class: Google::Cloud::SecurityCenter::V2::ListFindingsRequest

Overview

Instance Attribute Summary collapse

Instance Attribute Details

#field_mask ⇒ ::Google::Protobuf::FieldMask

#filter ⇒ ::String

#order_by ⇒ ::String

#page_size ⇒ ::Integer

#page_token ⇒ ::String

#parent ⇒ ::String

#field_mask ⇒ `::Google::Protobuf::FieldMask`

#filter ⇒ `::String`

#order_by ⇒ `::String`

#page_size ⇒ `::Integer`

#page_token ⇒ `::String`

#parent ⇒ `::String`