google-apis-securitycenter_v1beta2 0.46.0 → 0.48.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9f26c81e486fad0335fb2b21bfa62e61ff343e9c6d40984b96169a7cbf4aba69
4
- data.tar.gz: cee1497221b3361959d56611779f9a0d7d656264a8e20d8d6dbf7371a4851b83
3
+ metadata.gz: af804b291482652275777b29007b0161a8e959c3282170b174f803c28edf3999
4
+ data.tar.gz: 6f50e4c295e990f485c6de7e31cb87cbe708053d249f23150ee7899c13bb6409
5
5
  SHA512:
6
- metadata.gz: c3ff87cdddd5fa0ad6f5e23aa4d138ab2c4bc9b4f6925e1f4135beba78a7f6699cdadf847de0f97e8e5aee7f907f229f8bc06460fdfaa065a82a6a0157d0e44b
7
- data.tar.gz: 4126401030ecb678a44632080aa37431f707d5dd21261df4c56770273a5b52ec92d72052524ace460c2eca1ddbc07b0e8153cdc9c9c1f25beb9ec81e840af2a3
6
+ metadata.gz: d9bb8a7e7040fa04a9bff4e6e34f79ff42cce522b397662649e243d90d04f4db4ad7a7120096df0b6688a41d22637a1cd010a08cd4d7fb20ad4947b60d0322a2
7
+ data.tar.gz: 2b3119c644acc90544eb90320842d882317dcddba00671416177c4eaf6a04da163c4ec261df9ce6a80e91914a926f53bfab392a798a0a01bc22cfa4b0de0eb02
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-securitycenter_v1beta2
2
2
 
3
+ ### v0.48.0 (2023-04-30)
4
+
5
+ * Regenerated from discovery document revision 20230420
6
+
7
+ ### v0.47.0 (2023-04-23)
8
+
9
+ * Regenerated from discovery document revision 20230414
10
+
3
11
  ### v0.46.0 (2023-04-02)
4
12
 
5
13
  * Regenerated from discovery document revision 20230329
@@ -42,39 +42,41 @@ module Google
42
42
  attr_accessor :method_name
43
43
 
44
44
  # Associated email, such as "foo@google.com". The email address of the
45
- # authenticated user (or service account on behalf of third party principal)
46
- # making the request. For third party identity callers, the `principal_subject`
47
- # field is populated instead of this field. For privacy reasons, the principal
48
- # email address is sometimes redacted. For more information, see [Caller
49
- # identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
45
+ # authenticated user or a service account acting on behalf of a third party
46
+ # principal making the request. For third party identity callers, the `
47
+ # principal_subject` field is populated instead of this field. For privacy
48
+ # reasons, the principal email address is sometimes redacted. For more
49
+ # information, see [Caller identities in audit logs](https://cloud.google.com/
50
+ # logging/docs/audit#user-id).
50
51
  # Corresponds to the JSON property `principalEmail`
51
52
  # @return [String]
52
53
  attr_accessor :principal_email
53
54
 
54
- # A string representing the principal_subject associated with the identity. As
55
- # compared to `principal_email`, supports principals that aren't associated with
56
- # email addresses, such as third party principals. For most identities, the
57
- # format will be `principal://iam.googleapis.com/`identity pool name`/subjects/`
58
- # subject`` except for some GKE identities (GKE_WORKLOAD, FREEFORM,
59
- # GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:`
60
- # identity pool name`[`subject`]`
55
+ # A string that represents the principal_subject that is associated with the
56
+ # identity. Unlike `principal_email`, `principal_subject` supports principals
57
+ # that aren't associated with email addresses, such as third party principals.
58
+ # For most identities, the format is `principal://iam.googleapis.com/`identity
59
+ # pool name`/subject/`subject``. Some GKE identities, such as GKE_WORKLOAD,
60
+ # FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:`
61
+ # identity pool name`[`subject`]`.
61
62
  # Corresponds to the JSON property `principalSubject`
62
63
  # @return [String]
63
64
  attr_accessor :principal_subject
64
65
 
65
- # Identity delegation history of an authenticated service account that makes the
66
- # request. It contains information on the real authorities that try to access
67
- # GCP resources by delegating on a service account. When multiple authorities
68
- # are present, they are guaranteed to be sorted based on the original ordering
69
- # of the identity delegation events.
66
+ # The identity delegation history of an authenticated service account that made
67
+ # the request. The `serviceAccountDelegationInfo[]` object contains information
68
+ # about the real authorities that try to access Google Cloud resources by
69
+ # delegating on a service account. When multiple authorities are present, they
70
+ # are guaranteed to be sorted based on the original ordering of the identity
71
+ # delegation events.
70
72
  # Corresponds to the JSON property `serviceAccountDelegationInfo`
71
73
  # @return [Array<Google::Apis::SecuritycenterV1beta2::ServiceAccountDelegationInfo>]
72
74
  attr_accessor :service_account_delegation_info
73
75
 
74
- # The name of the service account key used to create or exchange credentials for
75
- # authenticating the service account making the request. This is a scheme-less
76
- # URI full resource name. For example: "//iam.googleapis.com/projects/`
77
- # PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key`"
76
+ # The name of the service account key that was used to create or exchange
77
+ # credentials when authenticating the service account that made the request.
78
+ # This is a scheme-less URI full resource name. For example: "//iam.googleapis.
79
+ # com/projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key`".
78
80
  # Corresponds to the JSON property `serviceAccountKeyName`
79
81
  # @return [String]
80
82
  attr_accessor :service_account_key_name
@@ -85,18 +87,16 @@ module Google
85
87
  # @return [String]
86
88
  attr_accessor :service_name
87
89
 
88
- # What kind of user agent is associated, for example operating system shells,
89
- # embedded or stand-alone applications, etc.
90
+ # Type of user agent associated with the finding. For example, an operating
91
+ # system shell or an embedded or standalone application.
90
92
  # Corresponds to the JSON property `userAgentFamily`
91
93
  # @return [String]
92
94
  attr_accessor :user_agent_family
93
95
 
94
- # A string that represents the username of a user, user account, or other entity
95
- # involved in the access event. What the entity is and what its role in the
96
- # access event is depends on the finding that this field appears in. The entity
97
- # is likely not an IAM principal, but could be a user that is logged into an
98
- # operating system, if the finding is VM-related, or a user that is logged into
99
- # some type of application that is involved in the access event.
96
+ # A string that represents a username. The username provided depends on the type
97
+ # of the finding and is likely not an IAM principal. For example, this can be a
98
+ # system username if the finding is related to a virtual machine, or it can be
99
+ # an application login username.
100
100
  # Corresponds to the JSON property `userName`
101
101
  # @return [String]
102
102
  attr_accessor :user_name
@@ -120,17 +120,19 @@ module Google
120
120
  end
121
121
  end
122
122
 
123
- # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i .
124
- # ..) that was involved in a finding.
123
+ # Conveys information about a Kubernetes access review (such as one returned by
124
+ # a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-
125
+ # authz/authorization/#checking-api-access) command) that was involved in a
126
+ # finding.
125
127
  class AccessReview
126
128
  include Google::Apis::Core::Hashable
127
129
 
128
- # Group is the API Group of the Resource. "*" means all.
130
+ # The API group of the resource. "*" means all.
129
131
  # Corresponds to the JSON property `group`
130
132
  # @return [String]
131
133
  attr_accessor :group
132
134
 
133
- # Name is the name of the resource being requested. Empty means all.
135
+ # The name of the resource being requested. Empty means all.
134
136
  # Corresponds to the JSON property `name`
135
137
  # @return [String]
136
138
  attr_accessor :name
@@ -141,23 +143,23 @@ module Google
141
143
  # @return [String]
142
144
  attr_accessor :ns
143
145
 
144
- # Resource is the optional resource type requested. "*" means all.
146
+ # The optional resource type requested. "*" means all.
145
147
  # Corresponds to the JSON property `resource`
146
148
  # @return [String]
147
149
  attr_accessor :resource
148
150
 
149
- # Subresource is the optional subresource type.
151
+ # The optional subresource type.
150
152
  # Corresponds to the JSON property `subresource`
151
153
  # @return [String]
152
154
  attr_accessor :subresource
153
155
 
154
- # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update,
155
- # delete, proxy. "*" means all.
156
+ # A Kubernetes resource API verb, like get, list, watch, create, update, delete,
157
+ # proxy. "*" means all.
156
158
  # Corresponds to the JSON property `verb`
157
159
  # @return [String]
158
160
  attr_accessor :verb
159
161
 
160
- # Version is the API Version of the Resource. "*" means all.
162
+ # The API version of the resource. "*" means all.
161
163
  # Corresponds to the JSON property `version`
162
164
  # @return [String]
163
165
  attr_accessor :version
@@ -211,8 +213,8 @@ module Google
211
213
  attr_accessor :full_scan
212
214
  alias_method :full_scan?, :full_scan
213
215
 
214
- # The [type of information](https://cloud.google.com/dlp/docs/infotypes-
215
- # reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
216
+ # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/
217
+ # infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
216
218
  # Corresponds to the JSON property `infoType`
217
219
  # @return [String]
218
220
  attr_accessor :info_type
@@ -246,18 +248,17 @@ module Google
246
248
  class Compliance
247
249
  include Google::Apis::Core::Hashable
248
250
 
249
- # Policies within the standard/benchmark e.g. A.12.4.1
251
+ # Policies within the standard or benchmark, for example, A.12.4.1
250
252
  # Corresponds to the JSON property `ids`
251
253
  # @return [Array<String>]
252
254
  attr_accessor :ids
253
255
 
254
- # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp",
255
- # etc.
256
+ # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
256
257
  # Corresponds to the JSON property `standard`
257
258
  # @return [String]
258
259
  attr_accessor :standard
259
260
 
260
- # Version of the standard/benchmark e.g. 1.1
261
+ # Version of the standard or benchmark, for example, 1.1
261
262
  # Corresponds to the JSON property `version`
262
263
  # @return [String]
263
264
  attr_accessor :version
@@ -363,7 +364,7 @@ module Google
363
364
  end
364
365
  end
365
366
 
366
- # The details pertaining to specific contacts
367
+ # Details about specific contacts
367
368
  class ContactDetails
368
369
  include Google::Apis::Core::Hashable
369
370
 
@@ -386,7 +387,7 @@ module Google
386
387
  class Container
387
388
  include Google::Apis::Core::Hashable
388
389
 
389
- # Optional container image id, when provided by the container runtime. Uniquely
390
+ # Optional container image ID, if provided by the container runtime. Uniquely
390
391
  # identifies the container image launched using a container image digest.
391
392
  # Corresponds to the JSON property `imageId`
392
393
  # @return [String]
@@ -397,13 +398,13 @@ module Google
397
398
  # @return [Array<Google::Apis::SecuritycenterV1beta2::Label>]
398
399
  attr_accessor :labels
399
400
 
400
- # Container name.
401
+ # Name of the container.
401
402
  # Corresponds to the JSON property `name`
402
403
  # @return [String]
403
404
  attr_accessor :name
404
405
 
405
- # Container image URI provided when configuring a pod/container. May identify a
406
- # container image version using mutable tags.
406
+ # Container image URI provided when configuring a pod or container. This string
407
+ # can identify a container image version using mutable tags.
407
408
  # Corresponds to the JSON property `uri`
408
409
  # @return [String]
409
410
  attr_accessor :uri
@@ -591,38 +592,43 @@ module Google
591
592
  end
592
593
 
593
594
  # Represents database access information, such as queries. A database may be a
594
- # sub-resource of an instance (as in the case of CloudSQL instances or Cloud
595
+ # sub-resource of an instance (as in the case of Cloud SQL instances or Cloud
595
596
  # Spanner instances), or the database instance itself. Some database resources
596
- # may not have the full resource name populated because these resource types are
597
- # not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these
598
- # cases only the display name will be provided.
597
+ # might not have the [full resource name](https://google.aip.dev/122#full-
598
+ # resource-names) populated because these resource types, such as Cloud SQL
599
+ # databases, are not yet supported by Cloud Asset Inventory. In these cases only
600
+ # the display name is provided. Some database resources may not have the [full
601
+ # resource name](https://google.aip.dev/122#full-resource-names) populated
602
+ # because these resource types are not yet supported by Cloud Asset Inventory (e.
603
+ # g. Cloud SQL databases). In these cases only the display name will be provided.
599
604
  class Database
600
605
  include Google::Apis::Core::Hashable
601
606
 
602
- # The human readable name of the database the user connected to.
607
+ # The human-readable name of the database that the user connected to.
603
608
  # Corresponds to the JSON property `displayName`
604
609
  # @return [String]
605
610
  attr_accessor :display_name
606
611
 
607
- # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy
608
- # change).
612
+ # The target usernames, roles, or groups of an SQL privilege grant, which is not
613
+ # an IAM policy change.
609
614
  # Corresponds to the JSON property `grantees`
610
615
  # @return [Array<String>]
611
616
  attr_accessor :grantees
612
617
 
613
- # The full resource name of the database the user connected to, if it is
614
- # supported by CAI. (https://google.aip.dev/122#full-resource-names)
618
+ # The [full resource name](https://google.aip.dev/122#full-resource-names) of
619
+ # the database that the user connected to, if it is supported by Cloud Asset
620
+ # Inventory.
615
621
  # Corresponds to the JSON property `name`
616
622
  # @return [String]
617
623
  attr_accessor :name
618
624
 
619
- # The SQL statement associated with the relevant access.
625
+ # The SQL statement that is associated with the database access.
620
626
  # Corresponds to the JSON property `query`
621
627
  # @return [String]
622
628
  attr_accessor :query
623
629
 
624
- # The username used to connect to the DB. This may not necessarily be an IAM
625
- # principal, and has no required format.
630
+ # The username used to connect to the database. The username might not be an IAM
631
+ # principal and does not have a set format.
626
632
  # Corresponds to the JSON property `userName`
627
633
  # @return [String]
628
634
  attr_accessor :user_name
@@ -697,8 +703,8 @@ module Google
697
703
  end
698
704
  end
699
705
 
700
- # EnvironmentVariable is a name-value pair to store environment variables for
701
- # Process.
706
+ # A name-value pair representing an environment variable used in an operating
707
+ # system process.
702
708
  class EnvironmentVariable
703
709
  include Google::Apis::Core::Hashable
704
710
 
@@ -765,19 +771,20 @@ module Google
765
771
  end
766
772
  end
767
773
 
768
- # Resource that has been exfiltrated or exfiltrated_to.
774
+ # Resource where data was exfiltrated from or exfiltrated to.
769
775
  class ExfilResource
770
776
  include Google::Apis::Core::Hashable
771
777
 
772
- # Subcomponents of the asset that is exfiltrated - these could be URIs used
773
- # during exfiltration, table names, databases, filenames, etc. For example,
774
- # multiple tables may be exfiltrated from the same CloudSQL instance, or
775
- # multiple files from the same Cloud Storage bucket.
778
+ # Subcomponents of the asset that was exfiltrated, like URIs used during
779
+ # exfiltration, table names, databases, and filenames. For example, multiple
780
+ # tables might have been exfiltrated from the same Cloud SQL instance, or
781
+ # multiple files might have been exfiltrated from the same Cloud Storage bucket.
776
782
  # Corresponds to the JSON property `components`
777
783
  # @return [Array<String>]
778
784
  attr_accessor :components
779
785
 
780
- # Resource's URI (https://google.aip.dev/122#full-resource-names)
786
+ # The resource's [full resource name](https://cloud.google.com/apis/design/
787
+ # resource_names#full_resource_name).
781
788
  # Corresponds to the JSON property `name`
782
789
  # @return [String]
783
790
  attr_accessor :name
@@ -793,9 +800,10 @@ module Google
793
800
  end
794
801
  end
795
802
 
796
- # Exfiltration represents a data exfiltration attempt of one or more sources to
797
- # one or more targets. Sources represent the source of data that is exfiltrated,
798
- # and Targets represents the destination the data was copied to.
803
+ # Exfiltration represents a data exfiltration attempt from one or more sources
804
+ # to one or more targets. The `sources` attribute lists the sources of the
805
+ # exfiltrated data. The `targets` attribute lists the destinations the data was
806
+ # copied to.
799
807
  class Exfiltration
800
808
  include Google::Apis::Core::Hashable
801
809
 
@@ -823,13 +831,66 @@ module Google
823
831
  end
824
832
  end
825
833
 
834
+ # Represents a textual expression in the Common Expression Language (CEL) syntax.
835
+ # CEL is a C-like expression language. The syntax and semantics of CEL are
836
+ # documented at https://github.com/google/cel-spec. Example (Comparison): title:
837
+ # "Summary size limit" description: "Determines if a summary is less than 100
838
+ # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
839
+ # Requestor is owner" description: "Determines if requestor is the document
840
+ # owner" expression: "document.owner == request.auth.claims.email" Example (
841
+ # Logic): title: "Public documents" description: "Determine whether the document
842
+ # should be publicly visible" expression: "document.type != 'private' &&
843
+ # document.type != 'internal'" Example (Data Manipulation): title: "Notification
844
+ # string" description: "Create a notification string with a timestamp."
845
+ # expression: "'New message received at ' + string(document.create_time)" The
846
+ # exact variables and functions that may be referenced within an expression are
847
+ # determined by the service that evaluates it. See the service documentation for
848
+ # additional information.
849
+ class Expr
850
+ include Google::Apis::Core::Hashable
851
+
852
+ # Optional. Description of the expression. This is a longer text which describes
853
+ # the expression, e.g. when hovered over it in a UI.
854
+ # Corresponds to the JSON property `description`
855
+ # @return [String]
856
+ attr_accessor :description
857
+
858
+ # Textual representation of an expression in Common Expression Language syntax.
859
+ # Corresponds to the JSON property `expression`
860
+ # @return [String]
861
+ attr_accessor :expression
862
+
863
+ # Optional. String indicating the location of the expression for error reporting,
864
+ # e.g. a file name and a position in the file.
865
+ # Corresponds to the JSON property `location`
866
+ # @return [String]
867
+ attr_accessor :location
868
+
869
+ # Optional. Title for the expression, i.e. a short string describing its purpose.
870
+ # This can be used e.g. in UIs which allow to enter the expression.
871
+ # Corresponds to the JSON property `title`
872
+ # @return [String]
873
+ attr_accessor :title
874
+
875
+ def initialize(**args)
876
+ update!(**args)
877
+ end
878
+
879
+ # Update properties of this object
880
+ def update!(**args)
881
+ @description = args[:description] if args.key?(:description)
882
+ @expression = args[:expression] if args.key?(:expression)
883
+ @location = args[:location] if args.key?(:location)
884
+ @title = args[:title] if args.key?(:title)
885
+ end
886
+ end
887
+
826
888
  # File information about the related binary/library used by an executable, or
827
889
  # the script used by a script interpreter
828
890
  class File
829
891
  include Google::Apis::Core::Hashable
830
892
 
831
- # Prefix of the file contents as a JSON encoded string. (Currently only
832
- # populated for Malicious Script Executed findings.)
893
+ # Prefix of the file contents as a JSON-encoded string.
833
894
  # Corresponds to the JSON property `contents`
834
895
  # @return [String]
835
896
  attr_accessor :contents
@@ -939,7 +1000,7 @@ module Google
939
1000
  # @return [Hash<String,Google::Apis::SecuritycenterV1beta2::ContactDetails>]
940
1001
  attr_accessor :contacts
941
1002
 
942
- # Containers associated with the finding. containers provides information for
1003
+ # Containers associated with the finding. This field provides information for
943
1004
  # both Kubernetes and non-Kubernetes containers.
944
1005
  # Corresponds to the JSON property `containers`
945
1006
  # @return [Array<Google::Apis::SecuritycenterV1beta2::Container>]
@@ -951,16 +1012,20 @@ module Google
951
1012
  attr_accessor :create_time
952
1013
 
953
1014
  # Represents database access information, such as queries. A database may be a
954
- # sub-resource of an instance (as in the case of CloudSQL instances or Cloud
1015
+ # sub-resource of an instance (as in the case of Cloud SQL instances or Cloud
955
1016
  # Spanner instances), or the database instance itself. Some database resources
956
- # may not have the full resource name populated because these resource types are
957
- # not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these
958
- # cases only the display name will be provided.
1017
+ # might not have the [full resource name](https://google.aip.dev/122#full-
1018
+ # resource-names) populated because these resource types, such as Cloud SQL
1019
+ # databases, are not yet supported by Cloud Asset Inventory. In these cases only
1020
+ # the display name is provided. Some database resources may not have the [full
1021
+ # resource name](https://google.aip.dev/122#full-resource-names) populated
1022
+ # because these resource types are not yet supported by Cloud Asset Inventory (e.
1023
+ # g. Cloud SQL databases). In these cases only the display name will be provided.
959
1024
  # Corresponds to the JSON property `database`
960
1025
  # @return [Google::Apis::SecuritycenterV1beta2::Database]
961
1026
  attr_accessor :database
962
1027
 
963
- # Contains more detail about the finding.
1028
+ # Contains more details about the finding.
964
1029
  # Corresponds to the JSON property `description`
965
1030
  # @return [String]
966
1031
  attr_accessor :description
@@ -975,9 +1040,10 @@ module Google
975
1040
  # @return [String]
976
1041
  attr_accessor :event_time
977
1042
 
978
- # Exfiltration represents a data exfiltration attempt of one or more sources to
979
- # one or more targets. Sources represent the source of data that is exfiltrated,
980
- # and Targets represents the destination the data was copied to.
1043
+ # Exfiltration represents a data exfiltration attempt from one or more sources
1044
+ # to one or more targets. The `sources` attribute lists the sources of the
1045
+ # exfiltrated data. The `targets` attribute lists the destinations the data was
1046
+ # copied to.
981
1047
  # Corresponds to the JSON property `exfiltration`
982
1048
  # @return [Google::Apis::SecuritycenterV1beta2::Exfiltration]
983
1049
  attr_accessor :exfiltration
@@ -1005,7 +1071,7 @@ module Google
1005
1071
  # @return [String]
1006
1072
  attr_accessor :finding_class
1007
1073
 
1008
- # Represents IAM bindings associated with the Finding.
1074
+ # Represents IAM bindings associated with the finding.
1009
1075
  # Corresponds to the JSON property `iamBindings`
1010
1076
  # @return [Array<Google::Apis::SecuritycenterV1beta2::IamBinding>]
1011
1077
  attr_accessor :iam_bindings
@@ -1048,10 +1114,9 @@ module Google
1048
1114
  # @return [String]
1049
1115
  attr_accessor :mute
1050
1116
 
1051
- # First known as mute_annotation. Records additional information about the mute
1052
- # operation e.g. mute config that muted the finding, user who muted the finding,
1053
- # etc. Unlike other attributes of a finding, a finding provider shouldn't set
1054
- # the value of mute.
1117
+ # Records additional information about the mute operation, for example, the [
1118
+ # mute configuration](/security-command-center/docs/how-to-mute-findings) that
1119
+ # muted the finding and the user who muted the finding.
1055
1120
  # Corresponds to the JSON property `muteInitiator`
1056
1121
  # @return [String]
1057
1122
  attr_accessor :mute_initiator
@@ -1061,14 +1126,16 @@ module Google
1061
1126
  # @return [String]
1062
1127
  attr_accessor :mute_update_time
1063
1128
 
1064
- # The relative resource name of this finding. See: https://cloud.google.com/apis/
1065
- # design/resource_names#relative_resource_name Example: "organizations/`
1066
- # organization_id`/sources/`source_id`/findings/`finding_id`"
1129
+ # The [relative resource name](https://cloud.google.com/apis/design/
1130
+ # resource_names#relative_resource_name) of the finding. Example: "organizations/
1131
+ # `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
1132
+ # folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
1133
+ # sources/`source_id`/findings/`finding_id`".
1067
1134
  # Corresponds to the JSON property `name`
1068
1135
  # @return [String]
1069
1136
  attr_accessor :name
1070
1137
 
1071
- # Next steps associate to the finding.
1138
+ # Steps to address the finding.
1072
1139
  # Corresponds to the JSON property `nextSteps`
1073
1140
  # @return [String]
1074
1141
  attr_accessor :next_steps
@@ -1312,12 +1379,12 @@ module Google
1312
1379
  class GoogleCloudSecuritycenterV1Binding
1313
1380
  include Google::Apis::Core::Hashable
1314
1381
 
1315
- # Name for binding.
1382
+ # Name for the binding.
1316
1383
  # Corresponds to the JSON property `name`
1317
1384
  # @return [String]
1318
1385
  attr_accessor :name
1319
1386
 
1320
- # Namespace for binding.
1387
+ # Namespace for the binding.
1321
1388
  # Corresponds to the JSON property `ns`
1322
1389
  # @return [String]
1323
1390
  attr_accessor :ns
@@ -1359,6 +1426,156 @@ module Google
1359
1426
  end
1360
1427
  end
1361
1428
 
1429
+ # Defines the properties in a custom module configuration for Security Health
1430
+ # Analytics. Use the custom module configuration to create custom detectors that
1431
+ # generate custom findings for resources that you specify.
1432
+ class GoogleCloudSecuritycenterV1CustomConfig
1433
+ include Google::Apis::Core::Hashable
1434
+
1435
+ # A set of optional name-value pairs that define custom source properties to
1436
+ # return with each finding that is generated by the custom module. The custom
1437
+ # source properties that are defined here are included in the finding JSON under
1438
+ # `sourceProperties`.
1439
+ # Corresponds to the JSON property `customOutput`
1440
+ # @return [Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomOutputSpec]
1441
+ attr_accessor :custom_output
1442
+
1443
+ # Text that describes the vulnerability or misconfiguration that the custom
1444
+ # module detects. This explanation is returned with each finding instance to
1445
+ # help investigators understand the detected issue. The text must be enclosed in
1446
+ # quotation marks.
1447
+ # Corresponds to the JSON property `description`
1448
+ # @return [String]
1449
+ attr_accessor :description
1450
+
1451
+ # Represents a textual expression in the Common Expression Language (CEL) syntax.
1452
+ # CEL is a C-like expression language. The syntax and semantics of CEL are
1453
+ # documented at https://github.com/google/cel-spec. Example (Comparison): title:
1454
+ # "Summary size limit" description: "Determines if a summary is less than 100
1455
+ # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
1456
+ # Requestor is owner" description: "Determines if requestor is the document
1457
+ # owner" expression: "document.owner == request.auth.claims.email" Example (
1458
+ # Logic): title: "Public documents" description: "Determine whether the document
1459
+ # should be publicly visible" expression: "document.type != 'private' &&
1460
+ # document.type != 'internal'" Example (Data Manipulation): title: "Notification
1461
+ # string" description: "Create a notification string with a timestamp."
1462
+ # expression: "'New message received at ' + string(document.create_time)" The
1463
+ # exact variables and functions that may be referenced within an expression are
1464
+ # determined by the service that evaluates it. See the service documentation for
1465
+ # additional information.
1466
+ # Corresponds to the JSON property `predicate`
1467
+ # @return [Google::Apis::SecuritycenterV1beta2::Expr]
1468
+ attr_accessor :predicate
1469
+
1470
+ # An explanation of the recommended steps that security teams can take to
1471
+ # resolve the detected issue. This explanation is returned with each finding
1472
+ # generated by this module in the `nextSteps` property of the finding JSON.
1473
+ # Corresponds to the JSON property `recommendation`
1474
+ # @return [String]
1475
+ attr_accessor :recommendation
1476
+
1477
+ # Resource for selecting resource type.
1478
+ # Corresponds to the JSON property `resourceSelector`
1479
+ # @return [Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1ResourceSelector]
1480
+ attr_accessor :resource_selector
1481
+
1482
+ # The severity to assign to findings generated by the module.
1483
+ # Corresponds to the JSON property `severity`
1484
+ # @return [String]
1485
+ attr_accessor :severity
1486
+
1487
+ def initialize(**args)
1488
+ update!(**args)
1489
+ end
1490
+
1491
+ # Update properties of this object
1492
+ def update!(**args)
1493
+ @custom_output = args[:custom_output] if args.key?(:custom_output)
1494
+ @description = args[:description] if args.key?(:description)
1495
+ @predicate = args[:predicate] if args.key?(:predicate)
1496
+ @recommendation = args[:recommendation] if args.key?(:recommendation)
1497
+ @resource_selector = args[:resource_selector] if args.key?(:resource_selector)
1498
+ @severity = args[:severity] if args.key?(:severity)
1499
+ end
1500
+ end
1501
+
1502
+ # A set of optional name-value pairs that define custom source properties to
1503
+ # return with each finding that is generated by the custom module. The custom
1504
+ # source properties that are defined here are included in the finding JSON under
1505
+ # `sourceProperties`.
1506
+ class GoogleCloudSecuritycenterV1CustomOutputSpec
1507
+ include Google::Apis::Core::Hashable
1508
+
1509
+ # A list of custom output properties to add to the finding.
1510
+ # Corresponds to the JSON property `properties`
1511
+ # @return [Array<Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1Property>]
1512
+ attr_accessor :properties
1513
+
1514
+ def initialize(**args)
1515
+ update!(**args)
1516
+ end
1517
+
1518
+ # Update properties of this object
1519
+ def update!(**args)
1520
+ @properties = args[:properties] if args.key?(:properties)
1521
+ end
1522
+ end
1523
+
1524
+ # An EffectiveSecurityHealthAnalyticsCustomModule is the representation of a
1525
+ # Security Health Analytics custom module at a specified level of the resource
1526
+ # hierarchy: organization, folder, or project. If a custom module is inherited
1527
+ # from a parent organization or folder, the value of the `enablementState`
1528
+ # property in EffectiveSecurityHealthAnalyticsCustomModule is set to the value
1529
+ # that is effective in the parent, instead of `INHERITED`. For example, if the
1530
+ # module is enabled in a parent organization or folder, the effective
1531
+ # enablement_state for the module in all child folders or projects is also `
1532
+ # enabled`. EffectiveSecurityHealthAnalyticsCustomModule is read-only.
1533
+ class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
1534
+ include Google::Apis::Core::Hashable
1535
+
1536
+ # Defines the properties in a custom module configuration for Security Health
1537
+ # Analytics. Use the custom module configuration to create custom detectors that
1538
+ # generate custom findings for resources that you specify.
1539
+ # Corresponds to the JSON property `customConfig`
1540
+ # @return [Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig]
1541
+ attr_accessor :custom_config
1542
+
1543
+ # Output only. The display name for the custom module. The name must be between
1544
+ # 1 and 128 characters, start with a lowercase letter, and contain alphanumeric
1545
+ # characters or underscores only.
1546
+ # Corresponds to the JSON property `displayName`
1547
+ # @return [String]
1548
+ attr_accessor :display_name
1549
+
1550
+ # Output only. The effective state of enablement for the module at the given
1551
+ # level of the hierarchy.
1552
+ # Corresponds to the JSON property `enablementState`
1553
+ # @return [String]
1554
+ attr_accessor :enablement_state
1555
+
1556
+ # Output only. The resource name of the custom module. Its format is "
1557
+ # organizations/`organization`/securityHealthAnalyticsSettings/
1558
+ # effectiveCustomModules/`customModule`", or "folders/`folder`/
1559
+ # securityHealthAnalyticsSettings/effectiveCustomModules/`customModule`", or "
1560
+ # projects/`project`/securityHealthAnalyticsSettings/effectiveCustomModules/`
1561
+ # customModule`"
1562
+ # Corresponds to the JSON property `name`
1563
+ # @return [String]
1564
+ attr_accessor :name
1565
+
1566
+ def initialize(**args)
1567
+ update!(**args)
1568
+ end
1569
+
1570
+ # Update properties of this object
1571
+ def update!(**args)
1572
+ @custom_config = args[:custom_config] if args.key?(:custom_config)
1573
+ @display_name = args[:display_name] if args.key?(:display_name)
1574
+ @enablement_state = args[:enablement_state] if args.key?(:enablement_state)
1575
+ @name = args[:name] if args.key?(:name)
1576
+ end
1577
+ end
1578
+
1362
1579
  # Representation of third party SIEM/SOAR fields within SCC.
1363
1580
  class GoogleCloudSecuritycenterV1ExternalSystem
1364
1581
  include Google::Apis::Core::Hashable
@@ -1514,6 +1731,45 @@ module Google
1514
1731
  end
1515
1732
  end
1516
1733
 
1734
+ # An individual name-value pair that defines a custom source property.
1735
+ class GoogleCloudSecuritycenterV1Property
1736
+ include Google::Apis::Core::Hashable
1737
+
1738
+ # Name of the property for the custom output.
1739
+ # Corresponds to the JSON property `name`
1740
+ # @return [String]
1741
+ attr_accessor :name
1742
+
1743
+ # Represents a textual expression in the Common Expression Language (CEL) syntax.
1744
+ # CEL is a C-like expression language. The syntax and semantics of CEL are
1745
+ # documented at https://github.com/google/cel-spec. Example (Comparison): title:
1746
+ # "Summary size limit" description: "Determines if a summary is less than 100
1747
+ # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
1748
+ # Requestor is owner" description: "Determines if requestor is the document
1749
+ # owner" expression: "document.owner == request.auth.claims.email" Example (
1750
+ # Logic): title: "Public documents" description: "Determine whether the document
1751
+ # should be publicly visible" expression: "document.type != 'private' &&
1752
+ # document.type != 'internal'" Example (Data Manipulation): title: "Notification
1753
+ # string" description: "Create a notification string with a timestamp."
1754
+ # expression: "'New message received at ' + string(document.create_time)" The
1755
+ # exact variables and functions that may be referenced within an expression are
1756
+ # determined by the service that evaluates it. See the service documentation for
1757
+ # additional information.
1758
+ # Corresponds to the JSON property `valueExpression`
1759
+ # @return [Google::Apis::SecuritycenterV1beta2::Expr]
1760
+ attr_accessor :value_expression
1761
+
1762
+ def initialize(**args)
1763
+ update!(**args)
1764
+ end
1765
+
1766
+ # Update properties of this object
1767
+ def update!(**args)
1768
+ @name = args[:name] if args.key?(:name)
1769
+ @value_expression = args[:value_expression] if args.key?(:value_expression)
1770
+ end
1771
+ end
1772
+
1517
1773
  # Information related to the Google Cloud resource.
1518
1774
  class GoogleCloudSecuritycenterV1Resource
1519
1775
  include Google::Apis::Core::Hashable
@@ -1578,6 +1834,25 @@ module Google
1578
1834
  end
1579
1835
  end
1580
1836
 
1837
+ # Resource for selecting resource type.
1838
+ class GoogleCloudSecuritycenterV1ResourceSelector
1839
+ include Google::Apis::Core::Hashable
1840
+
1841
+ # The resource types to run the detector on.
1842
+ # Corresponds to the JSON property `resourceTypes`
1843
+ # @return [Array<String>]
1844
+ attr_accessor :resource_types
1845
+
1846
+ def initialize(**args)
1847
+ update!(**args)
1848
+ end
1849
+
1850
+ # Update properties of this object
1851
+ def update!(**args)
1852
+ @resource_types = args[:resource_types] if args.key?(:resource_types)
1853
+ end
1854
+ end
1855
+
1581
1856
  # Response of asset discovery run
1582
1857
  class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
1583
1858
  include Google::Apis::Core::Hashable
@@ -1603,6 +1878,80 @@ module Google
1603
1878
  end
1604
1879
  end
1605
1880
 
1881
+ # Represents an instance of a Security Health Analytics custom module, including
1882
+ # its full module name, display name, enablement state, and last updated time.
1883
+ # You can create a custom module at the organization, folder, or project level.
1884
+ # Custom modules that you create at the organization or folder level are
1885
+ # inherited by the child folders and projects.
1886
+ class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
1887
+ include Google::Apis::Core::Hashable
1888
+
1889
+ # Output only. If empty, indicates that the custom module was created in the
1890
+ # organization, folder, or project in which you are viewing the custom module.
1891
+ # Otherwise, `ancestor_module` specifies the organization or folder from which
1892
+ # the custom module is inherited.
1893
+ # Corresponds to the JSON property `ancestorModule`
1894
+ # @return [String]
1895
+ attr_accessor :ancestor_module
1896
+
1897
+ # Defines the properties in a custom module configuration for Security Health
1898
+ # Analytics. Use the custom module configuration to create custom detectors that
1899
+ # generate custom findings for resources that you specify.
1900
+ # Corresponds to the JSON property `customConfig`
1901
+ # @return [Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig]
1902
+ attr_accessor :custom_config
1903
+
1904
+ # The display name of the Security Health Analytics custom module. This display
1905
+ # name becomes the finding category for all findings that are returned by this
1906
+ # custom module. The display name must be between 1 and 128 characters, start
1907
+ # with a lowercase letter, and contain alphanumeric characters or underscores
1908
+ # only.
1909
+ # Corresponds to the JSON property `displayName`
1910
+ # @return [String]
1911
+ attr_accessor :display_name
1912
+
1913
+ # The enablement state of the custom module.
1914
+ # Corresponds to the JSON property `enablementState`
1915
+ # @return [String]
1916
+ attr_accessor :enablement_state
1917
+
1918
+ # Output only. The editor that last updated the custom module.
1919
+ # Corresponds to the JSON property `lastEditor`
1920
+ # @return [String]
1921
+ attr_accessor :last_editor
1922
+
1923
+ # Immutable. The resource name of the custom module. Its format is "
1924
+ # organizations/`organization`/securityHealthAnalyticsSettings/customModules/`
1925
+ # customModule`", or "folders/`folder`/securityHealthAnalyticsSettings/
1926
+ # customModules/`customModule`", or "projects/`project`/
1927
+ # securityHealthAnalyticsSettings/customModules/`customModule`" The id `
1928
+ # customModule` is server-generated and is not user settable. It will be a
1929
+ # numeric id containing 1-20 digits.
1930
+ # Corresponds to the JSON property `name`
1931
+ # @return [String]
1932
+ attr_accessor :name
1933
+
1934
+ # Output only. The time at which the custom module was last updated.
1935
+ # Corresponds to the JSON property `updateTime`
1936
+ # @return [String]
1937
+ attr_accessor :update_time
1938
+
1939
+ def initialize(**args)
1940
+ update!(**args)
1941
+ end
1942
+
1943
+ # Update properties of this object
1944
+ def update!(**args)
1945
+ @ancestor_module = args[:ancestor_module] if args.key?(:ancestor_module)
1946
+ @custom_config = args[:custom_config] if args.key?(:custom_config)
1947
+ @display_name = args[:display_name] if args.key?(:display_name)
1948
+ @enablement_state = args[:enablement_state] if args.key?(:enablement_state)
1949
+ @last_editor = args[:last_editor] if args.key?(:last_editor)
1950
+ @name = args[:name] if args.key?(:name)
1951
+ @update_time = args[:update_time] if args.key?(:update_time)
1952
+ end
1953
+ end
1954
+
1606
1955
  # Response of asset discovery run
1607
1956
  class GoogleCloudSecuritycenterV1beta1RunAssetDiscoveryResponse
1608
1957
  include Google::Apis::Core::Hashable
@@ -1938,8 +2287,8 @@ module Google
1938
2287
  # @return [String]
1939
2288
  attr_accessor :action
1940
2289
 
1941
- # A single identity requesting access for a Cloud Platform resource, e.g. "foo@
1942
- # google.com".
2290
+ # A single identity requesting access for a Cloud Platform resource, for example,
2291
+ # "foo@google.com".
1943
2292
  # Corresponds to the JSON property `member`
1944
2293
  # @return [String]
1945
2294
  attr_accessor :member
@@ -2008,60 +2357,60 @@ module Google
2008
2357
  class KernelRootkit
2009
2358
  include Google::Apis::Core::Hashable
2010
2359
 
2011
- # Rootkit name when available.
2360
+ # Rootkit name, when available.
2012
2361
  # Corresponds to the JSON property `name`
2013
2362
  # @return [String]
2014
2363
  attr_accessor :name
2015
2364
 
2016
- # True when unexpected modifications of kernel code memory are present.
2365
+ # True if unexpected modifications of kernel code memory are present.
2017
2366
  # Corresponds to the JSON property `unexpectedCodeModification`
2018
2367
  # @return [Boolean]
2019
2368
  attr_accessor :unexpected_code_modification
2020
2369
  alias_method :unexpected_code_modification?, :unexpected_code_modification
2021
2370
 
2022
- # True when `ftrace` points are present with callbacks pointing to regions that
2371
+ # True if `ftrace` points are present with callbacks pointing to regions that
2023
2372
  # are not in the expected kernel or module code range.
2024
2373
  # Corresponds to the JSON property `unexpectedFtraceHandler`
2025
2374
  # @return [Boolean]
2026
2375
  attr_accessor :unexpected_ftrace_handler
2027
2376
  alias_method :unexpected_ftrace_handler?, :unexpected_ftrace_handler
2028
2377
 
2029
- # True when interrupt handlers that are are not in the expected kernel or module
2378
+ # True if interrupt handlers that are are not in the expected kernel or module
2030
2379
  # code regions are present.
2031
2380
  # Corresponds to the JSON property `unexpectedInterruptHandler`
2032
2381
  # @return [Boolean]
2033
2382
  attr_accessor :unexpected_interrupt_handler
2034
2383
  alias_method :unexpected_interrupt_handler?, :unexpected_interrupt_handler
2035
2384
 
2036
- # True when kernel code pages that are not in the expected kernel or module code
2385
+ # True if kernel code pages that are not in the expected kernel or module code
2037
2386
  # regions are present.
2038
2387
  # Corresponds to the JSON property `unexpectedKernelCodePages`
2039
2388
  # @return [Boolean]
2040
2389
  attr_accessor :unexpected_kernel_code_pages
2041
2390
  alias_method :unexpected_kernel_code_pages?, :unexpected_kernel_code_pages
2042
2391
 
2043
- # True when `kprobe` points are present with callbacks pointing to regions that
2392
+ # True if `kprobe` points are present with callbacks pointing to regions that
2044
2393
  # are not in the expected kernel or module code range.
2045
2394
  # Corresponds to the JSON property `unexpectedKprobeHandler`
2046
2395
  # @return [Boolean]
2047
2396
  attr_accessor :unexpected_kprobe_handler
2048
2397
  alias_method :unexpected_kprobe_handler?, :unexpected_kprobe_handler
2049
2398
 
2050
- # True when unexpected processes in the scheduler run queue are present. Such
2399
+ # True if unexpected processes in the scheduler run queue are present. Such
2051
2400
  # processes are in the run queue, but not in the process task list.
2052
2401
  # Corresponds to the JSON property `unexpectedProcessesInRunqueue`
2053
2402
  # @return [Boolean]
2054
2403
  attr_accessor :unexpected_processes_in_runqueue
2055
2404
  alias_method :unexpected_processes_in_runqueue?, :unexpected_processes_in_runqueue
2056
2405
 
2057
- # True when unexpected modifications of kernel read-only data memory are present.
2406
+ # True if unexpected modifications of kernel read-only data memory are present.
2058
2407
  # Corresponds to the JSON property `unexpectedReadOnlyDataModification`
2059
2408
  # @return [Boolean]
2060
2409
  attr_accessor :unexpected_read_only_data_modification
2061
2410
  alias_method :unexpected_read_only_data_modification?, :unexpected_read_only_data_modification
2062
2411
 
2063
- # True when system call handlers that are are not in the expected kernel or
2064
- # module code regions are present.
2412
+ # True if system call handlers that are are not in the expected kernel or module
2413
+ # code regions are present.
2065
2414
  # Corresponds to the JSON property `unexpectedSystemCallHandler`
2066
2415
  # @return [Boolean]
2067
2416
  attr_accessor :unexpected_system_call_handler
@@ -2089,37 +2438,42 @@ module Google
2089
2438
  class Kubernetes
2090
2439
  include Google::Apis::Core::Hashable
2091
2440
 
2092
- # Provides information on any Kubernetes access reviews (i.e. privilege checks)
2441
+ # Provides information on any Kubernetes access reviews (privilege checks)
2093
2442
  # relevant to the finding.
2094
2443
  # Corresponds to the JSON property `accessReviews`
2095
2444
  # @return [Array<Google::Apis::SecuritycenterV1beta2::AccessReview>]
2096
2445
  attr_accessor :access_reviews
2097
2446
 
2098
- # Provides Kubernetes role binding information for findings that involve
2099
- # RoleBindings or ClusterRoleBindings.
2447
+ # Provides Kubernetes role binding information for findings that involve [
2448
+ # RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-
2449
+ # engine/docs/how-to/role-based-access-control).
2100
2450
  # Corresponds to the JSON property `bindings`
2101
2451
  # @return [Array<Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1Binding>]
2102
2452
  attr_accessor :bindings
2103
2453
 
2104
- # GKE Node Pools associated with the finding. This field will contain NodePool
2105
- # information for each Node, when it is available.
2454
+ # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-
2455
+ # pools) associated with the finding. This field contains node pool information
2456
+ # for each node, when it is available.
2106
2457
  # Corresponds to the JSON property `nodePools`
2107
2458
  # @return [Array<Google::Apis::SecuritycenterV1beta2::NodePool>]
2108
2459
  attr_accessor :node_pools
2109
2460
 
2110
- # Provides Kubernetes Node information.
2461
+ # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/
2462
+ # concepts/cluster-architecture#nodes) information.
2111
2463
  # Corresponds to the JSON property `nodes`
2112
2464
  # @return [Array<Google::Apis::SecuritycenterV1beta2::Node>]
2113
2465
  attr_accessor :nodes
2114
2466
 
2115
- # Kubernetes Pods associated with the finding. This field will contain Pod
2116
- # records for each container that is owned by a Pod.
2467
+ # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod)
2468
+ # associated with the finding. This field contains Pod records for each
2469
+ # container that is owned by a Pod.
2117
2470
  # Corresponds to the JSON property `pods`
2118
2471
  # @return [Array<Google::Apis::SecuritycenterV1beta2::Pod>]
2119
2472
  attr_accessor :pods
2120
2473
 
2121
- # Provides Kubernetes role information for findings that involve Roles or
2122
- # ClusterRoles.
2474
+ # Provides Kubernetes role information for findings that involve [Roles or
2475
+ # ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-
2476
+ # based-access-control).
2123
2477
  # Corresponds to the JSON property `roles`
2124
2478
  # @return [Array<Google::Apis::SecuritycenterV1beta2::Role>]
2125
2479
  attr_accessor :roles
@@ -2139,17 +2493,20 @@ module Google
2139
2493
  end
2140
2494
  end
2141
2495
 
2142
- # Label represents a generic name=value label. Label has separate name and value
2143
- # fields to support filtering with contains().
2496
+ # Represents a generic name-value label. A label has separate name and value
2497
+ # fields to support filtering with the `contains()` function. For more
2498
+ # information, see [Filtering on array-type fields](https://cloud.google.com/
2499
+ # security-command-center/docs/how-to-api-list-findings#array-contains-filtering)
2500
+ # .
2144
2501
  class Label
2145
2502
  include Google::Apis::Core::Hashable
2146
2503
 
2147
- # Label name.
2504
+ # Name of the label.
2148
2505
  # Corresponds to the JSON property `name`
2149
2506
  # @return [String]
2150
2507
  attr_accessor :name
2151
2508
 
2152
- # Label value.
2509
+ # Value that corresponds to the label's name.
2153
2510
  # Corresponds to the JSON property `value`
2154
2511
  # @return [String]
2155
2512
  attr_accessor :value
@@ -2240,11 +2597,12 @@ module Google
2240
2597
  end
2241
2598
  end
2242
2599
 
2243
- # Kubernetes Nodes associated with the finding.
2600
+ # Kubernetes nodes associated with the finding.
2244
2601
  class Node
2245
2602
  include Google::Apis::Core::Hashable
2246
2603
 
2247
- # Full Resource name of the Compute Engine VM running the cluster node.
2604
+ # [Full resource name](https://google.aip.dev/122#full-resource-names) of the
2605
+ # Compute Engine VM running the cluster node.
2248
2606
  # Corresponds to the JSON property `name`
2249
2607
  # @return [String]
2250
2608
  attr_accessor :name
@@ -2259,11 +2617,11 @@ module Google
2259
2617
  end
2260
2618
  end
2261
2619
 
2262
- # Provides GKE Node Pool information.
2620
+ # Provides GKE node pool information.
2263
2621
  class NodePool
2264
2622
  include Google::Apis::Core::Hashable
2265
2623
 
2266
- # Kubernetes Node pool name.
2624
+ # Kubernetes node pool name.
2267
2625
  # Corresponds to the JSON property `name`
2268
2626
  # @return [String]
2269
2627
  attr_accessor :name
@@ -2312,7 +2670,7 @@ module Google
2312
2670
  end
2313
2671
  end
2314
2672
 
2315
- # Kubernetes Pod.
2673
+ # A Kubernetes Pod.
2316
2674
  class Pod
2317
2675
  include Google::Apis::Core::Hashable
2318
2676
 
@@ -2386,18 +2744,18 @@ module Google
2386
2744
  # @return [Array<Google::Apis::SecuritycenterV1beta2::File>]
2387
2745
  attr_accessor :libraries
2388
2746
 
2389
- # The process name visible in utilities like `top` and `ps`; it can be accessed
2390
- # via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
2747
+ # The process name, as displayed in utilities like `top` and `ps`. This name can
2748
+ # be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
2391
2749
  # Corresponds to the JSON property `name`
2392
2750
  # @return [String]
2393
2751
  attr_accessor :name
2394
2752
 
2395
- # The parent process id.
2753
+ # The parent process ID.
2396
2754
  # Corresponds to the JSON property `parentPid`
2397
2755
  # @return [Fixnum]
2398
2756
  attr_accessor :parent_pid
2399
2757
 
2400
- # The process id.
2758
+ # The process ID.
2401
2759
  # Corresponds to the JSON property `pid`
2402
2760
  # @return [Fixnum]
2403
2761
  attr_accessor :pid
@@ -2724,21 +3082,21 @@ module Google
2724
3082
  end
2725
3083
  end
2726
3084
 
2727
- # Represents a Kubernetes Subject.
3085
+ # Represents a Kubernetes subject.
2728
3086
  class Subject
2729
3087
  include Google::Apis::Core::Hashable
2730
3088
 
2731
- # Authentication type for subject.
3089
+ # Authentication type for the subject.
2732
3090
  # Corresponds to the JSON property `kind`
2733
3091
  # @return [String]
2734
3092
  attr_accessor :kind
2735
3093
 
2736
- # Name for subject.
3094
+ # Name for the subject.
2737
3095
  # Corresponds to the JSON property `name`
2738
3096
  # @return [String]
2739
3097
  attr_accessor :name
2740
3098
 
2741
- # Namespace for subject.
3099
+ # Namespace for the subject.
2742
3100
  # Corresponds to the JSON property `ns`
2743
3101
  # @return [String]
2744
3102
  attr_accessor :ns
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SecuritycenterV1beta2
18
18
  # Version of the google-apis-securitycenter_v1beta2 gem
19
- GEM_VERSION = "0.46.0"
19
+ GEM_VERSION = "0.48.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.12.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20230329"
25
+ REVISION = "20230420"
26
26
  end
27
27
  end
28
28
  end
@@ -142,6 +142,12 @@ module Google
142
142
  include Google::Apis::Core::JsonObjectSupport
143
143
  end
144
144
 
145
+ class Expr
146
+ class Representation < Google::Apis::Core::JsonRepresentation; end
147
+
148
+ include Google::Apis::Core::JsonObjectSupport
149
+ end
150
+
145
151
  class File
146
152
  class Representation < Google::Apis::Core::JsonRepresentation; end
147
153
 
@@ -184,6 +190,24 @@ module Google
184
190
  include Google::Apis::Core::JsonObjectSupport
185
191
  end
186
192
 
193
+ class GoogleCloudSecuritycenterV1CustomConfig
194
+ class Representation < Google::Apis::Core::JsonRepresentation; end
195
+
196
+ include Google::Apis::Core::JsonObjectSupport
197
+ end
198
+
199
+ class GoogleCloudSecuritycenterV1CustomOutputSpec
200
+ class Representation < Google::Apis::Core::JsonRepresentation; end
201
+
202
+ include Google::Apis::Core::JsonObjectSupport
203
+ end
204
+
205
+ class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
206
+ class Representation < Google::Apis::Core::JsonRepresentation; end
207
+
208
+ include Google::Apis::Core::JsonObjectSupport
209
+ end
210
+
187
211
  class GoogleCloudSecuritycenterV1ExternalSystem
188
212
  class Representation < Google::Apis::Core::JsonRepresentation; end
189
213
 
@@ -202,18 +226,36 @@ module Google
202
226
  include Google::Apis::Core::JsonObjectSupport
203
227
  end
204
228
 
229
+ class GoogleCloudSecuritycenterV1Property
230
+ class Representation < Google::Apis::Core::JsonRepresentation; end
231
+
232
+ include Google::Apis::Core::JsonObjectSupport
233
+ end
234
+
205
235
  class GoogleCloudSecuritycenterV1Resource
206
236
  class Representation < Google::Apis::Core::JsonRepresentation; end
207
237
 
208
238
  include Google::Apis::Core::JsonObjectSupport
209
239
  end
210
240
 
241
+ class GoogleCloudSecuritycenterV1ResourceSelector
242
+ class Representation < Google::Apis::Core::JsonRepresentation; end
243
+
244
+ include Google::Apis::Core::JsonObjectSupport
245
+ end
246
+
211
247
  class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
212
248
  class Representation < Google::Apis::Core::JsonRepresentation; end
213
249
 
214
250
  include Google::Apis::Core::JsonObjectSupport
215
251
  end
216
252
 
253
+ class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
254
+ class Representation < Google::Apis::Core::JsonRepresentation; end
255
+
256
+ include Google::Apis::Core::JsonObjectSupport
257
+ end
258
+
217
259
  class GoogleCloudSecuritycenterV1beta1RunAssetDiscoveryResponse
218
260
  class Representation < Google::Apis::Core::JsonRepresentation; end
219
261
 
@@ -618,6 +660,16 @@ module Google
618
660
  end
619
661
  end
620
662
 
663
+ class Expr
664
+ # @private
665
+ class Representation < Google::Apis::Core::JsonRepresentation
666
+ property :description, as: 'description'
667
+ property :expression, as: 'expression'
668
+ property :location, as: 'location'
669
+ property :title, as: 'title'
670
+ end
671
+ end
672
+
621
673
  class File
622
674
  # @private
623
675
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -740,6 +792,40 @@ module Google
740
792
  end
741
793
  end
742
794
 
795
+ class GoogleCloudSecuritycenterV1CustomConfig
796
+ # @private
797
+ class Representation < Google::Apis::Core::JsonRepresentation
798
+ property :custom_output, as: 'customOutput', class: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomOutputSpec, decorator: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomOutputSpec::Representation
799
+
800
+ property :description, as: 'description'
801
+ property :predicate, as: 'predicate', class: Google::Apis::SecuritycenterV1beta2::Expr, decorator: Google::Apis::SecuritycenterV1beta2::Expr::Representation
802
+
803
+ property :recommendation, as: 'recommendation'
804
+ property :resource_selector, as: 'resourceSelector', class: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1ResourceSelector, decorator: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1ResourceSelector::Representation
805
+
806
+ property :severity, as: 'severity'
807
+ end
808
+ end
809
+
810
+ class GoogleCloudSecuritycenterV1CustomOutputSpec
811
+ # @private
812
+ class Representation < Google::Apis::Core::JsonRepresentation
813
+ collection :properties, as: 'properties', class: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1Property, decorator: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1Property::Representation
814
+
815
+ end
816
+ end
817
+
818
+ class GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
819
+ # @private
820
+ class Representation < Google::Apis::Core::JsonRepresentation
821
+ property :custom_config, as: 'customConfig', class: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig, decorator: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig::Representation
822
+
823
+ property :display_name, as: 'displayName'
824
+ property :enablement_state, as: 'enablementState'
825
+ property :name, as: 'name'
826
+ end
827
+ end
828
+
743
829
  class GoogleCloudSecuritycenterV1ExternalSystem
744
830
  # @private
745
831
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -775,6 +861,15 @@ module Google
775
861
  end
776
862
  end
777
863
 
864
+ class GoogleCloudSecuritycenterV1Property
865
+ # @private
866
+ class Representation < Google::Apis::Core::JsonRepresentation
867
+ property :name, as: 'name'
868
+ property :value_expression, as: 'valueExpression', class: Google::Apis::SecuritycenterV1beta2::Expr, decorator: Google::Apis::SecuritycenterV1beta2::Expr::Representation
869
+
870
+ end
871
+ end
872
+
778
873
  class GoogleCloudSecuritycenterV1Resource
779
874
  # @private
780
875
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -790,6 +885,13 @@ module Google
790
885
  end
791
886
  end
792
887
 
888
+ class GoogleCloudSecuritycenterV1ResourceSelector
889
+ # @private
890
+ class Representation < Google::Apis::Core::JsonRepresentation
891
+ collection :resource_types, as: 'resourceTypes'
892
+ end
893
+ end
894
+
793
895
  class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
794
896
  # @private
795
897
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -798,6 +900,20 @@ module Google
798
900
  end
799
901
  end
800
902
 
903
+ class GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
904
+ # @private
905
+ class Representation < Google::Apis::Core::JsonRepresentation
906
+ property :ancestor_module, as: 'ancestorModule'
907
+ property :custom_config, as: 'customConfig', class: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig, decorator: Google::Apis::SecuritycenterV1beta2::GoogleCloudSecuritycenterV1CustomConfig::Representation
908
+
909
+ property :display_name, as: 'displayName'
910
+ property :enablement_state, as: 'enablementState'
911
+ property :last_editor, as: 'lastEditor'
912
+ property :name, as: 'name'
913
+ property :update_time, as: 'updateTime'
914
+ end
915
+ end
916
+
801
917
  class GoogleCloudSecuritycenterV1beta1RunAssetDiscoveryResponse
802
918
  # @private
803
919
  class Representation < Google::Apis::Core::JsonRepresentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-securitycenter_v1beta2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.46.0
4
+ version: 0.48.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-04-02 00:00:00.000000000 Z
11
+ date: 2023-04-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1beta2/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1beta2/v0.46.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1beta2/v0.48.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1beta2
63
63
  post_install_message:
64
64
  rdoc_options: []