google-api-client 0.37.0 → 0.38.0

data/generated/google/apis/securitycenter_v1p1alpha1/classes.rb

@@ -41,6 +41,146 @@ module Google
         end
       end
       
+      # Security Command Center finding.
+      # A finding is a record of assessment data like security, risk, health, or
+      # privacy, that is ingested into Security Command Center for presentation,
+      # notification, analysis, policy testing, and enforcement. For example, a
+      # cross-site scripting (XSS) vulnerability in an App Engine application is a
+      # finding.
+      # When adding a new field hidden behind a visibility label, ensure it is also
+      # hidden from Notifications:
+      # http://google3/java/com/google/cloud/security/riskdashboard/notification/
+      # actions/streaming/FindingTranslator.java?l=26
+      class Finding
+        include Google::Apis::Core::Hashable
+      
+        # The additional taxonomy group within findings from a given source.
+        # This field is immutable after creation time.
+        # Example: "XSS_FLASH_INJECTION"
+        # Corresponds to the JSON property `category`
+        # @return [String]
+        attr_accessor :category
+      
+        # The time at which the finding was created in Security Command Center.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The time at which the event took place. For example, if the finding
+        # represents an open firewall it would capture the time the detector believes
+        # the firewall became open. The accuracy is determined by the detector.
+        # Corresponds to the JSON property `eventTime`
+        # @return [String]
+        attr_accessor :event_time
+      
+        # The URI that, if available, points to a web page outside of Security
+        # Command Center where additional information about the finding can be found.
+        # This field is guaranteed to be either empty or a well formed URL.
+        # Corresponds to the JSON property `externalUri`
+        # @return [String]
+        attr_accessor :external_uri
+      
+        # 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`"
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The relative resource name of the source the finding belongs to. See:
+        # https://cloud.google.com/apis/design/resource_names#relative_resource_name
+        # This field is immutable after creation time.
+        # For example:
+        # "organizations/`organization_id`/sources/`source_id`"
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        # For findings on Google Cloud resources, the full resource
+        # name of the Google Cloud resource this finding is for. See:
+        # https://cloud.google.com/apis/design/resource_names#full_resource_name
+        # When the finding is for a non-Google Cloud resource, the resourceName can
+        # be a customer or partner defined string. This field is immutable after
+        # creation time.
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
+      
+        # User specified security marks that are attached to the parent Security
+        # Command Center resource. Security marks are scoped within a Security Command
+        # Center organization -- they can be modified and viewed by all users who have
+        # proper permissions on the organization.
+        # Corresponds to the JSON property `securityMarks`
+        # @return [Google::Apis::SecuritycenterV1p1alpha1::SecurityMarks]
+        attr_accessor :security_marks
+      
+        # Source specific properties. These properties are managed by the source
+        # that writes the finding. The key names in the source_properties map must be
+        # between 1 and 255 characters, and must start with a letter and contain
+        # alphanumeric characters or underscores only.
+        # Corresponds to the JSON property `sourceProperties`
+        # @return [Hash<String,Object>]
+        attr_accessor :source_properties
+      
+        # The state of the finding.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @category = args[:category] if args.key?(:category)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @event_time = args[:event_time] if args.key?(:event_time)
+          @external_uri = args[:external_uri] if args.key?(:external_uri)
+          @name = args[:name] if args.key?(:name)
+          @parent = args[:parent] if args.key?(:parent)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+          @security_marks = args[:security_marks] if args.key?(:security_marks)
+          @source_properties = args[:source_properties] if args.key?(:source_properties)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Cloud SCC's Notification
+      class GoogleCloudSecuritycenterV1NotificationMessage
+        include Google::Apis::Core::Hashable
+      
+        # Security Command Center finding.
+        # A finding is a record of assessment data like security, risk, health, or
+        # privacy, that is ingested into Security Command Center for presentation,
+        # notification, analysis, policy testing, and enforcement. For example, a
+        # cross-site scripting (XSS) vulnerability in an App Engine application is a
+        # finding.
+        # When adding a new field hidden behind a visibility label, ensure it is also
+        # hidden from Notifications:
+        # http://google3/java/com/google/cloud/security/riskdashboard/notification/
+        # actions/streaming/FindingTranslator.java?l=26
+        # Corresponds to the JSON property `finding`
+        # @return [Google::Apis::SecuritycenterV1p1alpha1::Finding]
+        attr_accessor :finding
+      
+        # Name of the notification config that generated current notification.
+        # Corresponds to the JSON property `notificationConfigName`
+        # @return [String]
+        attr_accessor :notification_config_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @finding = args[:finding] if args.key?(:finding)
+          @notification_config_name = args[:notification_config_name] if args.key?(:notification_config_name)
+        end
+      end
+      
       # Response of asset discovery run
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         include Google::Apis::Core::Hashable
@@ -91,22 +231,24 @@ module Google
         end
       end
       
-      # Cloud Security Command Center's (Cloud SCC) representation of a Google Cloud
-      # Platform (GCP) resource.
-      # The Asset is a Cloud SCC resource that captures information about a single
-      # GCP resource. All modifications to an Asset are only within the context of
-      # Cloud SCC and don't affect the referenced GCP resource.
+      # Security Command Center representation of a Google Cloud
+      # resource.
+      # The Asset is a Security Command Center resource that captures information
+      # about a single Google Cloud resource. All modifications to an Asset are only
+      # within the context of Security Command Center and don't affect the referenced
+      # Google Cloud resource.
       class GoogleCloudSecuritycenterV1p1beta1Asset
         include Google::Apis::Core::Hashable
       
-        # The time at which the asset was created in Cloud SCC.
+        # The time at which the asset was created in Security Command Center.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # IAM Policy information associated with the GCP resource described by the
-        # Cloud SCC asset. This information is managed and defined by the GCP
-        # resource and cannot be modified by the user.
+        # Cloud IAM Policy information associated with the Google Cloud resource
+        # described by the Security Command Center asset. This information is managed
+        # and defined by the Google Cloud resource and cannot be modified by the
+        # user.
         # Corresponds to the JSON property `iamPolicy`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1IamPolicy]
         attr_accessor :iam_policy
@@ -120,20 +262,20 @@ module Google
         attr_accessor :name
       
         # Resource managed properties. These properties are managed and defined by
-        # the GCP resource and cannot be modified by the user.
+        # the Google Cloud resource and cannot be modified by the user.
         # Corresponds to the JSON property `resourceProperties`
         # @return [Hash<String,Object>]
         attr_accessor :resource_properties
       
-        # Cloud SCC managed properties. These properties are managed by Cloud SCC and
-        # cannot be modified by the user.
+        # Security Command Center managed properties. These properties are managed by
+        # Security Command Center and cannot be modified by the user.
         # Corresponds to the JSON property `securityCenterProperties`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties]
         attr_accessor :security_center_properties
       
-        # User specified security marks that are attached to the parent Cloud Security
-        # Command Center (Cloud SCC) resource. Security marks are scoped within a Cloud
-        # SCC organization -- they can be modified and viewed by all users who have
+        # User specified security marks that are attached to the parent Security
+        # Command Center resource. Security marks are scoped within a Security Command
+        # Center organization -- they can be modified and viewed by all users who have
         # proper permissions on the organization.
         # Corresponds to the JSON property `securityMarks`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks]
@@ -161,11 +303,11 @@ module Google
         end
       end
       
-      # Cloud Security Command Center (Cloud SCC) finding.
+      # Security Command Center finding.
       # A finding is a record of assessment data (security, risk, health or privacy)
-      # ingested into Cloud SCC for presentation, notification, analysis,
-      # policy testing, and enforcement. For example, an XSS vulnerability in an
-      # App Engine application is a finding.
+      # ingested into Security Command Center for presentation, notification,
+      # analysis, policy testing, and enforcement. For example, an XSS vulnerability
+      # in an App Engine application is a finding.
       class GoogleCloudSecuritycenterV1p1beta1Finding
         include Google::Apis::Core::Hashable
       
@@ -176,7 +318,7 @@ module Google
         # @return [String]
         attr_accessor :category
       
-        # The time at which the finding was created in Cloud SCC.
+        # The time at which the finding was created in Security Command Center.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -188,9 +330,9 @@ module Google
         # @return [String]
         attr_accessor :event_time
       
-        # The URI that, if available, points to a web page outside of Cloud SCC
-        # where additional information about the finding can be found. This field is
-        # guaranteed to be either empty or a well formed URL.
+        # The URI that, if available, points to a web page outside of Security
+        # Command Center where additional information about the finding can be found.
+        # This field is guaranteed to be either empty or a well formed URL.
         # Corresponds to the JSON property `externalUri`
         # @return [String]
         attr_accessor :external_uri
@@ -212,19 +354,19 @@ module Google
         # @return [String]
         attr_accessor :parent
       
-        # For findings on Google Cloud Platform (GCP) resources, the full resource
-        # name of the GCP resource this finding is for. See:
+        # For findings on Google Cloud resources, the full resource
+        # name of the Google Cloud resource this finding is for. See:
         # https://cloud.google.com/apis/design/resource_names#full_resource_name
-        # When the finding is for a non-GCP resource, the resourceName can be a
-        # customer or partner defined string.
-        # This field is immutable after creation time.
+        # When the finding is for a non-Google Cloud resource, the resourceName can
+        # be a customer or partner defined string. This field is immutable after
+        # creation time.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
       
-        # User specified security marks that are attached to the parent Cloud Security
-        # Command Center (Cloud SCC) resource. Security marks are scoped within a Cloud
-        # SCC organization -- they can be modified and viewed by all users who have
+        # User specified security marks that are attached to the parent Security
+        # Command Center resource. Security marks are scoped within a Security Command
+        # Center organization -- they can be modified and viewed by all users who have
         # proper permissions on the organization.
         # Corresponds to the JSON property `securityMarks`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1SecurityMarks]
@@ -262,14 +404,15 @@ module Google
         end
       end
       
-      # IAM Policy information associated with the GCP resource described by the
-      # Cloud SCC asset. This information is managed and defined by the GCP
-      # resource and cannot be modified by the user.
+      # Cloud IAM Policy information associated with the Google Cloud resource
+      # described by the Security Command Center asset. This information is managed
+      # and defined by the Google Cloud resource and cannot be modified by the
+      # user.
       class GoogleCloudSecuritycenterV1p1beta1IamPolicy
         include Google::Apis::Core::Hashable
       
         # The JSON representation of the Policy associated with the asset.
-        # See https://cloud.google.com/iam/reference/rest/v1p1beta1/Policy for
+        # See https://cloud.google.com/iam/docs/reference/rest/v1/Policy for
         # format details.
         # Corresponds to the JSON property `policyBlob`
         # @return [String]
@@ -285,15 +428,15 @@ module Google
         end
       end
       
-      # Cloud SCC's Notification
+      # Security Command Center's Notification
       class GoogleCloudSecuritycenterV1p1beta1NotificationMessage
         include Google::Apis::Core::Hashable
       
-        # Cloud Security Command Center (Cloud SCC) finding.
+        # Security Command Center finding.
         # A finding is a record of assessment data (security, risk, health or privacy)
-        # ingested into Cloud SCC for presentation, notification, analysis,
-        # policy testing, and enforcement. For example, an XSS vulnerability in an
-        # App Engine application is a finding.
+        # ingested into Security Command Center for presentation, notification,
+        # analysis, policy testing, and enforcement. For example, an XSS vulnerability
+        # in an App Engine application is a finding.
         # Corresponds to the JSON property `finding`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1Finding]
         attr_accessor :finding
@@ -346,8 +489,8 @@ module Google
         end
       end
       
-      # Cloud SCC managed properties. These properties are managed by Cloud SCC and
-      # cannot be modified by the user.
+      # Security Command Center managed properties. These properties are managed by
+      # Security Command Center and cannot be modified by the user.
       class GoogleCloudSecuritycenterV1p1beta1SecurityCenterProperties
         include Google::Apis::Core::Hashable
       
@@ -356,7 +499,7 @@ module Google
         # @return [String]
         attr_accessor :resource_display_name
       
-        # The full resource name of the GCP resource this asset
+        # The full resource name of the Google Cloud resource this asset
         # represents. This field is immutable after create time. See:
         # https://cloud.google.com/apis/design/resource_names#full_resource_name
         # Corresponds to the JSON property `resourceName`
@@ -390,10 +533,10 @@ module Google
         # @return [String]
         attr_accessor :resource_project_display_name
       
-        # The type of the GCP resource. Examples include: APPLICATION,
+        # The type of the Google Cloud resource. Examples include: APPLICATION,
         # PROJECT, and ORGANIZATION. This is a case insensitive field defined by
-        # Cloud SCC and/or the producer of the resource and is immutable
-        # after create time.
+        # Security Command Center and/or the producer of the resource and is
+        # immutable after create time.
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
@@ -415,9 +558,9 @@ module Google
         end
       end
       
-      # User specified security marks that are attached to the parent Cloud Security
-      # Command Center (Cloud SCC) resource. Security marks are scoped within a Cloud
-      # SCC organization -- they can be modified and viewed by all users who have
+      # User specified security marks that are attached to the parent Security
+      # Command Center resource. Security marks are scoped within a Security Command
+      # Center organization -- they can be modified and viewed by all users who have
       # proper permissions on the organization.
       class GoogleCloudSecuritycenterV1p1beta1SecurityMarks
         include Google::Apis::Core::Hashable
@@ -459,11 +602,12 @@ module Google
       class GoogleCloudSecuritycenterV1p1beta1TemporalAsset
         include Google::Apis::Core::Hashable
       
-        # Cloud Security Command Center's (Cloud SCC) representation of a Google Cloud
-        # Platform (GCP) resource.
-        # The Asset is a Cloud SCC resource that captures information about a single
-        # GCP resource. All modifications to an Asset are only within the context of
-        # Cloud SCC and don't affect the referenced GCP resource.
+        # Security Command Center representation of a Google Cloud
+        # resource.
+        # The Asset is a Security Command Center resource that captures information
+        # about a single Google Cloud resource. All modifications to an Asset are only
+        # within the context of Security Command Center and don't affect the referenced
+        # Google Cloud resource.
         # Corresponds to the JSON property `asset`
         # @return [Google::Apis::SecuritycenterV1p1alpha1::GoogleCloudSecuritycenterV1p1beta1Asset]
         attr_accessor :asset
@@ -573,6 +717,45 @@ module Google
         end
       end
       
+      # User specified security marks that are attached to the parent Security
+      # Command Center resource. Security marks are scoped within a Security Command
+      # Center organization -- they can be modified and viewed by all users who have
+      # proper permissions on the organization.
+      class SecurityMarks
+        include Google::Apis::Core::Hashable
+      
+        # Mutable user specified security marks belonging to the parent resource.
+        # Constraints are as follows:
+        # * Keys and values are treated as case insensitive
+        # * Keys must be between 1 - 256 characters (inclusive)
+        # * Keys must be letters, numbers, underscores, or dashes
+        # * Values have leading and trailing whitespace trimmed, remaining
+        # characters must be between 1 - 4096 characters (inclusive)
+        # Corresponds to the JSON property `marks`
+        # @return [Hash<String,String>]
+        attr_accessor :marks
+      
+        # 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".
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @marks = args[:marks] if args.key?(:marks)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # The `Status` type defines a logical error model that is suitable for
       # different programming environments, including REST APIs and RPC APIs. It is
       # used by [gRPC](https://github.com/grpc). Each `Status` message contains

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

@@ -28,6 +28,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Finding
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        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
       
@@ -100,6 +112,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SecurityMarks
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Status
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -112,6 +130,32 @@ module Google
         end
       end
       
+      class Finding
+        # @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::SecuritycenterV1p1alpha1::SecurityMarks, decorator: Google::Apis::SecuritycenterV1p1alpha1::SecurityMarks::Representation
+      
+          hash :source_properties, as: 'sourceProperties'
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleCloudSecuritycenterV1NotificationMessage
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :finding, as: 'finding', class: Google::Apis::SecuritycenterV1p1alpha1::Finding, decorator: Google::Apis::SecuritycenterV1p1alpha1::Finding::Representation
+      
+          property :notification_config_name, as: 'notificationConfigName'
+        end
+      end
+      
       class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -239,6 +283,14 @@ module Google
         end
       end
       
+      class SecurityMarks
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :marks, as: 'marks'
+          property :name, as: 'name'
+        end
+      end
+      
       class Status
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -20,10 +20,10 @@ require 'google/apis/errors'
 module Google
   module Apis
     module SecuritycenterV1p1alpha1
-      # 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_v1p1alpha1'

data/generated/google/apis/securitycenter_v1p1alpha1.rb

@@ -18,15 +18,15 @@ require 'google/apis/securitycenter_v1p1alpha1/representations.rb'
 
 module Google
   module Apis
-    # 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.
     #
     # @see https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
     module SecuritycenterV1p1alpha1
       VERSION = 'V1p1alpha1'
-      REVISION = '20200131'
+      REVISION = '20200406'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'