google-cloud-security_center-v1 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +6 -6
- data/README.md +1 -1
- data/lib/google/cloud/security_center/v1.rb +1 -1
- data/lib/google/cloud/security_center/v1/security_center.rb +1 -1
- data/lib/google/cloud/security_center/v1/security_center/client.rb +503 -474
- data/lib/google/cloud/security_center/v1/security_center/credentials.rb +1 -1
- data/lib/google/cloud/security_center/v1/security_center/operations.rb +109 -103
- data/lib/google/cloud/security_center/v1/security_center/paths.rb +16 -16
- data/lib/google/cloud/security_center/v1/version.rb +1 -1
- data/lib/google/cloud/securitycenter/v1/notification_message_pb.rb +2 -0
- data/lib/google/cloud/securitycenter/v1/resource_pb.rb +27 -0
- data/proto_docs/google/api/resource.rb +12 -12
- data/proto_docs/google/cloud/securitycenter/v1/asset.rb +52 -49
- data/proto_docs/google/cloud/securitycenter/v1/finding.rb +28 -28
- data/proto_docs/google/cloud/securitycenter/v1/notification_config.rb +10 -10
- data/proto_docs/google/cloud/securitycenter/v1/notification_message.rb +7 -4
- data/proto_docs/google/cloud/securitycenter/v1/organization_settings.rb +11 -11
- data/proto_docs/google/cloud/securitycenter/v1/resource.rb +48 -0
- data/proto_docs/google/cloud/securitycenter/v1/run_asset_discovery_response.rb +4 -4
- data/proto_docs/google/cloud/securitycenter/v1/security_marks.rb +11 -11
- data/proto_docs/google/cloud/securitycenter/v1/securitycenter_service.rb +196 -172
- data/proto_docs/google/cloud/securitycenter/v1/source.rb +6 -6
- data/proto_docs/google/iam/v1/iam_policy.rb +15 -15
- data/proto_docs/google/iam/v1/options.rb +3 -3
- data/proto_docs/google/iam/v1/policy.rb +26 -26
- data/proto_docs/google/longrunning/operations.rb +30 -30
- data/proto_docs/google/protobuf/any.rb +4 -4
- data/proto_docs/google/protobuf/duration.rb +4 -4
- data/proto_docs/google/protobuf/empty.rb +2 -2
- data/proto_docs/google/protobuf/field_mask.rb +3 -3
- data/proto_docs/google/protobuf/struct.rb +18 -18
- data/proto_docs/google/protobuf/timestamp.rb +4 -4
- data/proto_docs/google/rpc/status.rb +6 -6
- data/proto_docs/google/type/expr.rb +6 -6
- metadata +35 -6
- data/lib/google/cloud/common_resources_pb.rb +0 -15
@@ -26,33 +26,33 @@ module Google
|
|
26
26
|
# A notification config is a Cloud SCC resource that contains the configuration
|
27
27
|
# to send notifications for create/update events of findings, assets and etc.
|
28
28
|
# @!attribute [rw] name
|
29
|
-
# @return [String]
|
29
|
+
# @return [::String]
|
30
30
|
# The relative resource name of this notification config. See:
|
31
31
|
# https://cloud.google.com/apis/design/resource_names#relative_resource_name
|
32
32
|
# Example:
|
33
33
|
# "organizations/\\{organization_id}/notificationConfigs/notify_public_bucket".
|
34
34
|
# @!attribute [rw] description
|
35
|
-
# @return [String]
|
35
|
+
# @return [::String]
|
36
36
|
# The description of the notification config (max of 1024 characters).
|
37
37
|
# @!attribute [rw] pubsub_topic
|
38
|
-
# @return [String]
|
38
|
+
# @return [::String]
|
39
39
|
# The PubSub topic to send notifications to. Its format is
|
40
40
|
# "projects/[project_id]/topics/[topic]".
|
41
41
|
# @!attribute [r] service_account
|
42
|
-
# @return [String]
|
42
|
+
# @return [::String]
|
43
43
|
# Output only. The service account that needs "pubsub.topics.publish"
|
44
44
|
# permission to publish to the PubSub topic.
|
45
45
|
# @!attribute [rw] streaming_config
|
46
|
-
# @return [Google::Cloud::SecurityCenter::V1::NotificationConfig::StreamingConfig]
|
46
|
+
# @return [::Google::Cloud::SecurityCenter::V1::NotificationConfig::StreamingConfig]
|
47
47
|
# The config for triggering streaming-based notifications.
|
48
48
|
class NotificationConfig
|
49
|
-
include Google::Protobuf::MessageExts
|
50
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
49
|
+
include ::Google::Protobuf::MessageExts
|
50
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
51
51
|
|
52
52
|
# The config for streaming-based notifications, which send each event as soon
|
53
53
|
# as it is detected.
|
54
54
|
# @!attribute [rw] filter
|
55
|
-
# @return [String]
|
55
|
+
# @return [::String]
|
56
56
|
# Expression that defines the filter to apply across create/update events
|
57
57
|
# of assets or findings as specified by the event type. The expression is a
|
58
58
|
# list of zero or more restrictions combined via logical operators `AND`
|
@@ -75,8 +75,8 @@ module Google
|
|
75
75
|
# * integer literals without quotes.
|
76
76
|
# * boolean literals `true` and `false` without quotes.
|
77
77
|
class StreamingConfig
|
78
|
-
include Google::Protobuf::MessageExts
|
79
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
78
|
+
include ::Google::Protobuf::MessageExts
|
79
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
80
80
|
end
|
81
81
|
end
|
82
82
|
end
|
@@ -23,15 +23,18 @@ module Google
|
|
23
23
|
module V1
|
24
24
|
# Cloud SCC's Notification
|
25
25
|
# @!attribute [rw] notification_config_name
|
26
|
-
# @return [String]
|
26
|
+
# @return [::String]
|
27
27
|
# Name of the notification config that generated current notification.
|
28
28
|
# @!attribute [rw] finding
|
29
|
-
# @return [Google::Cloud::SecurityCenter::V1::Finding]
|
29
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Finding]
|
30
30
|
# If it's a Finding based notification config, this field will be
|
31
31
|
# populated.
|
32
|
+
# @!attribute [rw] resource
|
33
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Resource]
|
34
|
+
# The Cloud resource tied to this notification's Finding.
|
32
35
|
class NotificationMessage
|
33
|
-
include Google::Protobuf::MessageExts
|
34
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
36
|
+
include ::Google::Protobuf::MessageExts
|
37
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
35
38
|
end
|
36
39
|
end
|
37
40
|
end
|
@@ -21,37 +21,37 @@ module Google
|
|
21
21
|
module Cloud
|
22
22
|
module SecurityCenter
|
23
23
|
module V1
|
24
|
-
# User specified settings that are attached to the
|
25
|
-
# Center
|
24
|
+
# User specified settings that are attached to the Security Command
|
25
|
+
# Center organization.
|
26
26
|
# @!attribute [rw] name
|
27
|
-
# @return [String]
|
27
|
+
# @return [::String]
|
28
28
|
# The relative resource name of the settings. See:
|
29
29
|
# https://cloud.google.com/apis/design/resource_names#relative_resource_name
|
30
30
|
# Example:
|
31
31
|
# "organizations/\\{organization_id}/organizationSettings".
|
32
32
|
# @!attribute [rw] enable_asset_discovery
|
33
|
-
# @return [Boolean]
|
33
|
+
# @return [::Boolean]
|
34
34
|
# A flag that indicates if Asset Discovery should be enabled. If the flag is
|
35
35
|
# set to `true`, then discovery of assets will occur. If it is set to `false,
|
36
36
|
# all historical assets will remain, but discovery of future assets will not
|
37
37
|
# occur.
|
38
38
|
# @!attribute [rw] asset_discovery_config
|
39
|
-
# @return [Google::Cloud::SecurityCenter::V1::OrganizationSettings::AssetDiscoveryConfig]
|
39
|
+
# @return [::Google::Cloud::SecurityCenter::V1::OrganizationSettings::AssetDiscoveryConfig]
|
40
40
|
# The configuration used for Asset Discovery runs.
|
41
41
|
class OrganizationSettings
|
42
|
-
include Google::Protobuf::MessageExts
|
43
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
42
|
+
include ::Google::Protobuf::MessageExts
|
43
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
44
44
|
|
45
45
|
# The configuration used for Asset Discovery runs.
|
46
46
|
# @!attribute [rw] project_ids
|
47
|
-
# @return [Array
|
47
|
+
# @return [::Array<::String>]
|
48
48
|
# The project ids to use for filtering asset discovery.
|
49
49
|
# @!attribute [rw] inclusion_mode
|
50
|
-
# @return [Google::Cloud::SecurityCenter::V1::OrganizationSettings::AssetDiscoveryConfig::InclusionMode]
|
50
|
+
# @return [::Google::Cloud::SecurityCenter::V1::OrganizationSettings::AssetDiscoveryConfig::InclusionMode]
|
51
51
|
# The mode to use for filtering asset discovery.
|
52
52
|
class AssetDiscoveryConfig
|
53
|
-
include Google::Protobuf::MessageExts
|
54
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
53
|
+
include ::Google::Protobuf::MessageExts
|
54
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
55
55
|
|
56
56
|
# The mode of inclusion when running Asset Discovery.
|
57
57
|
# Asset discovery can be limited by explicitly identifying projects to be
|
@@ -0,0 +1,48 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2020 Google LLC
|
4
|
+
#
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
# you may not use this file except in compliance with the License.
|
7
|
+
# You may obtain a copy of the License at
|
8
|
+
#
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
#
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
# See the License for the specific language governing permissions and
|
15
|
+
# limitations under the License.
|
16
|
+
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
|
+
|
19
|
+
|
20
|
+
module Google
|
21
|
+
module Cloud
|
22
|
+
module SecurityCenter
|
23
|
+
module V1
|
24
|
+
# Information related to the Google Cloud resource.
|
25
|
+
# @!attribute [rw] name
|
26
|
+
# @return [::String]
|
27
|
+
# The full resource name of the resource. See:
|
28
|
+
# https://cloud.google.com/apis/design/resource_names#full_resource_name
|
29
|
+
# @!attribute [rw] project
|
30
|
+
# @return [::String]
|
31
|
+
# The full resource name of project that the resource belongs to.
|
32
|
+
# @!attribute [rw] project_display_name
|
33
|
+
# @return [::String]
|
34
|
+
# The human readable name of project that the resource belongs to.
|
35
|
+
# @!attribute [rw] parent
|
36
|
+
# @return [::String]
|
37
|
+
# The full resource name of resource's parent.
|
38
|
+
# @!attribute [rw] parent_display_name
|
39
|
+
# @return [::String]
|
40
|
+
# The human readable name of resource's parent.
|
41
|
+
class Resource
|
42
|
+
include ::Google::Protobuf::MessageExts
|
43
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
@@ -23,14 +23,14 @@ module Google
|
|
23
23
|
module V1
|
24
24
|
# Response of asset discovery run
|
25
25
|
# @!attribute [rw] state
|
26
|
-
# @return [Google::Cloud::SecurityCenter::V1::RunAssetDiscoveryResponse::State]
|
26
|
+
# @return [::Google::Cloud::SecurityCenter::V1::RunAssetDiscoveryResponse::State]
|
27
27
|
# The state of an asset discovery run.
|
28
28
|
# @!attribute [rw] duration
|
29
|
-
# @return [Google::Protobuf::Duration]
|
29
|
+
# @return [::Google::Protobuf::Duration]
|
30
30
|
# The duration between asset discovery run start and end
|
31
31
|
class RunAssetDiscoveryResponse
|
32
|
-
include Google::Protobuf::MessageExts
|
33
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
32
|
+
include ::Google::Protobuf::MessageExts
|
33
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
34
34
|
|
35
35
|
# The state of an asset discovery run.
|
36
36
|
module State
|
@@ -21,19 +21,19 @@ module Google
|
|
21
21
|
module Cloud
|
22
22
|
module SecurityCenter
|
23
23
|
module V1
|
24
|
-
# User specified security marks that are attached to the parent
|
25
|
-
# Command Center
|
26
|
-
#
|
24
|
+
# User specified security marks that are attached to the parent Security
|
25
|
+
# Command Center resource. Security marks are scoped within a Security Command
|
26
|
+
# Center organization -- they can be modified and viewed by all users who have
|
27
27
|
# proper permissions on the organization.
|
28
28
|
# @!attribute [rw] name
|
29
|
-
# @return [String]
|
29
|
+
# @return [::String]
|
30
30
|
# The relative resource name of the SecurityMarks. See:
|
31
31
|
# https://cloud.google.com/apis/design/resource_names#relative_resource_name
|
32
32
|
# Examples:
|
33
33
|
# "organizations/\\{organization_id}/assets/\\{asset_id}/securityMarks"
|
34
34
|
# "organizations/\\{organization_id}/sources/\\{source_id}/findings/\\{finding_id}/securityMarks".
|
35
35
|
# @!attribute [rw] marks
|
36
|
-
# @return [Google::Protobuf::Map{String => String}]
|
36
|
+
# @return [::Google::Protobuf::Map{::String => ::String}]
|
37
37
|
# Mutable user specified security marks belonging to the parent resource.
|
38
38
|
# Constraints are as follows:
|
39
39
|
#
|
@@ -43,16 +43,16 @@ module Google
|
|
43
43
|
# * Values have leading and trailing whitespace trimmed, remaining
|
44
44
|
# characters must be between 1 - 4096 characters (inclusive)
|
45
45
|
class SecurityMarks
|
46
|
-
include Google::Protobuf::MessageExts
|
47
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
46
|
+
include ::Google::Protobuf::MessageExts
|
47
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
48
48
|
|
49
49
|
# @!attribute [rw] key
|
50
|
-
# @return [String]
|
50
|
+
# @return [::String]
|
51
51
|
# @!attribute [rw] value
|
52
|
-
# @return [String]
|
52
|
+
# @return [::String]
|
53
53
|
class MarksEntry
|
54
|
-
include Google::Protobuf::MessageExts
|
55
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
54
|
+
include ::Google::Protobuf::MessageExts
|
55
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
56
56
|
end
|
57
57
|
end
|
58
58
|
end
|
@@ -23,105 +23,105 @@ module Google
|
|
23
23
|
module V1
|
24
24
|
# Request message for creating a finding.
|
25
25
|
# @!attribute [rw] parent
|
26
|
-
# @return [String]
|
26
|
+
# @return [::String]
|
27
27
|
# Required. Resource name of the new finding's parent. Its format should be
|
28
28
|
# "organizations/[organization_id]/sources/[source_id]".
|
29
29
|
# @!attribute [rw] finding_id
|
30
|
-
# @return [String]
|
30
|
+
# @return [::String]
|
31
31
|
# Required. Unique identifier provided by the client within the parent scope.
|
32
32
|
# It must be alphanumeric and less than or equal to 32 characters and
|
33
33
|
# greater than 0 characters in length.
|
34
34
|
# @!attribute [rw] finding
|
35
|
-
# @return [Google::Cloud::SecurityCenter::V1::Finding]
|
35
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Finding]
|
36
36
|
# Required. The Finding being created. The name and security_marks will be
|
37
37
|
# ignored as they are both output only fields on this resource.
|
38
38
|
class CreateFindingRequest
|
39
|
-
include Google::Protobuf::MessageExts
|
40
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
39
|
+
include ::Google::Protobuf::MessageExts
|
40
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
41
41
|
end
|
42
42
|
|
43
43
|
# Request message for creating a notification config.
|
44
44
|
# @!attribute [rw] parent
|
45
|
-
# @return [String]
|
45
|
+
# @return [::String]
|
46
46
|
# Required. Resource name of the new notification config's parent. Its format
|
47
47
|
# is "organizations/[organization_id]".
|
48
48
|
# @!attribute [rw] config_id
|
49
|
-
# @return [String]
|
49
|
+
# @return [::String]
|
50
50
|
# Required.
|
51
51
|
# Unique identifier provided by the client within the parent scope.
|
52
52
|
# It must be between 1 and 128 characters, and contains alphanumeric
|
53
53
|
# characters, underscores or hyphens only.
|
54
54
|
# @!attribute [rw] notification_config
|
55
|
-
# @return [Google::Cloud::SecurityCenter::V1::NotificationConfig]
|
55
|
+
# @return [::Google::Cloud::SecurityCenter::V1::NotificationConfig]
|
56
56
|
# Required. The notification config being created. The name and the service
|
57
57
|
# account will be ignored as they are both output only fields on this
|
58
58
|
# resource.
|
59
59
|
class CreateNotificationConfigRequest
|
60
|
-
include Google::Protobuf::MessageExts
|
61
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
60
|
+
include ::Google::Protobuf::MessageExts
|
61
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
62
62
|
end
|
63
63
|
|
64
64
|
# Request message for creating a source.
|
65
65
|
# @!attribute [rw] parent
|
66
|
-
# @return [String]
|
66
|
+
# @return [::String]
|
67
67
|
# Required. Resource name of the new source's parent. Its format should be
|
68
68
|
# "organizations/[organization_id]".
|
69
69
|
# @!attribute [rw] source
|
70
|
-
# @return [Google::Cloud::SecurityCenter::V1::Source]
|
70
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Source]
|
71
71
|
# Required. The Source being created, only the display_name and description
|
72
72
|
# will be used. All other fields will be ignored.
|
73
73
|
class CreateSourceRequest
|
74
|
-
include Google::Protobuf::MessageExts
|
75
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
74
|
+
include ::Google::Protobuf::MessageExts
|
75
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
76
76
|
end
|
77
77
|
|
78
78
|
# Request message for deleting a notification config.
|
79
79
|
# @!attribute [rw] name
|
80
|
-
# @return [String]
|
80
|
+
# @return [::String]
|
81
81
|
# Required. Name of the notification config to delete. Its format is
|
82
82
|
# "organizations/[organization_id]/notificationConfigs/[config_id]".
|
83
83
|
class DeleteNotificationConfigRequest
|
84
|
-
include Google::Protobuf::MessageExts
|
85
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
84
|
+
include ::Google::Protobuf::MessageExts
|
85
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
86
86
|
end
|
87
87
|
|
88
88
|
# Request message for getting a notification config.
|
89
89
|
# @!attribute [rw] name
|
90
|
-
# @return [String]
|
90
|
+
# @return [::String]
|
91
91
|
# Required. Name of the notification config to get. Its format is
|
92
92
|
# "organizations/[organization_id]/notificationConfigs/[config_id]".
|
93
93
|
class GetNotificationConfigRequest
|
94
|
-
include Google::Protobuf::MessageExts
|
95
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
94
|
+
include ::Google::Protobuf::MessageExts
|
95
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
96
96
|
end
|
97
97
|
|
98
98
|
# Request message for getting organization settings.
|
99
99
|
# @!attribute [rw] name
|
100
|
-
# @return [String]
|
100
|
+
# @return [::String]
|
101
101
|
# Required. Name of the organization to get organization settings for. Its
|
102
102
|
# format is "organizations/[organization_id]/organizationSettings".
|
103
103
|
class GetOrganizationSettingsRequest
|
104
|
-
include Google::Protobuf::MessageExts
|
105
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
104
|
+
include ::Google::Protobuf::MessageExts
|
105
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
106
106
|
end
|
107
107
|
|
108
108
|
# Request message for getting a source.
|
109
109
|
# @!attribute [rw] name
|
110
|
-
# @return [String]
|
110
|
+
# @return [::String]
|
111
111
|
# Required. Relative resource name of the source. Its format is
|
112
112
|
# "organizations/[organization_id]/source/[source_id]".
|
113
113
|
class GetSourceRequest
|
114
|
-
include Google::Protobuf::MessageExts
|
115
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
114
|
+
include ::Google::Protobuf::MessageExts
|
115
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
116
116
|
end
|
117
117
|
|
118
118
|
# Request message for grouping by assets.
|
119
119
|
# @!attribute [rw] parent
|
120
|
-
# @return [String]
|
120
|
+
# @return [::String]
|
121
121
|
# Required. Name of the organization to groupBy. Its format is
|
122
122
|
# "organizations/[organization_id]".
|
123
123
|
# @!attribute [rw] filter
|
124
|
-
# @return [String]
|
124
|
+
# @return [::String]
|
125
125
|
# Expression that defines the filter to apply across assets.
|
126
126
|
# The expression is a list of zero or more restrictions combined via logical
|
127
127
|
# operators `AND` and `OR`.
|
@@ -155,15 +155,15 @@ module Google
|
|
155
155
|
#
|
156
156
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
157
157
|
# Examples:
|
158
|
-
#
|
159
|
-
#
|
158
|
+
# `update_time = "2019-06-10T16:07:18-07:00"`
|
159
|
+
# `update_time = 1560208038000`
|
160
160
|
#
|
161
161
|
# * create_time: `=`, `>`, `<`, `>=`, `<=`
|
162
162
|
#
|
163
163
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
164
164
|
# Examples:
|
165
|
-
#
|
166
|
-
#
|
165
|
+
# `create_time = "2019-06-10T16:07:18-07:00"`
|
166
|
+
# `create_time = 1560208038000`
|
167
167
|
#
|
168
168
|
# * iam_policy.policy_blob: `=`, `:`
|
169
169
|
# * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
|
@@ -178,8 +178,14 @@ module Google
|
|
178
178
|
# * security_center_properties.resource_owners: `=`, `:`
|
179
179
|
#
|
180
180
|
# For example, `resource_properties.size = 100` is a valid filter string.
|
181
|
+
#
|
182
|
+
# Use a partial match on the empty string to filter based on a property
|
183
|
+
# existing:`resource_properties.my_property : ""`
|
184
|
+
#
|
185
|
+
# Use a negated partial match on the empty string to filter based on a
|
186
|
+
# property not existing: `-resource_properties.my_property : ""`
|
181
187
|
# @!attribute [rw] group_by
|
182
|
-
# @return [String]
|
188
|
+
# @return [::String]
|
183
189
|
# Required. Expression that defines what assets fields to use for grouping.
|
184
190
|
# The string value should follow SQL syntax: comma separated list of fields.
|
185
191
|
# For example:
|
@@ -199,7 +205,7 @@ module Google
|
|
199
205
|
# * security_center_properties.resource_project_display_name
|
200
206
|
# * security_center_properties.resource_parent_display_name
|
201
207
|
# @!attribute [rw] compare_duration
|
202
|
-
# @return [Google::Protobuf::Duration]
|
208
|
+
# @return [::Google::Protobuf::Duration]
|
203
209
|
# When compare_duration is set, the GroupResult's "state_change" property is
|
204
210
|
# updated to indicate whether the asset was added, removed, or remained
|
205
211
|
# present during the compare_duration period of time that precedes the
|
@@ -228,55 +234,55 @@ module Google
|
|
228
234
|
# If this field is set then `state_change` must be a specified field in
|
229
235
|
# `group_by`.
|
230
236
|
# @!attribute [rw] read_time
|
231
|
-
# @return [Google::Protobuf::Timestamp]
|
237
|
+
# @return [::Google::Protobuf::Timestamp]
|
232
238
|
# Time used as a reference point when filtering assets. The filter is limited
|
233
239
|
# to assets existing at the supplied time and their values are those at that
|
234
240
|
# specific time. Absence of this field will default to the API's version of
|
235
241
|
# NOW.
|
236
242
|
# @!attribute [rw] page_token
|
237
|
-
# @return [String]
|
243
|
+
# @return [::String]
|
238
244
|
# The value returned by the last `GroupAssetsResponse`; indicates
|
239
245
|
# that this is a continuation of a prior `GroupAssets` call, and that the
|
240
246
|
# system should return the next page of data.
|
241
247
|
# @!attribute [rw] page_size
|
242
|
-
# @return [Integer]
|
248
|
+
# @return [::Integer]
|
243
249
|
# The maximum number of results to return in a single response. Default is
|
244
250
|
# 10, minimum is 1, maximum is 1000.
|
245
251
|
class GroupAssetsRequest
|
246
|
-
include Google::Protobuf::MessageExts
|
247
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
252
|
+
include ::Google::Protobuf::MessageExts
|
253
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
248
254
|
end
|
249
255
|
|
250
256
|
# Response message for grouping by assets.
|
251
257
|
# @!attribute [rw] group_by_results
|
252
|
-
# @return [Array
|
258
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::GroupResult>]
|
253
259
|
# Group results. There exists an element for each existing unique
|
254
260
|
# combination of property/values. The element contains a count for the number
|
255
261
|
# of times those specific property/values appear.
|
256
262
|
# @!attribute [rw] read_time
|
257
|
-
# @return [Google::Protobuf::Timestamp]
|
263
|
+
# @return [::Google::Protobuf::Timestamp]
|
258
264
|
# Time used for executing the groupBy request.
|
259
265
|
# @!attribute [rw] next_page_token
|
260
|
-
# @return [String]
|
266
|
+
# @return [::String]
|
261
267
|
# Token to retrieve the next page of results, or empty if there are no more
|
262
268
|
# results.
|
263
269
|
# @!attribute [rw] total_size
|
264
|
-
# @return [Integer]
|
270
|
+
# @return [::Integer]
|
265
271
|
# The total number of results matching the query.
|
266
272
|
class GroupAssetsResponse
|
267
|
-
include Google::Protobuf::MessageExts
|
268
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
273
|
+
include ::Google::Protobuf::MessageExts
|
274
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
269
275
|
end
|
270
276
|
|
271
277
|
# Request message for grouping by findings.
|
272
278
|
# @!attribute [rw] parent
|
273
|
-
# @return [String]
|
279
|
+
# @return [::String]
|
274
280
|
# Required. Name of the source to groupBy. Its format is
|
275
281
|
# "organizations/[organization_id]/sources/[source_id]". To groupBy across
|
276
282
|
# all sources provide a source_id of `-`. For example:
|
277
283
|
# organizations/\\{organization_id}/sources/-
|
278
284
|
# @!attribute [rw] filter
|
279
|
-
# @return [String]
|
285
|
+
# @return [::String]
|
280
286
|
# Expression that defines the filter to apply across findings.
|
281
287
|
# The expression is a list of one or more restrictions combined via logical
|
282
288
|
# operators `AND` and `OR`.
|
@@ -313,15 +319,21 @@ module Google
|
|
313
319
|
#
|
314
320
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
315
321
|
# Examples:
|
316
|
-
#
|
317
|
-
#
|
322
|
+
# `event_time = "2019-06-10T16:07:18-07:00"`
|
323
|
+
# `event_time = 1560208038000`
|
318
324
|
#
|
319
325
|
# * security_marks.marks: `=`, `:`
|
320
326
|
# * source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
|
321
327
|
#
|
322
328
|
# For example, `source_properties.size = 100` is a valid filter string.
|
329
|
+
#
|
330
|
+
# Use a partial match on the empty string to filter based on a property
|
331
|
+
# existing: `source_properties.my_property : ""`
|
332
|
+
#
|
333
|
+
# Use a negated partial match on the empty string to filter based on a
|
334
|
+
# property not existing: `-source_properties.my_property : ""`
|
323
335
|
# @!attribute [rw] group_by
|
324
|
-
# @return [String]
|
336
|
+
# @return [::String]
|
325
337
|
# Required. Expression that defines what assets fields to use for grouping
|
326
338
|
# (including `state_change`). The string value should follow SQL syntax:
|
327
339
|
# comma separated list of fields. For example: "parent,resource_name".
|
@@ -337,13 +349,13 @@ module Google
|
|
337
349
|
#
|
338
350
|
# * state_change
|
339
351
|
# @!attribute [rw] read_time
|
340
|
-
# @return [Google::Protobuf::Timestamp]
|
352
|
+
# @return [::Google::Protobuf::Timestamp]
|
341
353
|
# Time used as a reference point when filtering findings. The filter is
|
342
354
|
# limited to findings existing at the supplied time and their values are
|
343
355
|
# those at that specific time. Absence of this field will default to the
|
344
356
|
# API's version of NOW.
|
345
357
|
# @!attribute [rw] compare_duration
|
346
|
-
# @return [Google::Protobuf::Duration]
|
358
|
+
# @return [::Google::Protobuf::Duration]
|
347
359
|
# When compare_duration is set, the GroupResult's "state_change" attribute is
|
348
360
|
# updated to indicate whether the finding had its state changed, the
|
349
361
|
# finding's state remained unchanged, or if the finding was added during the
|
@@ -377,132 +389,132 @@ module Google
|
|
377
389
|
# If this field is set then `state_change` must be a specified field in
|
378
390
|
# `group_by`.
|
379
391
|
# @!attribute [rw] page_token
|
380
|
-
# @return [String]
|
392
|
+
# @return [::String]
|
381
393
|
# The value returned by the last `GroupFindingsResponse`; indicates
|
382
394
|
# that this is a continuation of a prior `GroupFindings` call, and
|
383
395
|
# that the system should return the next page of data.
|
384
396
|
# @!attribute [rw] page_size
|
385
|
-
# @return [Integer]
|
397
|
+
# @return [::Integer]
|
386
398
|
# The maximum number of results to return in a single response. Default is
|
387
399
|
# 10, minimum is 1, maximum is 1000.
|
388
400
|
class GroupFindingsRequest
|
389
|
-
include Google::Protobuf::MessageExts
|
390
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
401
|
+
include ::Google::Protobuf::MessageExts
|
402
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
391
403
|
end
|
392
404
|
|
393
405
|
# Response message for group by findings.
|
394
406
|
# @!attribute [rw] group_by_results
|
395
|
-
# @return [Array
|
407
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::GroupResult>]
|
396
408
|
# Group results. There exists an element for each existing unique
|
397
409
|
# combination of property/values. The element contains a count for the number
|
398
410
|
# of times those specific property/values appear.
|
399
411
|
# @!attribute [rw] read_time
|
400
|
-
# @return [Google::Protobuf::Timestamp]
|
412
|
+
# @return [::Google::Protobuf::Timestamp]
|
401
413
|
# Time used for executing the groupBy request.
|
402
414
|
# @!attribute [rw] next_page_token
|
403
|
-
# @return [String]
|
415
|
+
# @return [::String]
|
404
416
|
# Token to retrieve the next page of results, or empty if there are no more
|
405
417
|
# results.
|
406
418
|
# @!attribute [rw] total_size
|
407
|
-
# @return [Integer]
|
419
|
+
# @return [::Integer]
|
408
420
|
# The total number of results matching the query.
|
409
421
|
class GroupFindingsResponse
|
410
|
-
include Google::Protobuf::MessageExts
|
411
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
422
|
+
include ::Google::Protobuf::MessageExts
|
423
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
412
424
|
end
|
413
425
|
|
414
426
|
# Result containing the properties and count of a groupBy request.
|
415
427
|
# @!attribute [rw] properties
|
416
|
-
# @return [Google::Protobuf::Map{String => Google::Protobuf::Value}]
|
428
|
+
# @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
|
417
429
|
# Properties matching the groupBy fields in the request.
|
418
430
|
# @!attribute [rw] count
|
419
|
-
# @return [Integer]
|
431
|
+
# @return [::Integer]
|
420
432
|
# Total count of resources for the given properties.
|
421
433
|
class GroupResult
|
422
|
-
include Google::Protobuf::MessageExts
|
423
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
434
|
+
include ::Google::Protobuf::MessageExts
|
435
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
424
436
|
|
425
437
|
# @!attribute [rw] key
|
426
|
-
# @return [String]
|
438
|
+
# @return [::String]
|
427
439
|
# @!attribute [rw] value
|
428
|
-
# @return [Google::Protobuf::Value]
|
440
|
+
# @return [::Google::Protobuf::Value]
|
429
441
|
class PropertiesEntry
|
430
|
-
include Google::Protobuf::MessageExts
|
431
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
442
|
+
include ::Google::Protobuf::MessageExts
|
443
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
432
444
|
end
|
433
445
|
end
|
434
446
|
|
435
447
|
# Request message for listing notification configs.
|
436
448
|
# @!attribute [rw] parent
|
437
|
-
# @return [String]
|
449
|
+
# @return [::String]
|
438
450
|
# Required. Name of the organization to list notification configs.
|
439
451
|
# Its format is "organizations/[organization_id]".
|
440
452
|
# @!attribute [rw] page_token
|
441
|
-
# @return [String]
|
453
|
+
# @return [::String]
|
442
454
|
# The value returned by the last `ListNotificationConfigsResponse`; indicates
|
443
455
|
# that this is a continuation of a prior `ListNotificationConfigs` call, and
|
444
456
|
# that the system should return the next page of data.
|
445
457
|
# @!attribute [rw] page_size
|
446
|
-
# @return [Integer]
|
458
|
+
# @return [::Integer]
|
447
459
|
# The maximum number of results to return in a single response. Default is
|
448
460
|
# 10, minimum is 1, maximum is 1000.
|
449
461
|
class ListNotificationConfigsRequest
|
450
|
-
include Google::Protobuf::MessageExts
|
451
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
462
|
+
include ::Google::Protobuf::MessageExts
|
463
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
452
464
|
end
|
453
465
|
|
454
466
|
# Response message for listing notification configs.
|
455
467
|
# @!attribute [rw] notification_configs
|
456
|
-
# @return [Array
|
468
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::NotificationConfig>]
|
457
469
|
# Notification configs belonging to the requested parent.
|
458
470
|
# @!attribute [rw] next_page_token
|
459
|
-
# @return [String]
|
471
|
+
# @return [::String]
|
460
472
|
# Token to retrieve the next page of results, or empty if there are no more
|
461
473
|
# results.
|
462
474
|
class ListNotificationConfigsResponse
|
463
|
-
include Google::Protobuf::MessageExts
|
464
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
475
|
+
include ::Google::Protobuf::MessageExts
|
476
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
465
477
|
end
|
466
478
|
|
467
479
|
# Request message for listing sources.
|
468
480
|
# @!attribute [rw] parent
|
469
|
-
# @return [String]
|
481
|
+
# @return [::String]
|
470
482
|
# Required. Resource name of the parent of sources to list. Its format should
|
471
483
|
# be "organizations/[organization_id]".
|
472
484
|
# @!attribute [rw] page_token
|
473
|
-
# @return [String]
|
485
|
+
# @return [::String]
|
474
486
|
# The value returned by the last `ListSourcesResponse`; indicates
|
475
487
|
# that this is a continuation of a prior `ListSources` call, and
|
476
488
|
# that the system should return the next page of data.
|
477
489
|
# @!attribute [rw] page_size
|
478
|
-
# @return [Integer]
|
490
|
+
# @return [::Integer]
|
479
491
|
# The maximum number of results to return in a single response. Default is
|
480
492
|
# 10, minimum is 1, maximum is 1000.
|
481
493
|
class ListSourcesRequest
|
482
|
-
include Google::Protobuf::MessageExts
|
483
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
494
|
+
include ::Google::Protobuf::MessageExts
|
495
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
484
496
|
end
|
485
497
|
|
486
498
|
# Response message for listing sources.
|
487
499
|
# @!attribute [rw] sources
|
488
|
-
# @return [Array
|
500
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::Source>]
|
489
501
|
# Sources belonging to the requested parent.
|
490
502
|
# @!attribute [rw] next_page_token
|
491
|
-
# @return [String]
|
503
|
+
# @return [::String]
|
492
504
|
# Token to retrieve the next page of results, or empty if there are no more
|
493
505
|
# results.
|
494
506
|
class ListSourcesResponse
|
495
|
-
include Google::Protobuf::MessageExts
|
496
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
507
|
+
include ::Google::Protobuf::MessageExts
|
508
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
497
509
|
end
|
498
510
|
|
499
511
|
# Request message for listing assets.
|
500
512
|
# @!attribute [rw] parent
|
501
|
-
# @return [String]
|
513
|
+
# @return [::String]
|
502
514
|
# Required. Name of the organization assets should belong to. Its format is
|
503
515
|
# "organizations/[organization_id]".
|
504
516
|
# @!attribute [rw] filter
|
505
|
-
# @return [String]
|
517
|
+
# @return [::String]
|
506
518
|
# Expression that defines the filter to apply across assets.
|
507
519
|
# The expression is a list of zero or more restrictions combined via logical
|
508
520
|
# operators `AND` and `OR`.
|
@@ -536,15 +548,15 @@ module Google
|
|
536
548
|
#
|
537
549
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
538
550
|
# Examples:
|
539
|
-
#
|
540
|
-
#
|
551
|
+
# `update_time = "2019-06-10T16:07:18-07:00"`
|
552
|
+
# `update_time = 1560208038000`
|
541
553
|
#
|
542
554
|
# * create_time: `=`, `>`, `<`, `>=`, `<=`
|
543
555
|
#
|
544
556
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
545
557
|
# Examples:
|
546
|
-
#
|
547
|
-
#
|
558
|
+
# `create_time = "2019-06-10T16:07:18-07:00"`
|
559
|
+
# `create_time = 1560208038000`
|
548
560
|
#
|
549
561
|
# * iam_policy.policy_blob: `=`, `:`
|
550
562
|
# * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
|
@@ -559,8 +571,14 @@ module Google
|
|
559
571
|
# * security_center_properties.resource_owners: `=`, `:`
|
560
572
|
#
|
561
573
|
# For example, `resource_properties.size = 100` is a valid filter string.
|
574
|
+
#
|
575
|
+
# Use a partial match on the empty string to filter based on a property
|
576
|
+
# existing: `resource_properties.my_property : ""`
|
577
|
+
#
|
578
|
+
# Use a negated partial match on the empty string to filter based on a
|
579
|
+
# property not existing: `-resource_properties.my_property : ""`
|
562
580
|
# @!attribute [rw] order_by
|
563
|
-
# @return [String]
|
581
|
+
# @return [::String]
|
564
582
|
# Expression that defines what fields and order to use for sorting. The
|
565
583
|
# string value should follow SQL syntax: comma separated list of fields. For
|
566
584
|
# example: "name,resource_properties.a_property". The default sorting order
|
@@ -583,13 +601,13 @@ module Google
|
|
583
601
|
# security_center_properties.resource_project_display_name
|
584
602
|
# security_center_properties.resource_type
|
585
603
|
# @!attribute [rw] read_time
|
586
|
-
# @return [Google::Protobuf::Timestamp]
|
604
|
+
# @return [::Google::Protobuf::Timestamp]
|
587
605
|
# Time used as a reference point when filtering assets. The filter is limited
|
588
606
|
# to assets existing at the supplied time and their values are those at that
|
589
607
|
# specific time. Absence of this field will default to the API's version of
|
590
608
|
# NOW.
|
591
609
|
# @!attribute [rw] compare_duration
|
592
|
-
# @return [Google::Protobuf::Duration]
|
610
|
+
# @return [::Google::Protobuf::Duration]
|
593
611
|
# When compare_duration is set, the ListAssetsResult's "state_change"
|
594
612
|
# attribute is updated to indicate whether the asset was added, removed, or
|
595
613
|
# remained present during the compare_duration period of time that precedes
|
@@ -615,51 +633,51 @@ module Google
|
|
615
633
|
# is "UNUSED", which will be the state_change set for all assets present at
|
616
634
|
# read_time.
|
617
635
|
# @!attribute [rw] field_mask
|
618
|
-
# @return [Google::Protobuf::FieldMask]
|
636
|
+
# @return [::Google::Protobuf::FieldMask]
|
619
637
|
# Optional. A field mask to specify the ListAssetsResult fields to be listed
|
620
638
|
# in the response. An empty field mask will list all fields.
|
621
639
|
# @!attribute [rw] page_token
|
622
|
-
# @return [String]
|
640
|
+
# @return [::String]
|
623
641
|
# The value returned by the last `ListAssetsResponse`; indicates
|
624
642
|
# that this is a continuation of a prior `ListAssets` call, and
|
625
643
|
# that the system should return the next page of data.
|
626
644
|
# @!attribute [rw] page_size
|
627
|
-
# @return [Integer]
|
645
|
+
# @return [::Integer]
|
628
646
|
# The maximum number of results to return in a single response. Default is
|
629
647
|
# 10, minimum is 1, maximum is 1000.
|
630
648
|
class ListAssetsRequest
|
631
|
-
include Google::Protobuf::MessageExts
|
632
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
649
|
+
include ::Google::Protobuf::MessageExts
|
650
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
633
651
|
end
|
634
652
|
|
635
653
|
# Response message for listing assets.
|
636
654
|
# @!attribute [rw] list_assets_results
|
637
|
-
# @return [Array
|
655
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::ListAssetsResponse::ListAssetsResult>]
|
638
656
|
# Assets matching the list request.
|
639
657
|
# @!attribute [rw] read_time
|
640
|
-
# @return [Google::Protobuf::Timestamp]
|
658
|
+
# @return [::Google::Protobuf::Timestamp]
|
641
659
|
# Time used for executing the list request.
|
642
660
|
# @!attribute [rw] next_page_token
|
643
|
-
# @return [String]
|
661
|
+
# @return [::String]
|
644
662
|
# Token to retrieve the next page of results, or empty if there are no more
|
645
663
|
# results.
|
646
664
|
# @!attribute [rw] total_size
|
647
|
-
# @return [Integer]
|
665
|
+
# @return [::Integer]
|
648
666
|
# The total number of assets matching the query.
|
649
667
|
class ListAssetsResponse
|
650
|
-
include Google::Protobuf::MessageExts
|
651
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
668
|
+
include ::Google::Protobuf::MessageExts
|
669
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
652
670
|
|
653
671
|
# Result containing the Asset and its State.
|
654
672
|
# @!attribute [rw] asset
|
655
|
-
# @return [Google::Cloud::SecurityCenter::V1::Asset]
|
673
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Asset]
|
656
674
|
# Asset matching the search request.
|
657
675
|
# @!attribute [rw] state_change
|
658
|
-
# @return [Google::Cloud::SecurityCenter::V1::ListAssetsResponse::ListAssetsResult::StateChange]
|
676
|
+
# @return [::Google::Cloud::SecurityCenter::V1::ListAssetsResponse::ListAssetsResult::StateChange]
|
659
677
|
# State change of the asset between the points in time.
|
660
678
|
class ListAssetsResult
|
661
|
-
include Google::Protobuf::MessageExts
|
662
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
679
|
+
include ::Google::Protobuf::MessageExts
|
680
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
663
681
|
|
664
682
|
# The change in state of the asset.
|
665
683
|
#
|
@@ -685,13 +703,13 @@ module Google
|
|
685
703
|
|
686
704
|
# Request message for listing findings.
|
687
705
|
# @!attribute [rw] parent
|
688
|
-
# @return [String]
|
706
|
+
# @return [::String]
|
689
707
|
# Required. Name of the source the findings belong to. Its format is
|
690
708
|
# "organizations/[organization_id]/sources/[source_id]". To list across all
|
691
709
|
# sources provide a source_id of `-`. For example:
|
692
710
|
# organizations/\\{organization_id}/sources/-
|
693
711
|
# @!attribute [rw] filter
|
694
|
-
# @return [String]
|
712
|
+
# @return [::String]
|
695
713
|
# Expression that defines the filter to apply across findings.
|
696
714
|
# The expression is a list of one or more restrictions combined via logical
|
697
715
|
# operators `AND` and `OR`.
|
@@ -728,15 +746,21 @@ module Google
|
|
728
746
|
#
|
729
747
|
# Usage: This should be milliseconds since epoch or an RFC3339 string.
|
730
748
|
# Examples:
|
731
|
-
#
|
732
|
-
#
|
749
|
+
# `event_time = "2019-06-10T16:07:18-07:00"`
|
750
|
+
# `event_time = 1560208038000`
|
733
751
|
#
|
734
752
|
# security_marks.marks: `=`, `:`
|
735
753
|
# source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
|
736
754
|
#
|
737
755
|
# For example, `source_properties.size = 100` is a valid filter string.
|
756
|
+
#
|
757
|
+
# Use a partial match on the empty string to filter based on a property
|
758
|
+
# existing: `source_properties.my_property : ""`
|
759
|
+
#
|
760
|
+
# Use a negated partial match on the empty string to filter based on a
|
761
|
+
# property not existing: `-source_properties.my_property : ""`
|
738
762
|
# @!attribute [rw] order_by
|
739
|
-
# @return [String]
|
763
|
+
# @return [::String]
|
740
764
|
# Expression that defines what fields and order to use for sorting. The
|
741
765
|
# string value should follow SQL syntax: comma separated list of fields. For
|
742
766
|
# example: "name,resource_properties.a_property". The default sorting order
|
@@ -756,13 +780,13 @@ module Google
|
|
756
780
|
# source_properties
|
757
781
|
# security_marks.marks
|
758
782
|
# @!attribute [rw] read_time
|
759
|
-
# @return [Google::Protobuf::Timestamp]
|
783
|
+
# @return [::Google::Protobuf::Timestamp]
|
760
784
|
# Time used as a reference point when filtering findings. The filter is
|
761
785
|
# limited to findings existing at the supplied time and their values are
|
762
786
|
# those at that specific time. Absence of this field will default to the
|
763
787
|
# API's version of NOW.
|
764
788
|
# @!attribute [rw] compare_duration
|
765
|
-
# @return [Google::Protobuf::Duration]
|
789
|
+
# @return [::Google::Protobuf::Duration]
|
766
790
|
# When compare_duration is set, the ListFindingsResult's "state_change"
|
767
791
|
# attribute is updated to indicate whether the finding had its state changed,
|
768
792
|
# the finding's state remained unchanged, or if the finding was added in any
|
@@ -794,76 +818,76 @@ module Google
|
|
794
818
|
# is "UNUSED", which will be the state_change set for all findings present at
|
795
819
|
# read_time.
|
796
820
|
# @!attribute [rw] field_mask
|
797
|
-
# @return [Google::Protobuf::FieldMask]
|
821
|
+
# @return [::Google::Protobuf::FieldMask]
|
798
822
|
# Optional. A field mask to specify the Finding fields to be listed in the
|
799
823
|
# response. An empty field mask will list all fields.
|
800
824
|
# @!attribute [rw] page_token
|
801
|
-
# @return [String]
|
825
|
+
# @return [::String]
|
802
826
|
# The value returned by the last `ListFindingsResponse`; indicates
|
803
827
|
# that this is a continuation of a prior `ListFindings` call, and
|
804
828
|
# that the system should return the next page of data.
|
805
829
|
# @!attribute [rw] page_size
|
806
|
-
# @return [Integer]
|
830
|
+
# @return [::Integer]
|
807
831
|
# The maximum number of results to return in a single response. Default is
|
808
832
|
# 10, minimum is 1, maximum is 1000.
|
809
833
|
class ListFindingsRequest
|
810
|
-
include Google::Protobuf::MessageExts
|
811
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
834
|
+
include ::Google::Protobuf::MessageExts
|
835
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
812
836
|
end
|
813
837
|
|
814
838
|
# Response message for listing findings.
|
815
839
|
# @!attribute [rw] list_findings_results
|
816
|
-
# @return [Array
|
840
|
+
# @return [::Array<::Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult>]
|
817
841
|
# Findings matching the list request.
|
818
842
|
# @!attribute [rw] read_time
|
819
|
-
# @return [Google::Protobuf::Timestamp]
|
843
|
+
# @return [::Google::Protobuf::Timestamp]
|
820
844
|
# Time used for executing the list request.
|
821
845
|
# @!attribute [rw] next_page_token
|
822
|
-
# @return [String]
|
846
|
+
# @return [::String]
|
823
847
|
# Token to retrieve the next page of results, or empty if there are no more
|
824
848
|
# results.
|
825
849
|
# @!attribute [rw] total_size
|
826
|
-
# @return [Integer]
|
850
|
+
# @return [::Integer]
|
827
851
|
# The total number of findings matching the query.
|
828
852
|
class ListFindingsResponse
|
829
|
-
include Google::Protobuf::MessageExts
|
830
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
853
|
+
include ::Google::Protobuf::MessageExts
|
854
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
831
855
|
|
832
856
|
# Result containing the Finding and its StateChange.
|
833
857
|
# @!attribute [rw] finding
|
834
|
-
# @return [Google::Cloud::SecurityCenter::V1::Finding]
|
858
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Finding]
|
835
859
|
# Finding matching the search request.
|
836
860
|
# @!attribute [rw] state_change
|
837
|
-
# @return [Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult::StateChange]
|
861
|
+
# @return [::Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult::StateChange]
|
838
862
|
# State change of the finding between the points in time.
|
839
863
|
# @!attribute [rw] resource
|
840
|
-
# @return [Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult::Resource]
|
864
|
+
# @return [::Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult::Resource]
|
841
865
|
# Output only. Resource that is associated with this finding.
|
842
866
|
class ListFindingsResult
|
843
|
-
include Google::Protobuf::MessageExts
|
844
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
867
|
+
include ::Google::Protobuf::MessageExts
|
868
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
845
869
|
|
846
|
-
# Information related to the Google Cloud
|
870
|
+
# Information related to the Google Cloud resource that is
|
847
871
|
# associated with this finding.
|
848
872
|
# @!attribute [rw] name
|
849
|
-
# @return [String]
|
873
|
+
# @return [::String]
|
850
874
|
# The full resource name of the resource. See:
|
851
875
|
# https://cloud.google.com/apis/design/resource_names#full_resource_name
|
852
876
|
# @!attribute [rw] project_name
|
853
|
-
# @return [String]
|
877
|
+
# @return [::String]
|
854
878
|
# The full resource name of project that the resource belongs to.
|
855
879
|
# @!attribute [rw] project_display_name
|
856
|
-
# @return [String]
|
880
|
+
# @return [::String]
|
857
881
|
# The human readable name of project that the resource belongs to.
|
858
882
|
# @!attribute [rw] parent_name
|
859
|
-
# @return [String]
|
883
|
+
# @return [::String]
|
860
884
|
# The full resource name of resource's parent.
|
861
885
|
# @!attribute [rw] parent_display_name
|
862
|
-
# @return [String]
|
886
|
+
# @return [::String]
|
863
887
|
# The human readable name of resource's parent.
|
864
888
|
class Resource
|
865
|
-
include Google::Protobuf::MessageExts
|
866
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
889
|
+
include ::Google::Protobuf::MessageExts
|
890
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
867
891
|
end
|
868
892
|
|
869
893
|
# The change in state of the finding.
|
@@ -898,35 +922,35 @@ module Google
|
|
898
922
|
|
899
923
|
# Request message for updating a finding's state.
|
900
924
|
# @!attribute [rw] name
|
901
|
-
# @return [String]
|
925
|
+
# @return [::String]
|
902
926
|
# Required. The relative resource name of the finding. See:
|
903
927
|
# https://cloud.google.com/apis/design/resource_names#relative_resource_name
|
904
928
|
# Example:
|
905
929
|
# "organizations/\\{organization_id}/sources/\\{source_id}/finding/\\{finding_id}".
|
906
930
|
# @!attribute [rw] state
|
907
|
-
# @return [Google::Cloud::SecurityCenter::V1::Finding::State]
|
931
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Finding::State]
|
908
932
|
# Required. The desired State of the finding.
|
909
933
|
# @!attribute [rw] start_time
|
910
|
-
# @return [Google::Protobuf::Timestamp]
|
934
|
+
# @return [::Google::Protobuf::Timestamp]
|
911
935
|
# Required. The time at which the updated state takes effect.
|
912
936
|
class SetFindingStateRequest
|
913
|
-
include Google::Protobuf::MessageExts
|
914
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
937
|
+
include ::Google::Protobuf::MessageExts
|
938
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
915
939
|
end
|
916
940
|
|
917
941
|
# Request message for running asset discovery for an organization.
|
918
942
|
# @!attribute [rw] parent
|
919
|
-
# @return [String]
|
943
|
+
# @return [::String]
|
920
944
|
# Required. Name of the organization to run asset discovery for. Its format
|
921
945
|
# is "organizations/[organization_id]".
|
922
946
|
class RunAssetDiscoveryRequest
|
923
|
-
include Google::Protobuf::MessageExts
|
924
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
947
|
+
include ::Google::Protobuf::MessageExts
|
948
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
925
949
|
end
|
926
950
|
|
927
951
|
# Request message for updating or creating a finding.
|
928
952
|
# @!attribute [rw] finding
|
929
|
-
# @return [Google::Cloud::SecurityCenter::V1::Finding]
|
953
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Finding]
|
930
954
|
# Required. The finding resource to update or create if it does not already
|
931
955
|
# exist. parent, security_marks, and update_time will be ignored.
|
932
956
|
#
|
@@ -934,7 +958,7 @@ module Google
|
|
934
958
|
# alphanumeric and less than or equal to 32 characters and greater than 0
|
935
959
|
# characters in length.
|
936
960
|
# @!attribute [rw] update_mask
|
937
|
-
# @return [Google::Protobuf::FieldMask]
|
961
|
+
# @return [::Google::Protobuf::FieldMask]
|
938
962
|
# The FieldMask to use when updating the finding resource. This field should
|
939
963
|
# not be specified when creating a finding.
|
940
964
|
#
|
@@ -943,71 +967,71 @@ module Google
|
|
943
967
|
# be added/updated by using "source_properties.<property key>" in the field
|
944
968
|
# mask.
|
945
969
|
class UpdateFindingRequest
|
946
|
-
include Google::Protobuf::MessageExts
|
947
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
970
|
+
include ::Google::Protobuf::MessageExts
|
971
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
948
972
|
end
|
949
973
|
|
950
974
|
# Request message for updating a notification config.
|
951
975
|
# @!attribute [rw] notification_config
|
952
|
-
# @return [Google::Cloud::SecurityCenter::V1::NotificationConfig]
|
976
|
+
# @return [::Google::Cloud::SecurityCenter::V1::NotificationConfig]
|
953
977
|
# Required. The notification config to update.
|
954
978
|
# @!attribute [rw] update_mask
|
955
|
-
# @return [Google::Protobuf::FieldMask]
|
979
|
+
# @return [::Google::Protobuf::FieldMask]
|
956
980
|
# The FieldMask to use when updating the notification config.
|
957
981
|
#
|
958
982
|
# If empty all mutable fields will be updated.
|
959
983
|
class UpdateNotificationConfigRequest
|
960
|
-
include Google::Protobuf::MessageExts
|
961
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
984
|
+
include ::Google::Protobuf::MessageExts
|
985
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
962
986
|
end
|
963
987
|
|
964
988
|
# Request message for updating an organization's settings.
|
965
989
|
# @!attribute [rw] organization_settings
|
966
|
-
# @return [Google::Cloud::SecurityCenter::V1::OrganizationSettings]
|
990
|
+
# @return [::Google::Cloud::SecurityCenter::V1::OrganizationSettings]
|
967
991
|
# Required. The organization settings resource to update.
|
968
992
|
# @!attribute [rw] update_mask
|
969
|
-
# @return [Google::Protobuf::FieldMask]
|
993
|
+
# @return [::Google::Protobuf::FieldMask]
|
970
994
|
# The FieldMask to use when updating the settings resource.
|
971
995
|
#
|
972
996
|
# If empty all mutable fields will be updated.
|
973
997
|
class UpdateOrganizationSettingsRequest
|
974
|
-
include Google::Protobuf::MessageExts
|
975
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
998
|
+
include ::Google::Protobuf::MessageExts
|
999
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
976
1000
|
end
|
977
1001
|
|
978
1002
|
# Request message for updating a source.
|
979
1003
|
# @!attribute [rw] source
|
980
|
-
# @return [Google::Cloud::SecurityCenter::V1::Source]
|
1004
|
+
# @return [::Google::Cloud::SecurityCenter::V1::Source]
|
981
1005
|
# Required. The source resource to update.
|
982
1006
|
# @!attribute [rw] update_mask
|
983
|
-
# @return [Google::Protobuf::FieldMask]
|
1007
|
+
# @return [::Google::Protobuf::FieldMask]
|
984
1008
|
# The FieldMask to use when updating the source resource.
|
985
1009
|
#
|
986
1010
|
# If empty all mutable fields will be updated.
|
987
1011
|
class UpdateSourceRequest
|
988
|
-
include Google::Protobuf::MessageExts
|
989
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
1012
|
+
include ::Google::Protobuf::MessageExts
|
1013
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
990
1014
|
end
|
991
1015
|
|
992
1016
|
# Request message for updating a SecurityMarks resource.
|
993
1017
|
# @!attribute [rw] security_marks
|
994
|
-
# @return [Google::Cloud::SecurityCenter::V1::SecurityMarks]
|
1018
|
+
# @return [::Google::Cloud::SecurityCenter::V1::SecurityMarks]
|
995
1019
|
# Required. The security marks resource to update.
|
996
1020
|
# @!attribute [rw] update_mask
|
997
|
-
# @return [Google::Protobuf::FieldMask]
|
1021
|
+
# @return [::Google::Protobuf::FieldMask]
|
998
1022
|
# The FieldMask to use when updating the security marks resource.
|
999
1023
|
#
|
1000
1024
|
# The field mask must not contain duplicate fields.
|
1001
1025
|
# If empty or set to "marks", all marks will be replaced. Individual
|
1002
1026
|
# marks can be updated using "marks.<mark_key>".
|
1003
1027
|
# @!attribute [rw] start_time
|
1004
|
-
# @return [Google::Protobuf::Timestamp]
|
1028
|
+
# @return [::Google::Protobuf::Timestamp]
|
1005
1029
|
# The time at which the updated SecurityMarks take effect.
|
1006
1030
|
# If not set uses current server time. Updates will be applied to the
|
1007
1031
|
# SecurityMarks that are active immediately preceding this time.
|
1008
1032
|
class UpdateSecurityMarksRequest
|
1009
|
-
include Google::Protobuf::MessageExts
|
1010
|
-
extend Google::Protobuf::MessageExts::ClassMethods
|
1033
|
+
include ::Google::Protobuf::MessageExts
|
1034
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1011
1035
|
end
|
1012
1036
|
end
|
1013
1037
|
end
|