google-api-client 0.32.1 → 0.40.0

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

@@ -82,6 +82,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1NotificationMessage
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -94,6 +100,54 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSecuritycenterV1p1beta1Asset
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1Finding
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1IamPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1NotificationMessage
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1RunAssetDiscoveryResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1SecurityMarks
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1TemporalAsset
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GroupAssetsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -154,6 +208,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListNotificationConfigsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListOperationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -166,6 +226,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class NotificationConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +250,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Resource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RunAssetDiscoveryRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -226,6 +298,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StreamingConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TestIamPermissionsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -337,6 +415,15 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1NotificationMessage
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :finding, as: 'finding', class: Google::Apis::SecuritycenterV1::Finding, decorator: Google::Apis::SecuritycenterV1::Finding::Representation
+      
+          property :notification_config_name, as: 'notificationConfigName'
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -353,6 +440,96 @@ module Google
         end
       end
       
+      class GoogleCloudSecuritycenterV1p1beta1Asset
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :iam_policy, as: 'iamPolicy', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1IamPolicy, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1IamPolicy::Representation
+      
+          property :name, as: 'name'
+          hash :resource_properties, as: 'resourceProperties'
+          property :security_center_properties, as: 'securityCenterProperties', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties::Representation
+      
+          property :security_marks, as: 'securityMarks', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks::Representation
+      
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1Finding
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :category, as: 'category'
+          property :create_time, as: 'createTime'
+          property :event_time, as: 'eventTime'
+          property :external_uri, as: 'externalUri'
+          property :name, as: 'name'
+          property :parent, as: 'parent'
+          property :resource_name, as: 'resourceName'
+          property :security_marks, as: 'securityMarks', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks::Representation
+      
+          hash :source_properties, as: 'sourceProperties'
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1IamPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :policy_blob, as: 'policyBlob'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1NotificationMessage
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :finding, as: 'finding', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1Finding, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1Finding::Representation
+      
+          property :notification_config_name, as: 'notificationConfigName'
+          property :temporal_asset, as: 'temporalAsset', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1TemporalAsset, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1TemporalAsset::Representation
+      
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1RunAssetDiscoveryResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :duration, as: 'duration'
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :resource_display_name, as: 'resourceDisplayName'
+          property :resource_name, as: 'resourceName'
+          collection :resource_owners, as: 'resourceOwners'
+          property :resource_parent, as: 'resourceParent'
+          property :resource_parent_display_name, as: 'resourceParentDisplayName'
+          property :resource_project, as: 'resourceProject'
+          property :resource_project_display_name, as: 'resourceProjectDisplayName'
+          property :resource_type, as: 'resourceType'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1SecurityMarks
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :marks, as: 'marks'
+          property :name, as: 'name'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1p1beta1TemporalAsset
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :asset, as: 'asset', class: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1Asset, decorator: Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1p1beta1Asset::Representation
+      
+          property :change_type, as: 'changeType'
+        end
+      end
+      
       class GroupAssetsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -450,10 +627,21 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :finding, as: 'finding', class: Google::Apis::SecuritycenterV1::Finding, decorator: Google::Apis::SecuritycenterV1::Finding::Representation
       
+          property :resource, as: 'resource', class: Google::Apis::SecuritycenterV1::Resource, decorator: Google::Apis::SecuritycenterV1::Resource::Representation
+      
           property :state_change, as: 'stateChange'
         end
       end
       
+      class ListNotificationConfigsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :notification_configs, as: 'notificationConfigs', class: Google::Apis::SecuritycenterV1::NotificationConfig, decorator: Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+      
+        end
+      end
+      
       class ListOperationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -472,6 +660,18 @@ module Google
         end
       end
       
+      class NotificationConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :name, as: 'name'
+          property :pubsub_topic, as: 'pubsubTopic'
+          property :service_account, as: 'serviceAccount'
+          property :streaming_config, as: 'streamingConfig', class: Google::Apis::SecuritycenterV1::StreamingConfig, decorator: Google::Apis::SecuritycenterV1::StreamingConfig::Representation
+      
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -506,6 +706,17 @@ module Google
         end
       end
       
+      class Resource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :parent_display_name, as: 'parentDisplayName'
+          property :parent_name, as: 'parentName'
+          property :project_display_name, as: 'projectDisplayName'
+          property :project_name, as: 'projectName'
+        end
+      end
+      
       class RunAssetDiscoveryRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -515,10 +726,13 @@ module Google
       class SecurityCenterProperties
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :resource_display_name, as: 'resourceDisplayName'
           property :resource_name, as: 'resourceName'
           collection :resource_owners, as: 'resourceOwners'
           property :resource_parent, as: 'resourceParent'
+          property :resource_parent_display_name, as: 'resourceParentDisplayName'
           property :resource_project, as: 'resourceProject'
+          property :resource_project_display_name, as: 'resourceProjectDisplayName'
           property :resource_type, as: 'resourceType'
         end
       end
@@ -566,6 +780,13 @@ module Google
         end
       end
       
+      class StreamingConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :filter, as: 'filter'
+        end
+      end
+      
       class TestIamPermissionsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -20,10 +20,10 @@ require 'google/apis/errors'
 module Google
   module Apis
     module SecuritycenterV1
-      # Cloud Security Command Center API
+      # Security Command Center API
       #
-      # Cloud Security Command Center API provides access to temporal views of assets
-      #  and findings within an organization.
+      # Security Command Center API provides access to temporal views of assets and
+      #  findings within an organization.
       #
       # @example
       #    require 'google/apis/securitycenter_v1'
@@ -85,7 +85,7 @@ module Google
         #   The relative resource name of the settings. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Example:
-        #   "organizations/123/organizationSettings".
+        #   "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.
@@ -221,11 +221,18 @@ module Google
         #   * 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
@@ -241,8 +248,11 @@ module Google
         #   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
         # @param [Fixnum] page_size
         #   The maximum number of results to return in a single response. Default is
@@ -333,8 +343,9 @@ module Google
         #   The relative resource name of the SecurityMarks. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Examples:
-        #   "organizations/123/assets/456/securityMarks"
-        #   "organizations/123/sources/456/findings/789/securityMarks".
+        #   "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.
@@ -376,6 +387,188 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a notification config.
+        # @param [String] parent
+        #   Required. Resource name of the new notification config's parent. Its format is
+        #   "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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_organization_notification_config(parent, notification_config_object = nil, config_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/notificationConfigs', options)
+          command.request_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+          command.request_object = notification_config_object
+          command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+          command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
+          command.params['parent'] = parent unless parent.nil?
+          command.query['configId'] = config_id unless config_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a notification config.
+        # @param [String] name
+        #   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
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SecuritycenterV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
+          command.response_class = Google::Apis::SecuritycenterV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a notification config.
+        # @param [String] name
+        #   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
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_notification_config(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+          command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists notification configs.
+        # @param [String] parent
+        #   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.
+        # @param [String] page_token
+        #   The value returned by the last `ListNotificationConfigsResponse`; indicates
+        #   that this is a continuation of a prior `ListNotificationConfigs` 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
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SecuritycenterV1::ListNotificationConfigsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SecuritycenterV1::ListNotificationConfigsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_notification_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/notificationConfigs', options)
+          command.response_representation = Google::Apis::SecuritycenterV1::ListNotificationConfigsResponse::Representation
+          command.response_class = Google::Apis::SecuritycenterV1::ListNotificationConfigsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a notification config.
+        # @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".
+        # @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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SecuritycenterV1::NotificationConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SecuritycenterV1::NotificationConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_organization_notification_config(name, notification_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+          command.request_object = notification_config_object
+          command.response_representation = Google::Apis::SecuritycenterV1::NotificationConfig::Representation
+          command.response_class = Google::Apis::SecuritycenterV1::NotificationConfig
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          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
@@ -671,7 +864,7 @@ module Google
         #   The relative resource name of this source. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Example:
-        #   "organizations/123/sources/456"
+        #   "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.
@@ -817,12 +1010,12 @@ module Google
         # 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/123/sources/-/findings
+        # 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/123/sources/-
+        #   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.
@@ -855,12 +1048,12 @@ module Google
         
         # Lists an organization or source's findings.
         # To list across all sources provide a `-` as the source id.
-        # Example: /v1/organizations/123/sources/-/findings
+        # 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/123/sources/-
+        #   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,
@@ -873,12 +1066,18 @@ module Google
         #   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 at the start of
-        #   compare_duration, but changed its state at read_time.
-        #   * "UNCHANGED": indicates that the finding was present at the start of
-        #   compare_duration and did not change state at read_time.
-        #   * "ADDED":     indicates that the finding was not present at the start
-        #   of compare_duration, but was present at read_time.
+        #   * "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.
@@ -919,6 +1118,10 @@ module Google
         #   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
@@ -989,7 +1192,7 @@ module Google
         #   The relative resource name of this finding. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Example:
-        #   "organizations/123/sources/456/findings/789"
+        #   "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
@@ -1033,7 +1236,7 @@ module Google
         #   Required. The relative resource name of the finding. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Example:
-        #   "organizations/123/sources/456/finding/789".
+        #   "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.
@@ -1069,8 +1272,9 @@ module Google
         #   The relative resource name of the SecurityMarks. See:
         #   https://cloud.google.com/apis/design/resource_names#relative_resource_name
         #   Examples:
-        #   "organizations/123/assets/456/securityMarks"
-        #   "organizations/123/sources/456/findings/789/securityMarks".
+        #   "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.