google-cloud-security_center-v1 0.1.0 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|