google-apis-securitycenter_v1 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3380182fcfed60222e1fc284e8ba844a0a6745706fe5c2ae9b54413d8d2b07c3
-  data.tar.gz: 011b8118b144e38caf8220bfbce0822e8868f599358a2bc01b00ac731124adbe
+  metadata.gz: b496f1d85054d5421118f0a2124e127b90e4736382ead725713367dc4fc5cc70
+  data.tar.gz: 835521abd6edd0d15aba5c7307ba748466e1f7f487064aee5da94084a3faa7ee
 SHA512:
-  metadata.gz: 9745c0ab9e69f0b1453082e054c601c26925c5a77e4d5546ecf3a0bcf4a8824715f543a37c711c108ec9d27e1d4415af50753ef6099229312ae166d258627a06
-  data.tar.gz: acd636b17f828ac2a81b3e5dd0bf2f0af56704529309a6ff1ac92c6fd7607d2c25f2450cde06219ec9afcf55a338e959afe104f7082d959763a784ee88fc4a1a
+  metadata.gz: d53eaf7e8dba0c534e9853798879cd177f3234a60f2bef9ad4f2223330027d598bb3c6ee8d92390fd4d3bbd114e89537f8b2882bb8102fc9a9b826ecd12732c1
+  data.tar.gz: 713dfd074c33bbb6c6eee4edcc26b63c2fdbdc67fc717aa984b2ef89a55ad45b41053c45785448f3ecfe170067265f71665728be0eb557eafddee36df2ba2866

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-securitycenter_v1
 
+### v0.56.0 (2023-04-30)
+
+* Regenerated from discovery document revision 20230420
+
+### v0.55.0 (2023-04-23)
+
+* Regenerated from discovery document revision 20230414
+
 ### v0.54.0 (2023-04-16)
 
 * Regenerated from discovery document revision 20230410

data/lib/google/apis/securitycenter_v1/classes.rb

@@ -42,39 +42,41 @@ module Google
         attr_accessor :method_name
       
         # Associated email, such as "foo@google.com". The email address of the
-        # authenticated user (or service account on behalf of third party principal)
-        # making the request. For third party identity callers, the `principal_subject`
-        # field is populated instead of this field. For privacy reasons, the principal
-        # email address is sometimes redacted. For more information, see [Caller
-        # identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).
+        # authenticated user or a service account acting on behalf of a third party
+        # principal making the request. For third party identity callers, the `
+        # principal_subject` field is populated instead of this field. For privacy
+        # reasons, the principal email address is sometimes redacted. For more
+        # information, see [Caller identities in audit logs](https://cloud.google.com/
+        # logging/docs/audit#user-id).
         # Corresponds to the JSON property `principalEmail`
         # @return [String]
         attr_accessor :principal_email
       
-        # A string representing the principal_subject associated with the identity. As
-        # compared to `principal_email`, supports principals that aren't associated with
-        # email addresses, such as third party principals. For most identities, the
-        # format will be `principal://iam.googleapis.com/`identity pool name`/subjects/`
-        # subject`` except for some GKE identities (GKE_WORKLOAD, FREEFORM,
-        # GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:`
-        # identity pool name`[`subject`]`
+        # A string that represents the principal_subject that is associated with the
+        # identity. Unlike `principal_email`, `principal_subject` supports principals
+        # that aren't associated with email addresses, such as third party principals.
+        # For most identities, the format is `principal://iam.googleapis.com/`identity
+        # pool name`/subject/`subject``. Some GKE identities, such as GKE_WORKLOAD,
+        # FREEFORM, and GKE_HUB_WORKLOAD, still use the legacy format `serviceAccount:`
+        # identity pool name`[`subject`]`.
         # Corresponds to the JSON property `principalSubject`
         # @return [String]
         attr_accessor :principal_subject
       
-        # Identity delegation history of an authenticated service account that makes the
-        # request. It contains information on the real authorities that try to access
-        # GCP resources by delegating on a service account. When multiple authorities
-        # are present, they are guaranteed to be sorted based on the original ordering
-        # of the identity delegation events.
+        # The identity delegation history of an authenticated service account that made
+        # the request. The `serviceAccountDelegationInfo[]` object contains information
+        # about the real authorities that try to access Google Cloud resources by
+        # delegating on a service account. When multiple authorities are present, they
+        # are guaranteed to be sorted based on the original ordering of the identity
+        # delegation events.
         # Corresponds to the JSON property `serviceAccountDelegationInfo`
         # @return [Array<Google::Apis::SecuritycenterV1::ServiceAccountDelegationInfo>]
         attr_accessor :service_account_delegation_info
       
-        # The name of the service account key used to create or exchange credentials for
-        # authenticating the service account making the request. This is a scheme-less
-        # URI full resource name. For example: "//iam.googleapis.com/projects/`
-        # PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key`"
+        # The name of the service account key that was used to create or exchange
+        # credentials when authenticating the service account that made the request.
+        # This is a scheme-less URI full resource name. For example: "//iam.googleapis.
+        # com/projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/`key`".
         # Corresponds to the JSON property `serviceAccountKeyName`
         # @return [String]
         attr_accessor :service_account_key_name
@@ -85,18 +87,16 @@ module Google
         # @return [String]
         attr_accessor :service_name
       
-        # What kind of user agent is associated, for example operating system shells,
-        # embedded or stand-alone applications, etc.
+        # Type of user agent associated with the finding. For example, an operating
+        # system shell or an embedded or standalone application.
         # Corresponds to the JSON property `userAgentFamily`
         # @return [String]
         attr_accessor :user_agent_family
       
-        # A string that represents the username of a user, user account, or other entity
-        # involved in the access event. What the entity is and what its role in the
-        # access event is depends on the finding that this field appears in. The entity
-        # is likely not an IAM principal, but could be a user that is logged into an
-        # operating system, if the finding is VM-related, or a user that is logged into
-        # some type of application that is involved in the access event.
+        # A string that represents a username. The username provided depends on the type
+        # of the finding and is likely not an IAM principal. For example, this can be a
+        # system username if the finding is related to a virtual machine, or it can be
+        # an application login username.
         # Corresponds to the JSON property `userName`
         # @return [String]
         attr_accessor :user_name
@@ -120,17 +120,19 @@ module Google
         end
       end
       
-      # Conveys information about a Kubernetes access review (e.g. kubectl auth can-i .
-      # ..) that was involved in a finding.
+      # Conveys information about a Kubernetes access review (such as one returned by
+      # a [`kubectl auth can-i`](https://kubernetes.io/docs/reference/access-authn-
+      # authz/authorization/#checking-api-access) command) that was involved in a
+      # finding.
       class AccessReview
         include Google::Apis::Core::Hashable
       
-        # Group is the API Group of the Resource. "*" means all.
+        # The API group of the resource. "*" means all.
         # Corresponds to the JSON property `group`
         # @return [String]
         attr_accessor :group
       
-        # Name is the name of the resource being requested. Empty means all.
+        # The name of the resource being requested. Empty means all.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -141,23 +143,23 @@ module Google
         # @return [String]
         attr_accessor :ns
       
-        # Resource is the optional resource type requested. "*" means all.
+        # The optional resource type requested. "*" means all.
         # Corresponds to the JSON property `resource`
         # @return [String]
         attr_accessor :resource
       
-        # Subresource is the optional subresource type.
+        # The optional subresource type.
         # Corresponds to the JSON property `subresource`
         # @return [String]
         attr_accessor :subresource
       
-        # Verb is a Kubernetes resource API verb, like: get, list, watch, create, update,
-        # delete, proxy. "*" means all.
+        # A Kubernetes resource API verb, like get, list, watch, create, update, delete,
+        # proxy. "*" means all.
         # Corresponds to the JSON property `verb`
         # @return [String]
         attr_accessor :verb
       
-        # Version is the API Version of the Resource. "*" means all.
+        # The API version of the resource. "*" means all.
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -503,8 +505,8 @@ module Google
         attr_accessor :full_scan
         alias_method :full_scan?, :full_scan
       
-        # The [type of information](https://cloud.google.com/dlp/docs/infotypes-
-        # reference) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
+        # The type of information (or *[infoType](https://cloud.google.com/dlp/docs/
+        # infotypes-reference)*) found, for example, `EMAIL_ADDRESS` or `STREET_ADDRESS`.
         # Corresponds to the JSON property `infoType`
         # @return [String]
         attr_accessor :info_type
@@ -538,18 +540,17 @@ module Google
       class Compliance
         include Google::Apis::Core::Hashable
       
-        # Policies within the standard/benchmark e.g. A.12.4.1
+        # Policies within the standard or benchmark, for example, A.12.4.1
         # Corresponds to the JSON property `ids`
         # @return [Array<String>]
         attr_accessor :ids
       
-        # Refers to industry wide standards or benchmarks e.g. "cis", "pci", "owasp",
-        # etc.
+        # Industry-wide compliance standards or benchmarks, such as CIS, PCI, and OWASP.
         # Corresponds to the JSON property `standard`
         # @return [String]
         attr_accessor :standard
       
-        # Version of the standard/benchmark e.g. 1.1
+        # Version of the standard or benchmark, for example, 1.1
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -629,7 +630,7 @@ module Google
         end
       end
       
-      # The details pertaining to specific contacts
+      # Details about specific contacts
       class ContactDetails
         include Google::Apis::Core::Hashable
       
@@ -652,7 +653,7 @@ module Google
       class Container
         include Google::Apis::Core::Hashable
       
-        # Optional container image id, when provided by the container runtime. Uniquely
+        # Optional container image ID, if provided by the container runtime. Uniquely
         # identifies the container image launched using a container image digest.
         # Corresponds to the JSON property `imageId`
         # @return [String]
@@ -663,13 +664,13 @@ module Google
         # @return [Array<Google::Apis::SecuritycenterV1::Label>]
         attr_accessor :labels
       
-        # Container name.
+        # Name of the container.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Container image URI provided when configuring a pod/container. May identify a
-        # container image version using mutable tags.
+        # Container image URI provided when configuring a pod or container. This string
+        # can identify a container image version using mutable tags.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -805,38 +806,43 @@ module Google
       end
       
       # Represents database access information, such as queries. A database may be a
-      # sub-resource of an instance (as in the case of CloudSQL instances or Cloud
+      # sub-resource of an instance (as in the case of Cloud SQL instances or Cloud
       # Spanner instances), or the database instance itself. Some database resources
-      # may not have the full resource name populated because these resource types are
-      # not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these
-      # cases only the display name will be provided.
+      # might not have the [full resource name](https://google.aip.dev/122#full-
+      # resource-names) populated because these resource types, such as Cloud SQL
+      # databases, are not yet supported by Cloud Asset Inventory. In these cases only
+      # the display name is provided. Some database resources may not have the [full
+      # resource name](https://google.aip.dev/122#full-resource-names) populated
+      # because these resource types are not yet supported by Cloud Asset Inventory (e.
+      # g. Cloud SQL databases). In these cases only the display name will be provided.
       class Database
         include Google::Apis::Core::Hashable
       
-        # The human readable name of the database the user connected to.
+        # The human-readable name of the database that the user connected to.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The target usernames/roles/groups of a SQL privilege grant (not an IAM policy
-        # change).
+        # The target usernames, roles, or groups of an SQL privilege grant, which is not
+        # an IAM policy change.
         # Corresponds to the JSON property `grantees`
         # @return [Array<String>]
         attr_accessor :grantees
       
-        # The full resource name of the database the user connected to, if it is
-        # supported by CAI. (https://google.aip.dev/122#full-resource-names)
+        # The [full resource name](https://google.aip.dev/122#full-resource-names) of
+        # the database that the user connected to, if it is supported by Cloud Asset
+        # Inventory.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The SQL statement associated with the relevant access.
+        # The SQL statement that is associated with the database access.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
       
-        # The username used to connect to the DB. This may not necessarily be an IAM
-        # principal, and has no required format.
+        # The username used to connect to the database. The username might not be an IAM
+        # principal and does not have a set format.
         # Corresponds to the JSON property `userName`
         # @return [String]
         attr_accessor :user_name
@@ -896,8 +902,8 @@ module Google
         end
       end
       
-      # EnvironmentVariable is a name-value pair to store environment variables for
-      # Process.
+      # A name-value pair representing an environment variable used in an operating
+      # system process.
       class EnvironmentVariable
         include Google::Apis::Core::Hashable
       
@@ -922,19 +928,20 @@ module Google
         end
       end
       
-      # Resource that has been exfiltrated or exfiltrated_to.
+      # Resource where data was exfiltrated from or exfiltrated to.
       class ExfilResource
         include Google::Apis::Core::Hashable
       
-        # Subcomponents of the asset that is exfiltrated - these could be URIs used
-        # during exfiltration, table names, databases, filenames, etc. For example,
-        # multiple tables may be exfiltrated from the same CloudSQL instance, or
-        # multiple files from the same Cloud Storage bucket.
+        # Subcomponents of the asset that was exfiltrated, like URIs used during
+        # exfiltration, table names, databases, and filenames. For example, multiple
+        # tables might have been exfiltrated from the same Cloud SQL instance, or
+        # multiple files might have been exfiltrated from the same Cloud Storage bucket.
         # Corresponds to the JSON property `components`
         # @return [Array<String>]
         attr_accessor :components
       
-        # Resource's URI (https://google.aip.dev/122#full-resource-names)
+        # The resource's [full resource name](https://cloud.google.com/apis/design/
+        # resource_names#full_resource_name).
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -950,9 +957,10 @@ module Google
         end
       end
       
-      # Exfiltration represents a data exfiltration attempt of one or more sources to
-      # one or more targets. Sources represent the source of data that is exfiltrated,
-      # and Targets represents the destination the data was copied to.
+      # Exfiltration represents a data exfiltration attempt from one or more sources
+      # to one or more targets. The `sources` attribute lists the sources of the
+      # exfiltrated data. The `targets` attribute lists the destinations the data was
+      # copied to.
       class Exfiltration
         include Google::Apis::Core::Hashable
       
@@ -1039,8 +1047,7 @@ module Google
       class File
         include Google::Apis::Core::Hashable
       
-        # Prefix of the file contents as a JSON encoded string. (Currently only
-        # populated for Malicious Script Executed findings.)
+        # Prefix of the file contents as a JSON-encoded string.
         # Corresponds to the JSON property `contents`
         # @return [String]
         attr_accessor :contents
@@ -1150,7 +1157,7 @@ module Google
         # @return [Hash<String,Google::Apis::SecuritycenterV1::ContactDetails>]
         attr_accessor :contacts
       
-        # Containers associated with the finding. containers provides information for
+        # Containers associated with the finding. This field provides information for
         # both Kubernetes and non-Kubernetes containers.
         # Corresponds to the JSON property `containers`
         # @return [Array<Google::Apis::SecuritycenterV1::Container>]
@@ -1162,16 +1169,20 @@ module Google
         attr_accessor :create_time
       
         # Represents database access information, such as queries. A database may be a
-        # sub-resource of an instance (as in the case of CloudSQL instances or Cloud
+        # sub-resource of an instance (as in the case of Cloud SQL instances or Cloud
         # Spanner instances), or the database instance itself. Some database resources
-        # may not have the full resource name populated because these resource types are
-        # not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these
-        # cases only the display name will be provided.
+        # might not have the [full resource name](https://google.aip.dev/122#full-
+        # resource-names) populated because these resource types, such as Cloud SQL
+        # databases, are not yet supported by Cloud Asset Inventory. In these cases only
+        # the display name is provided. Some database resources may not have the [full
+        # resource name](https://google.aip.dev/122#full-resource-names) populated
+        # because these resource types are not yet supported by Cloud Asset Inventory (e.
+        # g. Cloud SQL databases). In these cases only the display name will be provided.
         # Corresponds to the JSON property `database`
         # @return [Google::Apis::SecuritycenterV1::Database]
         attr_accessor :database
       
-        # Contains more detail about the finding.
+        # Contains more details about the finding.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -1186,9 +1197,10 @@ module Google
         # @return [String]
         attr_accessor :event_time
       
-        # Exfiltration represents a data exfiltration attempt of one or more sources to
-        # one or more targets. Sources represent the source of data that is exfiltrated,
-        # and Targets represents the destination the data was copied to.
+        # Exfiltration represents a data exfiltration attempt from one or more sources
+        # to one or more targets. The `sources` attribute lists the sources of the
+        # exfiltrated data. The `targets` attribute lists the destinations the data was
+        # copied to.
         # Corresponds to the JSON property `exfiltration`
         # @return [Google::Apis::SecuritycenterV1::Exfiltration]
         attr_accessor :exfiltration
@@ -1216,7 +1228,7 @@ module Google
         # @return [String]
         attr_accessor :finding_class
       
-        # Represents IAM bindings associated with the Finding.
+        # Represents IAM bindings associated with the finding.
         # Corresponds to the JSON property `iamBindings`
         # @return [Array<Google::Apis::SecuritycenterV1::IamBinding>]
         attr_accessor :iam_bindings
@@ -1259,10 +1271,9 @@ module Google
         # @return [String]
         attr_accessor :mute
       
-        # First known as mute_annotation. Records additional information about the mute
-        # operation e.g. mute config that muted the finding, user who muted the finding,
-        # etc. Unlike other attributes of a finding, a finding provider shouldn't set
-        # the value of mute.
+        # Records additional information about the mute operation, for example, the [
+        # mute configuration](/security-command-center/docs/how-to-mute-findings) that
+        # muted the finding and the user who muted the finding.
         # Corresponds to the JSON property `muteInitiator`
         # @return [String]
         attr_accessor :mute_initiator
@@ -1272,14 +1283,16 @@ module Google
         # @return [String]
         attr_accessor :mute_update_time
       
-        # The relative resource name of this finding. See: https://cloud.google.com/apis/
-        # design/resource_names#relative_resource_name Example: "organizations/`
-        # organization_id`/sources/`source_id`/findings/`finding_id`"
+        # The [relative resource name](https://cloud.google.com/apis/design/
+        # resource_names#relative_resource_name) of the finding. Example: "organizations/
+        # `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
+        # folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
+        # sources/`source_id`/findings/`finding_id`".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Next steps associate to the finding.
+        # Steps to address the finding.
         # Corresponds to the JSON property `nextSteps`
         # @return [String]
         attr_accessor :next_steps
@@ -1570,12 +1583,12 @@ module Google
       class GoogleCloudSecuritycenterV1Binding
         include Google::Apis::Core::Hashable
       
-        # Name for binding.
+        # Name for the binding.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Namespace for binding.
+        # Namespace for the binding.
         # Corresponds to the JSON property `ns`
         # @return [String]
         attr_accessor :ns
@@ -2795,8 +2808,8 @@ module Google
         # @return [String]
         attr_accessor :action
       
-        # A single identity requesting access for a Cloud Platform resource, e.g. "foo@
-        # google.com".
+        # A single identity requesting access for a Cloud Platform resource, for example,
+        # "foo@google.com".
         # Corresponds to the JSON property `member`
         # @return [String]
         attr_accessor :member
@@ -2887,60 +2900,60 @@ module Google
       class KernelRootkit
         include Google::Apis::Core::Hashable
       
-        # Rootkit name when available.
+        # Rootkit name, when available.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # True when unexpected modifications of kernel code memory are present.
+        # True if unexpected modifications of kernel code memory are present.
         # Corresponds to the JSON property `unexpectedCodeModification`
         # @return [Boolean]
         attr_accessor :unexpected_code_modification
         alias_method :unexpected_code_modification?, :unexpected_code_modification
       
-        # True when `ftrace` points are present with callbacks pointing to regions that
+        # True if `ftrace` points are present with callbacks pointing to regions that
         # are not in the expected kernel or module code range.
         # Corresponds to the JSON property `unexpectedFtraceHandler`
         # @return [Boolean]
         attr_accessor :unexpected_ftrace_handler
         alias_method :unexpected_ftrace_handler?, :unexpected_ftrace_handler
       
-        # True when interrupt handlers that are are not in the expected kernel or module
+        # True if interrupt handlers that are are not in the expected kernel or module
         # code regions are present.
         # Corresponds to the JSON property `unexpectedInterruptHandler`
         # @return [Boolean]
         attr_accessor :unexpected_interrupt_handler
         alias_method :unexpected_interrupt_handler?, :unexpected_interrupt_handler
       
-        # True when kernel code pages that are not in the expected kernel or module code
+        # True if kernel code pages that are not in the expected kernel or module code
         # regions are present.
         # Corresponds to the JSON property `unexpectedKernelCodePages`
         # @return [Boolean]
         attr_accessor :unexpected_kernel_code_pages
         alias_method :unexpected_kernel_code_pages?, :unexpected_kernel_code_pages
       
-        # True when `kprobe` points are present with callbacks pointing to regions that
+        # True if `kprobe` points are present with callbacks pointing to regions that
         # are not in the expected kernel or module code range.
         # Corresponds to the JSON property `unexpectedKprobeHandler`
         # @return [Boolean]
         attr_accessor :unexpected_kprobe_handler
         alias_method :unexpected_kprobe_handler?, :unexpected_kprobe_handler
       
-        # True when unexpected processes in the scheduler run queue are present. Such
+        # True if unexpected processes in the scheduler run queue are present. Such
         # processes are in the run queue, but not in the process task list.
         # Corresponds to the JSON property `unexpectedProcessesInRunqueue`
         # @return [Boolean]
         attr_accessor :unexpected_processes_in_runqueue
         alias_method :unexpected_processes_in_runqueue?, :unexpected_processes_in_runqueue
       
-        # True when unexpected modifications of kernel read-only data memory are present.
+        # True if unexpected modifications of kernel read-only data memory are present.
         # Corresponds to the JSON property `unexpectedReadOnlyDataModification`
         # @return [Boolean]
         attr_accessor :unexpected_read_only_data_modification
         alias_method :unexpected_read_only_data_modification?, :unexpected_read_only_data_modification
       
-        # True when system call handlers that are are not in the expected kernel or
-        # module code regions are present.
+        # True if system call handlers that are are not in the expected kernel or module
+        # code regions are present.
         # Corresponds to the JSON property `unexpectedSystemCallHandler`
         # @return [Boolean]
         attr_accessor :unexpected_system_call_handler
@@ -2968,37 +2981,42 @@ module Google
       class Kubernetes
         include Google::Apis::Core::Hashable
       
-        # Provides information on any Kubernetes access reviews (i.e. privilege checks)
+        # Provides information on any Kubernetes access reviews (privilege checks)
         # relevant to the finding.
         # Corresponds to the JSON property `accessReviews`
         # @return [Array<Google::Apis::SecuritycenterV1::AccessReview>]
         attr_accessor :access_reviews
       
-        # Provides Kubernetes role binding information for findings that involve
-        # RoleBindings or ClusterRoleBindings.
+        # Provides Kubernetes role binding information for findings that involve [
+        # RoleBindings or ClusterRoleBindings](https://cloud.google.com/kubernetes-
+        # engine/docs/how-to/role-based-access-control).
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1Binding>]
         attr_accessor :bindings
       
-        # GKE Node Pools associated with the finding. This field will contain NodePool
-        # information for each Node, when it is available.
+        # GKE [node pools](https://cloud.google.com/kubernetes-engine/docs/concepts/node-
+        # pools) associated with the finding. This field contains node pool information
+        # for each node, when it is available.
         # Corresponds to the JSON property `nodePools`
         # @return [Array<Google::Apis::SecuritycenterV1::NodePool>]
         attr_accessor :node_pools
       
-        # Provides Kubernetes Node information.
+        # Provides Kubernetes [node](https://cloud.google.com/kubernetes-engine/docs/
+        # concepts/cluster-architecture#nodes) information.
         # Corresponds to the JSON property `nodes`
         # @return [Array<Google::Apis::SecuritycenterV1::Node>]
         attr_accessor :nodes
       
-        # Kubernetes Pods associated with the finding. This field will contain Pod
-        # records for each container that is owned by a Pod.
+        # Kubernetes [Pods](https://cloud.google.com/kubernetes-engine/docs/concepts/pod)
+        # associated with the finding. This field contains Pod records for each
+        # container that is owned by a Pod.
         # Corresponds to the JSON property `pods`
         # @return [Array<Google::Apis::SecuritycenterV1::Pod>]
         attr_accessor :pods
       
-        # Provides Kubernetes role information for findings that involve Roles or
-        # ClusterRoles.
+        # Provides Kubernetes role information for findings that involve [Roles or
+        # ClusterRoles](https://cloud.google.com/kubernetes-engine/docs/how-to/role-
+        # based-access-control).
         # Corresponds to the JSON property `roles`
         # @return [Array<Google::Apis::SecuritycenterV1::Role>]
         attr_accessor :roles
@@ -3018,17 +3036,20 @@ module Google
         end
       end
       
-      # Label represents a generic name=value label. Label has separate name and value
-      # fields to support filtering with contains().
+      # Represents a generic name-value label. A label has separate name and value
+      # fields to support filtering with the `contains()` function. For more
+      # information, see [Filtering on array-type fields](https://cloud.google.com/
+      # security-command-center/docs/how-to-api-list-findings#array-contains-filtering)
+      # .
       class Label
         include Google::Apis::Core::Hashable
       
-        # Label name.
+        # Name of the label.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Label value.
+        # Value that corresponds to the label's name.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -3137,7 +3158,7 @@ module Google
         end
       end
       
-      # Response message for listing descendant security health analytics custom
+      # Response message for listing descendant Security Health Analytics custom
       # modules.
       class ListDescendantSecurityHealthAnalyticsCustomModulesResponse
         include Google::Apis::Core::Hashable
@@ -3163,7 +3184,7 @@ module Google
         end
       end
       
-      # Response message for listing effective security health analytics custom
+      # Response message for listing effective Security Health Analytics custom
       # modules.
       class ListEffectiveSecurityHealthAnalyticsCustomModulesResponse
         include Google::Apis::Core::Hashable
@@ -3341,7 +3362,7 @@ module Google
         end
       end
       
-      # Response message for listing security health analytics custom modules.
+      # Response message for listing Security Health Analytics custom modules.
       class ListSecurityHealthAnalyticsCustomModulesResponse
         include Google::Apis::Core::Hashable
       
@@ -3467,11 +3488,12 @@ module Google
         end
       end
       
-      # Kubernetes Nodes associated with the finding.
+      # Kubernetes nodes associated with the finding.
       class Node
         include Google::Apis::Core::Hashable
       
-        # Full Resource name of the Compute Engine VM running the cluster node.
+        # [Full resource name](https://google.aip.dev/122#full-resource-names) of the
+        # Compute Engine VM running the cluster node.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3486,11 +3508,11 @@ module Google
         end
       end
       
-      # Provides GKE Node Pool information.
+      # Provides GKE node pool information.
       class NodePool
         include Google::Apis::Core::Hashable
       
-        # Kubernetes Node pool name.
+        # Kubernetes node pool name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3662,7 +3684,7 @@ module Google
         end
       end
       
-      # Kubernetes Pod.
+      # A Kubernetes Pod.
       class Pod
         include Google::Apis::Core::Hashable
       
@@ -3831,18 +3853,18 @@ module Google
         # @return [Array<Google::Apis::SecuritycenterV1::File>]
         attr_accessor :libraries
       
-        # The process name visible in utilities like `top` and `ps`; it can be accessed
-        # via `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
+        # The process name, as displayed in utilities like `top` and `ps`. This name can
+        # be accessed through `/proc/[pid]/comm` and changed with `prctl(PR_SET_NAME)`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The parent process id.
+        # The parent process ID.
         # Corresponds to the JSON property `parentPid`
         # @return [Fixnum]
         attr_accessor :parent_pid
       
-        # The process id.
+        # The process ID.
         # Corresponds to the JSON property `pid`
         # @return [Fixnum]
         attr_accessor :pid
@@ -4402,21 +4424,21 @@ module Google
         end
       end
       
-      # Represents a Kubernetes Subject.
+      # Represents a Kubernetes subject.
       class Subject
         include Google::Apis::Core::Hashable
       
-        # Authentication type for subject.
+        # Authentication type for the subject.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Name for subject.
+        # Name for the subject.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Namespace for subject.
+        # Namespace for the subject.
         # Corresponds to the JSON property `ns`
         # @return [String]
         attr_accessor :ns

data/lib/google/apis/securitycenter_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SecuritycenterV1
       # Version of the google-apis-securitycenter_v1 gem
-      GEM_VERSION = "0.54.0"
+      GEM_VERSION = "0.56.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230410"
+      REVISION = "20230420"
     end
   end
 end

data/lib/google/apis/securitycenter_v1/service.rb

@@ -1047,7 +1047,7 @@ module Google
         # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
         # the given update mask. Updating the enablement state is supported on both
         # resident and inherited modules (though resident modules cannot have an
-        # enablement state of “inherited”). Updating the display name and custom config
+        # enablement state of "inherited"). Updating the display name and custom config
         # of a module is supported on resident modules only.
         # @param [String] name
         #   Immutable. The resource name of the custom module. Its format is "
@@ -1366,9 +1366,11 @@ module Google
         # Creates or updates a finding. The corresponding source must exist for a
         # finding creation to succeed.
         # @param [String] name
-        #   The relative resource name of this finding. See: https://cloud.google.com/apis/
-        #   design/resource_names#relative_resource_name Example: "organizations/`
-        #   organization_id`/sources/`source_id`/findings/`finding_id`"
+        #   The [relative resource name](https://cloud.google.com/apis/design/
+        #   resource_names#relative_resource_name) of the finding. Example: "organizations/
+        #   `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
+        #   folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
+        #   sources/`source_id`/findings/`finding_id`".
         # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
         # @param [String] update_mask
         #   The FieldMask to use when updating the finding resource. This field should not
@@ -2811,7 +2813,7 @@ module Google
         # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
         # the given update mask. Updating the enablement state is supported on both
         # resident and inherited modules (though resident modules cannot have an
-        # enablement state of “inherited”). Updating the display name and custom config
+        # enablement state of "inherited"). Updating the display name and custom config
         # of a module is supported on resident modules only.
         # @param [String] name
         #   Immutable. The resource name of the custom module. Its format is "
@@ -3379,9 +3381,11 @@ module Google
         # Creates or updates a finding. The corresponding source must exist for a
         # finding creation to succeed.
         # @param [String] name
-        #   The relative resource name of this finding. See: https://cloud.google.com/apis/
-        #   design/resource_names#relative_resource_name Example: "organizations/`
-        #   organization_id`/sources/`source_id`/findings/`finding_id`"
+        #   The [relative resource name](https://cloud.google.com/apis/design/
+        #   resource_names#relative_resource_name) of the finding. Example: "organizations/
+        #   `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
+        #   folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
+        #   sources/`source_id`/findings/`finding_id`".
         # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
         # @param [String] update_mask
         #   The FieldMask to use when updating the finding resource. This field should not
@@ -4577,7 +4581,7 @@ module Google
         # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
         # the given update mask. Updating the enablement state is supported on both
         # resident and inherited modules (though resident modules cannot have an
-        # enablement state of “inherited”). Updating the display name and custom config
+        # enablement state of "inherited"). Updating the display name and custom config
         # of a module is supported on resident modules only.
         # @param [String] name
         #   Immutable. The resource name of the custom module. Its format is "
@@ -4896,9 +4900,11 @@ module Google
         # Creates or updates a finding. The corresponding source must exist for a
         # finding creation to succeed.
         # @param [String] name
-        #   The relative resource name of this finding. See: https://cloud.google.com/apis/
-        #   design/resource_names#relative_resource_name Example: "organizations/`
-        #   organization_id`/sources/`source_id`/findings/`finding_id`"
+        #   The [relative resource name](https://cloud.google.com/apis/design/
+        #   resource_names#relative_resource_name) of the finding. Example: "organizations/
+        #   `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
+        #   folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
+        #   sources/`source_id`/findings/`finding_id`".
         # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
         # @param [String] update_mask
         #   The FieldMask to use when updating the finding resource. This field should not

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-securitycenter_v1
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.56.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-16 00:00:00.000000000 Z
+date: 2023-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1/v0.54.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-securitycenter_v1/v0.56.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-securitycenter_v1
 post_install_message: 
 rdoc_options: []