google-api-client 0.42.0 → 0.44.1

data/generated/google/apis/securitycenter_v1/representations.rb

@@ -493,6 +493,7 @@ module Google
           property :resource_name, as: 'resourceName'
           property :security_marks, as: 'securityMarks', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks::Representation
       
+          property :severity, as: 'severity'
           hash :source_properties, as: 'sourceProperties'
           property :state, as: 'state'
         end

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

@@ -51,8 +51,7 @@ module Google
         # Gets the settings for an organization.
         # @param [String] name
         #   Required. Name of the organization to get organization settings for. Its
-        #   format is
-        #   "organizations/[organization_id]/organizationSettings".
+        #   format is "organizations/[organization_id]/organizationSettings".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -82,14 +81,13 @@ module Google
         
         # Updates an organization's settings.
         # @param [String] name
-        #   The relative resource name of the settings. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Example:
-        #   "organizations/`organization_id`/organizationSettings".
+        #   The relative resource name of the settings. See: https://cloud.google.com/apis/
+        #   design/resource_names#relative_resource_name Example: "organizations/`
+        #   organization_id`/organizationSettings".
         # @param [Google::Apis::SecuritycenterV1::OrganizationSettings] organization_settings_object
         # @param [String] update_mask
-        #   The FieldMask to use when updating the settings resource.
-        #   If empty all mutable fields will be updated.
+        #   The FieldMask to use when updating the settings resource. If empty all mutable
+        #   fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -120,11 +118,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Filters an organization's assets and  groups them by their specified
-        # properties.
+        # Filters an organization's assets and groups them by their specified properties.
         # @param [String] parent
-        #   Required. Name of the organization to groupBy. Its format is
-        #   "organizations/[organization_id]".
+        #   Required. Name of the organization to groupBy. Its format is "organizations/[
+        #   organization_id]".
         # @param [Google::Apis::SecuritycenterV1::GroupAssetsRequest] group_assets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -157,114 +154,86 @@ module Google
         
         # Lists an organization's assets.
         # @param [String] parent
-        #   Required. Name of the organization assets should belong to. Its format is
-        #   "organizations/[organization_id]".
+        #   Required. Name of the organization assets should belong to. Its format is "
+        #   organizations/[organization_id]".
         # @param [String] compare_duration
-        #   When compare_duration is set, the ListAssetsResult's "state_change"
-        #   attribute is updated to indicate whether the asset was added, removed, or
-        #   remained present during the compare_duration period of time that precedes
-        #   the read_time. This is the time between (read_time - compare_duration) and
-        #   read_time.
-        #   The state_change value is derived based on the presence of the asset at the
-        #   two points in time. Intermediate state changes between the two times don't
-        #   affect the result. For example, the results aren't affected if the asset is
-        #   removed and re-created again.
-        #   Possible "state_change" values when compare_duration is specified:
-        #   * "ADDED":   indicates that the asset was not present at the start of
-        #   compare_duration, but present at read_time.
-        #   * "REMOVED": indicates that the asset was present at the start of
-        #   compare_duration, but not present at read_time.
-        #   * "ACTIVE":  indicates that the asset was present at both the
-        #   start and the end of the time period defined by
-        #   compare_duration and read_time.
-        #   If compare_duration is not specified, then the only possible state_change
-        #   is "UNUSED",  which will be the state_change set for all assets present at
+        #   When compare_duration is set, the ListAssetsResult's "state_change" attribute
+        #   is updated to indicate whether the asset was added, removed, or remained
+        #   present during the compare_duration period of time that precedes the read_time.
+        #   This is the time between (read_time - compare_duration) and read_time. The
+        #   state_change value is derived based on the presence of the asset at the two
+        #   points in time. Intermediate state changes between the two times don't affect
+        #   the result. For example, the results aren't affected if the asset is removed
+        #   and re-created again. Possible "state_change" values when compare_duration is
+        #   specified: * "ADDED": indicates that the asset was not present at the start of
+        #   compare_duration, but present at read_time. * "REMOVED": indicates that the
+        #   asset was present at the start of compare_duration, but not present at
+        #   read_time. * "ACTIVE": indicates that the asset was present at both the start
+        #   and the end of the time period defined by compare_duration and read_time. If
+        #   compare_duration is not specified, then the only possible state_change is "
+        #   UNUSED", which will be the state_change set for all assets present at
         #   read_time.
         # @param [String] field_mask
         #   A field mask to specify the ListAssetsResult fields to be listed in the
-        #   response.
-        #   An empty field mask will list all fields.
+        #   response. An empty field mask will list all fields.
         # @param [String] filter
-        #   Expression that defines the filter to apply across assets.
-        #   The expression is a list of zero or more restrictions combined via logical
-        #   operators `AND` and `OR`.
-        #   Parentheses are supported, and `OR` has higher precedence than `AND`.
-        #   Restrictions have the form `<field> <operator> <value>` and may have a `-`
-        #   character in front of them to indicate negation. The fields map to those
-        #   defined in the Asset resource. Examples include:
-        #   * name
-        #   * security_center_properties.resource_name
-        #   * resource_properties.a_property
-        #   * security_marks.marks.marka
-        #   The supported operators are:
-        #   * `=` for all value types.
-        #   * `>`, `<`, `>=`, `<=` for integer values.
-        #   * `:`, meaning substring matching, for strings.
-        #   The supported value types are:
-        #   * string literals in quotes.
-        #   * integer literals without quotes.
-        #   * boolean literals `true` and `false` without quotes.
-        #   The following are the allowed field and operator combinations:
-        #   * name: `=`
-        #   * update_time: `=`, `>`, `<`, `>=`, `<=`
-        #   Usage: This should be milliseconds since epoch or an RFC3339 string.
-        #   Examples:
-        #   `update_time = "2019-06-10T16:07:18-07:00"`
-        #   `update_time = 1560208038000`
-        #   * create_time: `=`, `>`, `<`, `>=`, `<=`
-        #   Usage: This should be milliseconds since epoch or an RFC3339 string.
-        #   Examples:
-        #   `create_time = "2019-06-10T16:07:18-07:00"`
-        #   `create_time = 1560208038000`
-        #   * iam_policy.policy_blob: `=`, `:`
-        #   * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
-        #   * security_marks.marks: `=`, `:`
-        #   * security_center_properties.resource_name: `=`, `:`
-        #   * security_center_properties.resource_display_name: `=`, `:`
-        #   * security_center_properties.resource_type: `=`, `:`
-        #   * security_center_properties.resource_parent: `=`, `:`
-        #   * security_center_properties.resource_parent_display_name: `=`, `:`
-        #   * security_center_properties.resource_project: `=`, `:`
-        #   * security_center_properties.resource_project_display_name: `=`, `:`
-        #   * security_center_properties.resource_owners: `=`, `:`
-        #   For example, `resource_properties.size = 100` is a valid filter string.
-        #   Use a partial match on the empty string to filter based on a property
-        #   existing: `resource_properties.my_property : ""`
-        #   Use a negated partial match on the empty string to filter based on a
-        #   property not existing: `-resource_properties.my_property : ""`
+        #   Expression that defines the filter to apply across assets. The expression is a
+        #   list of zero or more restrictions combined via logical operators `AND` and `OR`
+        #   . Parentheses are supported, and `OR` has higher precedence than `AND`.
+        #   Restrictions have the form ` ` and may have a `-` character in front of them
+        #   to indicate negation. The fields map to those defined in the Asset resource.
+        #   Examples include: * name * security_center_properties.resource_name *
+        #   resource_properties.a_property * security_marks.marks.marka The supported
+        #   operators are: * `=` for all value types. * `>`, `<`, `>=`, `<=` for integer
+        #   values. * `:`, meaning substring matching, for strings. The supported value
+        #   types are: * string literals in quotes. * integer literals without quotes. *
+        #   boolean literals `true` and `false` without quotes. The following are the
+        #   allowed field and operator combinations: * name: `=` * update_time: `=`, `>`, `
+        #   <`, `>=`, `<=` Usage: This should be milliseconds since epoch or an RFC3339
+        #   string. Examples: `update_time = "2019-06-10T16:07:18-07:00"` `update_time =
+        #   1560208038000` * create_time: `=`, `>`, `<`, `>=`, `<=` Usage: This should be
+        #   milliseconds since epoch or an RFC3339 string. Examples: `create_time = "2019-
+        #   06-10T16:07:18-07:00"` `create_time = 1560208038000` * iam_policy.policy_blob:
+        #   `=`, `:` * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=` *
+        #   security_marks.marks: `=`, `:` * security_center_properties.resource_name: `=`,
+        #   `:` * security_center_properties.resource_display_name: `=`, `:` *
+        #   security_center_properties.resource_type: `=`, `:` *
+        #   security_center_properties.resource_parent: `=`, `:` *
+        #   security_center_properties.resource_parent_display_name: `=`, `:` *
+        #   security_center_properties.resource_project: `=`, `:` *
+        #   security_center_properties.resource_project_display_name: `=`, `:` *
+        #   security_center_properties.resource_owners: `=`, `:` For example, `
+        #   resource_properties.size = 100` is a valid filter string. Use a partial match
+        #   on the empty string to filter based on a property existing: `
+        #   resource_properties.my_property : ""` Use a negated partial match on the empty
+        #   string to filter based on a property not existing: `-resource_properties.
+        #   my_property : ""`
         # @param [String] order_by
-        #   Expression that defines what fields and order to use for sorting. The
-        #   string value should follow SQL syntax: comma separated list of fields. For
-        #   example: "name,resource_properties.a_property". The default sorting order
-        #   is ascending. To specify descending order for a field, a suffix " desc"
-        #   should be appended to the field name. For example: "name
-        #   desc,resource_properties.a_property". Redundant space characters in the
-        #   syntax are insignificant. "name desc,resource_properties.a_property" and "
-        #   name     desc  ,   resource_properties.a_property  " are equivalent.
-        #   The following fields are supported:
-        #   name
-        #   update_time
-        #   resource_properties
-        #   security_marks.marks
-        #   security_center_properties.resource_name
-        #   security_center_properties.resource_display_name
-        #   security_center_properties.resource_parent
+        #   Expression that defines what fields and order to use for sorting. The string
+        #   value should follow SQL syntax: comma separated list of fields. For example: "
+        #   name,resource_properties.a_property". The default sorting order is ascending.
+        #   To specify descending order for a field, a suffix " desc" should be appended
+        #   to the field name. For example: "name desc,resource_properties.a_property".
+        #   Redundant space characters in the syntax are insignificant. "name desc,
+        #   resource_properties.a_property" and " name desc , resource_properties.
+        #   a_property " are equivalent. The following fields are supported: name
+        #   update_time resource_properties security_marks.marks
+        #   security_center_properties.resource_name security_center_properties.
+        #   resource_display_name security_center_properties.resource_parent
         #   security_center_properties.resource_parent_display_name
-        #   security_center_properties.resource_project
-        #   security_center_properties.resource_project_display_name
-        #   security_center_properties.resource_type
+        #   security_center_properties.resource_project security_center_properties.
+        #   resource_project_display_name security_center_properties.resource_type
         # @param [Fixnum] page_size
-        #   The maximum number of results to return in a single response. Default is
-        #   10, minimum is 1, maximum is 1000.
+        #   The maximum number of results to return in a single response. Default is 10,
+        #   minimum is 1, maximum is 1000.
         # @param [String] page_token
-        #   The value returned by the last `ListAssetsResponse`; indicates
-        #   that this is a continuation of a prior `ListAssets` call, and
-        #   that the system should return the next page of data.
+        #   The value returned by the last `ListAssetsResponse`; indicates that this is a
+        #   continuation of a prior `ListAssets` call, and that the system should return
+        #   the next page of data.
         # @param [String] read_time
-        #   Time used as a reference point when filtering assets. The filter is limited
-        #   to assets existing at the supplied time and their values are those at that
-        #   specific time. Absence of this field will default to the API's version of
-        #   NOW.
+        #   Time used as a reference point when filtering assets. The filter is limited to
+        #   assets existing at the supplied time and their values are those at that
+        #   specific time. Absence of this field will default to the API's version of NOW.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -299,14 +268,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Runs asset discovery. The discovery is tracked with a long-running
-        # operation.
-        # This API can only be called with limited frequency for an organization. If
-        # it is called too frequently the caller will receive a TOO_MANY_REQUESTS
-        # error.
+        # Runs asset discovery. The discovery is tracked with a long-running operation.
+        # This API can only be called with limited frequency for an organization. If it
+        # is called too frequently the caller will receive a TOO_MANY_REQUESTS error.
         # @param [String] parent
-        #   Required. Name of the organization to run asset discovery for. Its format is
-        #   "organizations/[organization_id]".
+        #   Required. Name of the organization to run asset discovery for. Its format is "
+        #   organizations/[organization_id]".
         # @param [Google::Apis::SecuritycenterV1::RunAssetDiscoveryRequest] run_asset_discovery_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -339,22 +306,19 @@ module Google
         
         # Updates security marks.
         # @param [String] name
-        #   The relative resource name of the SecurityMarks. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Examples:
-        #   "organizations/`organization_id`/assets/`asset_id`/securityMarks"
-        #   "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`/
-        #   securityMarks".
+        #   The relative resource name of the SecurityMarks. See: https://cloud.google.com/
+        #   apis/design/resource_names#relative_resource_name Examples: "organizations/`
+        #   organization_id`/assets/`asset_id`/securityMarks" "organizations/`
+        #   organization_id`/sources/`source_id`/findings/`finding_id`/securityMarks".
         # @param [Google::Apis::SecuritycenterV1::SecurityMarks] security_marks_object
         # @param [String] start_time
-        #   The time at which the updated SecurityMarks take effect.
-        #   If not set uses current server time.  Updates will be applied to the
-        #   SecurityMarks that are active immediately preceding this time.
+        #   The time at which the updated SecurityMarks take effect. If not set uses
+        #   current server time. Updates will be applied to the SecurityMarks that are
+        #   active immediately preceding this time.
         # @param [String] update_mask
-        #   The FieldMask to use when updating the security marks resource.
-        #   The field mask must not contain duplicate fields.
-        #   If empty or set to "marks", all marks will be replaced.  Individual
-        #   marks can be updated using "marks.<mark_key>".
+        #   The FieldMask to use when updating the security marks resource. The field mask
+        #   must not contain duplicate fields. If empty or set to "marks", all marks will
+        #   be replaced. Individual marks can be updated using "marks.".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -392,10 +356,9 @@ module Google
         #   "organizations/[organization_id]".
         # @param [Google::Apis::SecuritycenterV1::NotificationConfig] notification_config_object
         # @param [String] config_id
-        #   Required.
-        #   Unique identifier provided by the client within the parent scope.
-        #   It must be between 1 and 128 characters, and contains alphanumeric
-        #   characters, underscores or hyphens only.
+        #   Required. Unique identifier provided by the client within the parent scope. It
+        #   must be between 1 and 128 characters, and contains alphanumeric characters,
+        #   underscores or hyphens only.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -428,8 +391,8 @@ module Google
         
         # Deletes a notification config.
         # @param [String] name
-        #   Required. Name of the notification config to delete. Its format is
-        #   "organizations/[organization_id]/notificationConfigs/[config_id]".
+        #   Required. Name of the notification config to delete. Its format is "
+        #   organizations/[organization_id]/notificationConfigs/[config_id]".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -459,8 +422,8 @@ module Google
         
         # Gets a notification config.
         # @param [String] name
-        #   Required. Name of the notification config to get. Its format is
-        #   "organizations/[organization_id]/notificationConfigs/[config_id]".
+        #   Required. Name of the notification config to get. Its format is "organizations/
+        #   [organization_id]/notificationConfigs/[config_id]".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -490,11 +453,11 @@ module Google
         
         # Lists notification configs.
         # @param [String] parent
-        #   Required. Name of the organization to list notification configs.
-        #   Its format is "organizations/[organization_id]".
+        #   Required. Name of the organization to list notification configs. Its format is
+        #   "organizations/[organization_id]".
         # @param [Fixnum] page_size
-        #   The maximum number of results to return in a single response. Default is
-        #   10, minimum is 1, maximum is 1000.
+        #   The maximum number of results to return in a single response. Default is 10,
+        #   minimum is 1, maximum is 1000.
         # @param [String] page_token
         #   The value returned by the last `ListNotificationConfigsResponse`; indicates
         #   that this is a continuation of a prior `ListNotificationConfigs` call, and
@@ -528,17 +491,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a notification config. The following update
-        # fields are allowed: description, pubsub_topic, streaming_config.filter
+        # Updates a notification config. The following update fields are allowed:
+        # description, pubsub_topic, streaming_config.filter
         # @param [String] name
-        #   The relative resource name of this notification config. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Example:
-        #   "organizations/`organization_id`/notificationConfigs/notify_public_bucket".
+        #   The relative resource name of this notification config. See: https://cloud.
+        #   google.com/apis/design/resource_names#relative_resource_name Example: "
+        #   organizations/`organization_id`/notificationConfigs/notify_public_bucket".
         # @param [Google::Apis::SecuritycenterV1::NotificationConfig] notification_config_object
         # @param [String] update_mask
-        #   The FieldMask to use when updating the notification config.
-        #   If empty all mutable fields will be updated.
+        #   The FieldMask to use when updating the notification config. If empty all
+        #   mutable fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -569,15 +531,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
-        # Operations.GetOperation or
-        # other methods to check whether the cancellation succeeded or whether the
-        # operation completed despite cancellation. On successful cancellation,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # Clients can use Operations.GetOperation or other methods to check whether the
+        # cancellation succeeded or whether the operation completed despite cancellation.
+        # On successful cancellation, the operation is not deleted; instead, it becomes
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -608,10 +568,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -641,9 +601,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -673,15 +632,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -722,8 +680,8 @@ module Google
         
         # Creates a source.
         # @param [String] parent
-        #   Required. Resource name of the new source's parent. Its format should be
-        #   "organizations/[organization_id]".
+        #   Required. Resource name of the new source's parent. Its format should be "
+        #   organizations/[organization_id]".
         # @param [Google::Apis::SecuritycenterV1::Source] source_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -756,8 +714,8 @@ module Google
         
         # Gets a source.
         # @param [String] name
-        #   Required. Relative resource name of the source. Its format is
-        #   "organizations/[organization_id]/source/[source_id]".
+        #   Required. Relative resource name of the source. Its format is "organizations/[
+        #   organization_id]/source/[source_id]".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -787,8 +745,8 @@ module Google
         
         # Gets the access control policy on the specified Source.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::SecuritycenterV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -824,12 +782,12 @@ module Google
         #   Required. Resource name of the parent of sources to list. Its format should be
         #   "organizations/[organization_id]".
         # @param [Fixnum] page_size
-        #   The maximum number of results to return in a single response. Default is
-        #   10, minimum is 1, maximum is 1000.
+        #   The maximum number of results to return in a single response. Default is 10,
+        #   minimum is 1, maximum is 1000.
         # @param [String] page_token
-        #   The value returned by the last `ListSourcesResponse`; indicates
-        #   that this is a continuation of a prior `ListSources` call, and
-        #   that the system should return the next page of data.
+        #   The value returned by the last `ListSourcesResponse`; indicates that this is a
+        #   continuation of a prior `ListSources` call, and that the system should return
+        #   the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -861,14 +819,13 @@ module Google
         
         # Updates a source.
         # @param [String] name
-        #   The relative resource name of this source. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Example:
-        #   "organizations/`organization_id`/sources/`source_id`"
+        #   The relative resource name of this source. See: https://cloud.google.com/apis/
+        #   design/resource_names#relative_resource_name Example: "organizations/`
+        #   organization_id`/sources/`source_id`"
         # @param [Google::Apis::SecuritycenterV1::Source] source_object
         # @param [String] update_mask
-        #   The FieldMask to use when updating the source resource.
-        #   If empty all mutable fields will be updated.
+        #   The FieldMask to use when updating the source resource. If empty all mutable
+        #   fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -901,8 +858,8 @@ module Google
         
         # Sets the access control policy on the specified Source.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::SecuritycenterV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -935,8 +892,8 @@ module Google
         
         # Returns the permissions that a caller has on the specified source.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::SecuritycenterV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -967,16 +924,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a finding. The corresponding source must exist for finding creation
-        # to succeed.
+        # Creates a finding. The corresponding source must exist for finding creation to
+        # succeed.
         # @param [String] parent
-        #   Required. Resource name of the new finding's parent. Its format should be
-        #   "organizations/[organization_id]/sources/[source_id]".
+        #   Required. Resource name of the new finding's parent. Its format should be "
+        #   organizations/[organization_id]/sources/[source_id]".
         # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
         # @param [String] finding_id
-        #   Required. Unique identifier provided by the client within the parent scope.
-        #   It must be alphanumeric and less than or equal to 32 characters and
-        #   greater than 0 characters in length.
+        #   Required. Unique identifier provided by the client within the parent scope. It
+        #   must be alphanumeric and less than or equal to 32 characters and greater than
+        #   0 characters in length.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1007,15 +964,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Filters an organization or source's findings and  groups them by their
-        # specified properties.
-        # To group across all sources provide a `-` as the source id.
-        # Example: /v1/organizations/`organization_id`/sources/-/findings
+        # Filters an organization or source's findings and groups them by their
+        # specified properties. To group across all sources provide a `-` as the source
+        # id. Example: /v1/organizations/`organization_id`/sources/-/findings
         # @param [String] parent
-        #   Required. Name of the source to groupBy. Its format is
-        #   "organizations/[organization_id]/sources/[source_id]". To groupBy across
-        #   all sources provide a source_id of `-`. For example:
-        #   organizations/`organization_id`/sources/-
+        #   Required. Name of the source to groupBy. Its format is "organizations/[
+        #   organization_id]/sources/[source_id]". To groupBy across all sources provide a
+        #   source_id of `-`. For example: organizations/`organization_id`/sources/-
         # @param [Google::Apis::SecuritycenterV1::GroupFindingsRequest] group_findings_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1046,111 +1001,80 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists an organization or source's findings.
-        # To list across all sources provide a `-` as the source id.
-        # Example: /v1/organizations/`organization_id`/sources/-/findings
+        # Lists an organization or source's findings. To list across all sources provide
+        # a `-` as the source id. Example: /v1/organizations/`organization_id`/sources/-/
+        # findings
         # @param [String] parent
-        #   Required. Name of the source the findings belong to. Its format is
-        #   "organizations/[organization_id]/sources/[source_id]". To list across all
-        #   sources provide a source_id of `-`. For example:
-        #   organizations/`organization_id`/sources/-
+        #   Required. Name of the source the findings belong to. Its format is "
+        #   organizations/[organization_id]/sources/[source_id]". To list across all
+        #   sources provide a source_id of `-`. For example: organizations/`
+        #   organization_id`/sources/-
         # @param [String] compare_duration
         #   When compare_duration is set, the ListFindingsResult's "state_change"
         #   attribute is updated to indicate whether the finding had its state changed,
         #   the finding's state remained unchanged, or if the finding was added in any
-        #   state during the compare_duration period of time that precedes the
-        #   read_time. This is the time between (read_time - compare_duration) and
-        #   read_time.
-        #   The state_change value is derived based on the presence and state of the
-        #   finding at the two points in time. Intermediate state changes between the
-        #   two times don't affect the result. For example, the results aren't affected
-        #   if the finding is made inactive and then active again.
-        #   Possible "state_change" values when compare_duration is specified:
-        #   * "CHANGED":   indicates that the finding was present and matched the given
-        #   filter at the start of compare_duration, but changed its
-        #   state at read_time.
-        #   * "UNCHANGED": indicates that the finding was present and matched the given
-        #   filter at the start of compare_duration and did not change
-        #   state at read_time.
-        #   * "ADDED":     indicates that the finding did not match the given filter or
-        #   was not present at the start of compare_duration, but was
-        #   present at read_time.
-        #   * "REMOVED":   indicates that the finding was present and matched the
-        #   filter at the start of compare_duration, but did not match
-        #   the filter at read_time.
-        #   If compare_duration is not specified, then the only possible state_change
-        #   is "UNUSED", which will be the state_change set for all findings present at
-        #   read_time.
+        #   state during the compare_duration period of time that precedes the read_time.
+        #   This is the time between (read_time - compare_duration) and read_time. The
+        #   state_change value is derived based on the presence and state of the finding
+        #   at the two points in time. Intermediate state changes between the two times
+        #   don't affect the result. For example, the results aren't affected if the
+        #   finding is made inactive and then active again. Possible "state_change" values
+        #   when compare_duration is specified: * "CHANGED": indicates that the finding
+        #   was present and matched the given filter at the start of compare_duration, but
+        #   changed its state at read_time. * "UNCHANGED": indicates that the finding was
+        #   present and matched the given filter at the start of compare_duration and did
+        #   not change state at read_time. * "ADDED": indicates that the finding did not
+        #   match the given filter or was not present at the start of compare_duration,
+        #   but was present at read_time. * "REMOVED": indicates that the finding was
+        #   present and matched the filter at the start of compare_duration, but did not
+        #   match the filter at read_time. If compare_duration is not specified, then the
+        #   only possible state_change is "UNUSED", which will be the state_change set for
+        #   all findings present at read_time.
         # @param [String] field_mask
-        #   A field mask to specify the Finding fields to be listed in the response.
-        #   An empty field mask will list all fields.
+        #   A field mask to specify the Finding fields to be listed in the response. An
+        #   empty field mask will list all fields.
         # @param [String] filter
-        #   Expression that defines the filter to apply across findings.
-        #   The expression is a list of one or more restrictions combined via logical
-        #   operators `AND` and `OR`.
-        #   Parentheses are supported, and `OR` has higher precedence than `AND`.
-        #   Restrictions have the form `<field> <operator> <value>` and may have a `-`
-        #   character in front of them to indicate negation. Examples include:
-        #   * name
-        #   * source_properties.a_property
-        #   * security_marks.marks.marka
-        #   The supported operators are:
-        #   * `=` for all value types.
-        #   * `>`, `<`, `>=`, `<=` for integer values.
-        #   * `:`, meaning substring matching, for strings.
-        #   The supported value types are:
-        #   * string literals in quotes.
-        #   * integer literals without quotes.
-        #   * boolean literals `true` and `false` without quotes.
-        #   The following field and operator combinations are supported:
-        #   name: `=`
-        #   parent: `=`, `:`
-        #   resource_name: `=`, `:`
-        #   state: `=`, `:`
-        #   category: `=`, `:`
-        #   external_uri: `=`, `:`
-        #   event_time: `=`, `>`, `<`, `>=`, `<=`
-        #   Usage: This should be milliseconds since epoch or an RFC3339 string.
-        #   Examples:
-        #   `event_time = "2019-06-10T16:07:18-07:00"`
-        #   `event_time = 1560208038000`
-        #   security_marks.marks: `=`, `:`
-        #   source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
-        #   For example, `source_properties.size = 100` is a valid filter string.
-        #   Use a partial match on the empty string to filter based on a property
-        #   existing: `source_properties.my_property : ""`
-        #   Use a negated partial match on the empty string to filter based on a
-        #   property not existing: `-source_properties.my_property : ""`
+        #   Expression that defines the filter to apply across findings. The expression is
+        #   a list of one or more restrictions combined via logical operators `AND` and `
+        #   OR`. Parentheses are supported, and `OR` has higher precedence than `AND`.
+        #   Restrictions have the form ` ` and may have a `-` character in front of them
+        #   to indicate negation. Examples include: * name * source_properties.a_property *
+        #   security_marks.marks.marka The supported operators are: * `=` for all value
+        #   types. * `>`, `<`, `>=`, `<=` for integer values. * `:`, meaning substring
+        #   matching, for strings. The supported value types are: * string literals in
+        #   quotes. * integer literals without quotes. * boolean literals `true` and `
+        #   false` without quotes. The following field and operator combinations are
+        #   supported: name: `=` parent: `=`, `:` resource_name: `=`, `:` state: `=`, `:`
+        #   category: `=`, `:` external_uri: `=`, `:` event_time: `=`, `>`, `<`, `>=`, `<=`
+        #   Usage: This should be milliseconds since epoch or an RFC3339 string. Examples:
+        #   `event_time = "2019-06-10T16:07:18-07:00"` `event_time = 1560208038000`
+        #   security_marks.marks: `=`, `:` source_properties: `=`, `:`, `>`, `<`, `>=`, `<=
+        #   ` For example, `source_properties.size = 100` is a valid filter string. Use a
+        #   partial match on the empty string to filter based on a property existing: `
+        #   source_properties.my_property : ""` Use a negated partial match on the empty
+        #   string to filter based on a property not existing: `-source_properties.
+        #   my_property : ""`
         # @param [String] order_by
-        #   Expression that defines what fields and order to use for sorting. The
-        #   string value should follow SQL syntax: comma separated list of fields. For
-        #   example: "name,resource_properties.a_property". The default sorting order
-        #   is ascending. To specify descending order for a field, a suffix " desc"
-        #   should be appended to the field name. For example: "name
-        #   desc,source_properties.a_property". Redundant space characters in the
-        #   syntax are insignificant. "name desc,source_properties.a_property" and "
-        #   name     desc  ,   source_properties.a_property  " are equivalent.
-        #   The following fields are supported:
-        #   name
-        #   parent
-        #   state
-        #   category
-        #   resource_name
-        #   event_time
-        #   source_properties
-        #   security_marks.marks
+        #   Expression that defines what fields and order to use for sorting. The string
+        #   value should follow SQL syntax: comma separated list of fields. For example: "
+        #   name,resource_properties.a_property". The default sorting order is ascending.
+        #   To specify descending order for a field, a suffix " desc" should be appended
+        #   to the field name. For example: "name desc,source_properties.a_property".
+        #   Redundant space characters in the syntax are insignificant. "name desc,
+        #   source_properties.a_property" and " name desc , source_properties.a_property "
+        #   are equivalent. The following fields are supported: name parent state category
+        #   resource_name event_time source_properties security_marks.marks
         # @param [Fixnum] page_size
-        #   The maximum number of results to return in a single response. Default is
-        #   10, minimum is 1, maximum is 1000.
+        #   The maximum number of results to return in a single response. Default is 10,
+        #   minimum is 1, maximum is 1000.
         # @param [String] page_token
-        #   The value returned by the last `ListFindingsResponse`; indicates
-        #   that this is a continuation of a prior `ListFindings` call, and
-        #   that the system should return the next page of data.
+        #   The value returned by the last `ListFindingsResponse`; indicates that this is
+        #   a continuation of a prior `ListFindings` call, and that the system should
+        #   return the next page of data.
         # @param [String] read_time
-        #   Time used as a reference point when filtering findings. The filter is
-        #   limited to findings existing at the supplied time and their values are
-        #   those at that specific time. Absence of this field will default to the
-        #   API's version of NOW.
+        #   Time used as a reference point when filtering findings. The filter is limited
+        #   to findings existing at the supplied time and their values are those at that
+        #   specific time. Absence of this field will default to the API's version of NOW.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1188,18 +1112,16 @@ 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 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`"
         # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
         # @param [String] update_mask
-        #   The FieldMask to use when updating the finding resource. This field should
-        #   not be specified when creating a finding.
-        #   When updating a finding, an empty mask is treated as updating all mutable
-        #   fields and replacing source_properties.  Individual source_properties can
-        #   be added/updated by using "source_properties.<property key>" in the field
-        #   mask.
+        #   The FieldMask to use when updating the finding resource. This field should not
+        #   be specified when creating a finding. When updating a finding, an empty mask
+        #   is treated as updating all mutable fields and replacing source_properties.
+        #   Individual source_properties can be added/updated by using "source_properties."
+        #   in the field mask.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1232,10 +1154,9 @@ module Google
         
         # Updates the state of a finding.
         # @param [String] name
-        #   Required. The relative resource name of the finding. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Example:
-        #   "organizations/`organization_id`/sources/`source_id`/finding/`finding_id`".
+        #   Required. The relative resource name of the finding. See: https://cloud.google.
+        #   com/apis/design/resource_names#relative_resource_name Example: "organizations/`
+        #   organization_id`/sources/`source_id`/finding/`finding_id`".
         # @param [Google::Apis::SecuritycenterV1::SetFindingStateRequest] set_finding_state_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1268,22 +1189,19 @@ module Google
         
         # Updates security marks.
         # @param [String] name
-        #   The relative resource name of the SecurityMarks. See:
-        #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
-        #   Examples:
-        #   "organizations/`organization_id`/assets/`asset_id`/securityMarks"
-        #   "organizations/`organization_id`/sources/`source_id`/findings/`finding_id`/
-        #   securityMarks".
+        #   The relative resource name of the SecurityMarks. See: https://cloud.google.com/
+        #   apis/design/resource_names#relative_resource_name Examples: "organizations/`
+        #   organization_id`/assets/`asset_id`/securityMarks" "organizations/`
+        #   organization_id`/sources/`source_id`/findings/`finding_id`/securityMarks".
         # @param [Google::Apis::SecuritycenterV1::SecurityMarks] security_marks_object
         # @param [String] start_time
-        #   The time at which the updated SecurityMarks take effect.
-        #   If not set uses current server time.  Updates will be applied to the
-        #   SecurityMarks that are active immediately preceding this time.
+        #   The time at which the updated SecurityMarks take effect. If not set uses
+        #   current server time. Updates will be applied to the SecurityMarks that are
+        #   active immediately preceding this time.
         # @param [String] update_mask
-        #   The FieldMask to use when updating the security marks resource.
-        #   The field mask must not contain duplicate fields.
-        #   If empty or set to "marks", all marks will be replaced.  Individual
-        #   marks can be updated using "marks.<mark_key>".
+        #   The FieldMask to use when updating the security marks resource. The field mask
+        #   must not contain duplicate fields. If empty or set to "marks", all marks will
+        #   be replaced. Individual marks can be updated using "marks.".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user