# Copyright 2015 Google Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. require 'date' require 'google/apis/core/base_service' require 'google/apis/core/json_representation' require 'google/apis/core/hashable' require 'google/apis/errors' module Google module Apis module SecuritycenterV1beta1 # 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. class Asset include Google::Apis::Core::Hashable # The time at which the asset was created in Cloud SCC. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time # The relative resource name of this asset. See: # https://cloud.google.com/apis/design/resource_names#relative_resource_name # Example: # "organizations/123/assets/456". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # Resource managed properties. These properties are managed and defined by # the GCP resource and cannot be modified by the user. # Corresponds to the JSON property `resourceProperties` # @return [Hash] attr_accessor :resource_properties # Cloud SCC managed properties. These properties are managed by Cloud SCC and # cannot be modified by the user. # Corresponds to the JSON property `securityCenterProperties` # @return [Google::Apis::SecuritycenterV1beta1::SecurityCenterProperties] 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 # proper permissions on the organization. # Corresponds to the JSON property `securityMarks` # @return [Google::Apis::SecuritycenterV1beta1::SecurityMarks] attr_accessor :security_marks # The time at which the asset was last updated, added, or deleted in Cloud # SCC. # Corresponds to the JSON property `updateTime` # @return [String] attr_accessor :update_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @create_time = args[:create_time] if args.key?(:create_time) @name = args[:name] if args.key?(:name) @resource_properties = args[:resource_properties] if args.key?(:resource_properties) @security_center_properties = args[:security_center_properties] if args.key?(:security_center_properties) @security_marks = args[:security_marks] if args.key?(:security_marks) @update_time = args[:update_time] if args.key?(:update_time) end end # The configuration used for Asset Discovery runs. class AssetDiscoveryConfig include Google::Apis::Core::Hashable # The mode to use for filtering asset discovery. # Corresponds to the JSON property `inclusionMode` # @return [String] attr_accessor :inclusion_mode # The project ids to use for filtering asset discovery. # Corresponds to the JSON property `projectIds` # @return [Array] attr_accessor :project_ids def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @inclusion_mode = args[:inclusion_mode] if args.key?(:inclusion_mode) @project_ids = args[:project_ids] if args.key?(:project_ids) end end # Specifies the audit configuration for a service. # The configuration determines which permission types are logged, and what # identities, if any, are exempted from logging. # An AuditConfig must have one or more AuditLogConfigs. # If there are AuditConfigs for both `allServices` and a specific service, # the union of the two AuditConfigs is used for that service: the log_types # specified in each AuditConfig are enabled, and the exempted_members in each # AuditLogConfig are exempted. # Example Policy with multiple AuditConfigs: # ` # "audit_configs": [ # ` # "service": "allServices" # "audit_log_configs": [ # ` # "log_type": "DATA_READ", # "exempted_members": [ # "user:foo@gmail.com" # ] # `, # ` # "log_type": "DATA_WRITE", # `, # ` # "log_type": "ADMIN_READ", # ` # ] # `, # ` # "service": "fooservice.googleapis.com" # "audit_log_configs": [ # ` # "log_type": "DATA_READ", # `, # ` # "log_type": "DATA_WRITE", # "exempted_members": [ # "user:bar@gmail.com" # ] # ` # ] # ` # ] # ` # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ # logging. It also exempts foo@gmail.com from DATA_READ logging, and # bar@gmail.com from DATA_WRITE logging. class AuditConfig include Google::Apis::Core::Hashable # The configuration for logging of each type of permission. # Corresponds to the JSON property `auditLogConfigs` # @return [Array] attr_accessor :audit_log_configs # Specifies a service that will be enabled for audit logging. # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. # `allServices` is a special value that covers all services. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @audit_log_configs = args[:audit_log_configs] if args.key?(:audit_log_configs) @service = args[:service] if args.key?(:service) end end # Provides the configuration for logging a type of permissions. # Example: # ` # "audit_log_configs": [ # ` # "log_type": "DATA_READ", # "exempted_members": [ # "user:foo@gmail.com" # ] # `, # ` # "log_type": "DATA_WRITE", # ` # ] # ` # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting # foo@gmail.com from DATA_READ logging. class AuditLogConfig include Google::Apis::Core::Hashable # Specifies the identities that do not cause logging for this type of # permission. # Follows the same format of Binding.members. # Corresponds to the JSON property `exemptedMembers` # @return [Array] attr_accessor :exempted_members # The log type that this config enables. # Corresponds to the JSON property `logType` # @return [String] attr_accessor :log_type def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @exempted_members = args[:exempted_members] if args.key?(:exempted_members) @log_type = args[:log_type] if args.key?(:log_type) end end # Associates `members` with a `role`. class Binding include Google::Apis::Core::Hashable # Represents an expression text. Example: # title: "User account presence" # description: "Determines whether the request has a user account" # expression: "size(request.user) > 0" # Corresponds to the JSON property `condition` # @return [Google::Apis::SecuritycenterV1beta1::Expr] attr_accessor :condition # Specifies the identities requesting access for a Cloud Platform resource. # `members` can have the following values: # * `allUsers`: A special identifier that represents anyone who is # on the internet; with or without a Google account. # * `allAuthenticatedUsers`: A special identifier that represents anyone # who is authenticated with a Google account or a service account. # * `user:`emailid``: An email address that represents a specific Google # account. For example, `alice@gmail.com` . # * `serviceAccount:`emailid``: An email address that represents a service # account. For example, `my-other-app@appspot.gserviceaccount.com`. # * `group:`emailid``: An email address that represents a Google group. # For example, `admins@example.com`. # * `domain:`domain``: The G Suite domain (primary) that represents all the # users of that domain. For example, `google.com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members # Role that is assigned to `members`. # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @condition = args[:condition] if args.key?(:condition) @members = args[:members] if args.key?(:members) @role = args[:role] if args.key?(:role) end end # The request message for Operations.CancelOperation. class CancelOperationRequest include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # A generic empty message that you can re-use to avoid defining duplicated # empty messages in your APIs. A typical example is to use it as the request # or the response type of an API method. For instance: # service Foo ` # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); # ` # The JSON representation for `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # Represents an expression text. Example: # title: "User account presence" # description: "Determines whether the request has a user account" # expression: "size(request.user) > 0" class Expr include Google::Apis::Core::Hashable # An optional description of the expression. This is a longer text which # describes the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description # Textual representation of an expression in # Common Expression Language syntax. # The application context of the containing message determines which # well-known feature set of CEL is supported. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression # An optional string indicating the location of the expression for error # reporting, e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location # An optional title for the expression, i.e. a short string describing # its purpose. This can be used e.g. in UIs which allow to enter the # expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @description = args[:description] if args.key?(:description) @expression = args[:expression] if args.key?(:expression) @location = args[:location] if args.key?(:location) @title = args[:title] if args.key?(:title) end end # Cloud Security Command Center (Cloud SCC) 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. 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 Cloud SCC. # 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 open firewall was # detected. # Corresponds to the JSON property `eventTime` # @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. # 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/123/sources/456/findings/789" # 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/123/sources/456" # Corresponds to the JSON property `parent` # @return [String] attr_accessor :parent # The full resource name of the Google Cloud Platform (GCP) resource this # finding is for. See: # https://cloud.google.com/apis/design/resource_names#full_resource_name # 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 # proper permissions on the organization. # Corresponds to the JSON property `securityMarks` # @return [Google::Apis::SecuritycenterV1beta1::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] 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 # Request message for `GetIamPolicy` method. class GetIamPolicyRequest include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # Response of asset discovery run class GoogleCloudSecuritycenterV1RunAssetDiscoveryResponse include Google::Apis::Core::Hashable # The duration between asset discovery run start and end # Corresponds to the JSON property `duration` # @return [String] attr_accessor :duration # The state of an asset discovery run. # 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) @duration = args[:duration] if args.key?(:duration) @state = args[:state] if args.key?(:state) end end # Response of asset discovery run class GoogleCloudSecuritycenterV1beta1RunAssetDiscoveryResponse include Google::Apis::Core::Hashable # The duration between asset discovery run start and end # Corresponds to the JSON property `duration` # @return [String] attr_accessor :duration # The state of an asset discovery run. # 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) @duration = args[:duration] if args.key?(:duration) @state = args[:state] if args.key?(:state) end end # Request message for grouping by assets. class GroupAssetsRequest include Google::Apis::Core::Hashable # When compare_duration is set, the Asset's "state" property 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 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" values when compare_duration is specified: # * "ADDED": indicates that the asset was not present before # compare_duration, but present at reference_time. # * "REMOVED": indicates that the asset was present at the start of # compare_duration, but not present at reference_time. # * "ACTIVE": indicates that the asset was present at both the # start and the end of the time period defined by # compare_duration and reference_time. # This field is ignored if `state` is not a field in `group_by`. # Corresponds to the JSON property `compareDuration` # @return [String] attr_accessor :compare_duration # 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 not 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. # For example, `resource_properties.size = 100` is a valid filter string. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter # Expression that defines what assets fields to use for grouping. The string # value should follow SQL syntax: comma separated list of fields. For # example: # "security_center_properties.resource_project,security_center_properties. # project". # The following fields are supported when compare_duration is not set: # * security_center_properties.resource_project # * security_center_properties.resource_type # * security_center_properties.resource_parent # The following fields are supported when compare_duration is set: # * security_center_properties.resource_type # Corresponds to the JSON property `groupBy` # @return [String] attr_accessor :group_by # The maximum number of results to return in a single response. Default is # 10, minimum is 1, maximum is 1000. # Corresponds to the JSON property `pageSize` # @return [Fixnum] attr_accessor :page_size # The value returned by the last `GroupAssetsResponse`; indicates # that this is a continuation of a prior `GroupAssets` call, and that the # system should return the next page of data. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token # 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. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @compare_duration = args[:compare_duration] if args.key?(:compare_duration) @filter = args[:filter] if args.key?(:filter) @group_by = args[:group_by] if args.key?(:group_by) @page_size = args[:page_size] if args.key?(:page_size) @page_token = args[:page_token] if args.key?(:page_token) @read_time = args[:read_time] if args.key?(:read_time) end end # Response message for grouping by assets. class GroupAssetsResponse include Google::Apis::Core::Hashable # Group results. There exists an element for each existing unique # combination of property/values. The element contains a count for the number # of times those specific property/values appear. # Corresponds to the JSON property `groupByResults` # @return [Array] attr_accessor :group_by_results # Token to retrieve the next page of results, or empty if there are no more # results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # Time used for executing the groupBy request. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @group_by_results = args[:group_by_results] if args.key?(:group_by_results) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @read_time = args[:read_time] if args.key?(:read_time) end end # Request message for grouping by findings. class GroupFindingsRequest include Google::Apis::Core::Hashable # 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 not 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. # For example, `source_properties.size = 100` is a valid filter string. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter # Expression that defines what assets fields to use for grouping (including # `state`). The string value should follow SQL syntax: comma separated list # of fields. For example: # "parent,resource_name". # The following fields are supported: # * resource_name # * category # * state # * parent # Corresponds to the JSON property `groupBy` # @return [String] attr_accessor :group_by # The maximum number of results to return in a single response. Default is # 10, minimum is 1, maximum is 1000. # Corresponds to the JSON property `pageSize` # @return [Fixnum] attr_accessor :page_size # The value returned by the last `GroupFindingsResponse`; indicates # that this is a continuation of a prior `GroupFindings` call, and # that the system should return the next page of data. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token # 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. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @filter = args[:filter] if args.key?(:filter) @group_by = args[:group_by] if args.key?(:group_by) @page_size = args[:page_size] if args.key?(:page_size) @page_token = args[:page_token] if args.key?(:page_token) @read_time = args[:read_time] if args.key?(:read_time) end end # Response message for group by findings. class GroupFindingsResponse include Google::Apis::Core::Hashable # Group results. There exists an element for each existing unique # combination of property/values. The element contains a count for the number # of times those specific property/values appear. # Corresponds to the JSON property `groupByResults` # @return [Array] attr_accessor :group_by_results # Token to retrieve the next page of results, or empty if there are no more # results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # Time used for executing the groupBy request. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @group_by_results = args[:group_by_results] if args.key?(:group_by_results) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @read_time = args[:read_time] if args.key?(:read_time) end end # Result containing the properties and count of a groupBy request. class GroupResult include Google::Apis::Core::Hashable # Total count of resources for the given properties. # Corresponds to the JSON property `count` # @return [Fixnum] attr_accessor :count # Properties matching the groupBy fields in the request. # Corresponds to the JSON property `properties` # @return [Hash] attr_accessor :properties def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @count = args[:count] if args.key?(:count) @properties = args[:properties] if args.key?(:properties) end end # Response message for listing assets. class ListAssetsResponse include Google::Apis::Core::Hashable # Assets matching the list request. # Corresponds to the JSON property `listAssetsResults` # @return [Array] attr_accessor :list_assets_results # Token to retrieve the next page of results, or empty if there are no more # results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # Time used for executing the list request. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time # The total number of assets matching the query. # Corresponds to the JSON property `totalSize` # @return [Fixnum] attr_accessor :total_size def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @list_assets_results = args[:list_assets_results] if args.key?(:list_assets_results) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @read_time = args[:read_time] if args.key?(:read_time) @total_size = args[:total_size] if args.key?(:total_size) end end # Result containing the Asset and its State. class ListAssetsResult 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. # Corresponds to the JSON property `asset` # @return [Google::Apis::SecuritycenterV1beta1::Asset] attr_accessor :asset # State of the asset. # 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) @asset = args[:asset] if args.key?(:asset) @state = args[:state] if args.key?(:state) end end # Response message for listing findings. class ListFindingsResponse include Google::Apis::Core::Hashable # Findings matching the list request. # Corresponds to the JSON property `findings` # @return [Array] attr_accessor :findings # Token to retrieve the next page of results, or empty if there are no more # results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # Time used for executing the list request. # Corresponds to the JSON property `readTime` # @return [String] attr_accessor :read_time # The total number of findings matching the query. # Corresponds to the JSON property `totalSize` # @return [Fixnum] attr_accessor :total_size def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @findings = args[:findings] if args.key?(:findings) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @read_time = args[:read_time] if args.key?(:read_time) @total_size = args[:total_size] if args.key?(:total_size) end end # The response message for Operations.ListOperations. class ListOperationsResponse include Google::Apis::Core::Hashable # The standard List next-page token. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # A list of operations that matches the specified filter in the request. # Corresponds to the JSON property `operations` # @return [Array] attr_accessor :operations def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @operations = args[:operations] if args.key?(:operations) end end # Response message for listing sources. class ListSourcesResponse include Google::Apis::Core::Hashable # Token to retrieve the next page of results, or empty if there are no more # results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token # Sources belonging to the requested parent. # Corresponds to the JSON property `sources` # @return [Array] attr_accessor :sources def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @next_page_token = args[:next_page_token] if args.key?(:next_page_token) @sources = args[:sources] if args.key?(:sources) end end # This resource represents a long-running operation that is the result of a # network API call. class Operation include Google::Apis::Core::Hashable # If the value is `false`, it means the operation is still in progress. # If `true`, the operation is completed, and either `error` or `response` is # available. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done # 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). The error model is designed to be: # - Simple to use and understand for most users # - Flexible enough to meet unexpected needs # # Overview # The `Status` message contains three pieces of data: error code, error # message, and error details. The error code should be an enum value of # google.rpc.Code, but it may accept additional error codes if needed. The # error message should be a developer-facing English message that helps # developers *understand* and *resolve* the error. If a localized user-facing # error message is needed, put the localized message in the error details or # localize it in the client. The optional error details may contain arbitrary # information about the error. There is a predefined set of error detail types # in the package `google.rpc` that can be used for common error conditions. # # Language mapping # The `Status` message is the logical representation of the error model, but it # is not necessarily the actual wire format. When the `Status` message is # exposed in different client libraries and different wire protocols, it can be # mapped differently. For example, it will likely be mapped to some exceptions # in Java, but more likely mapped to some error codes in C. # # Other uses # The error model and the `Status` message can be used in a variety of # environments, either with or without APIs, to provide a # consistent developer experience across different environments. # Example uses of this error model include: # - Partial errors. If a service needs to return partial errors to the client, # it may embed the `Status` in the normal response to indicate the partial # errors. # - Workflow errors. A typical workflow has multiple steps. Each step may # have a `Status` message for error reporting. # - Batch operations. If a client uses batch request and batch response, the # `Status` message should be used directly inside batch response, one for # each error sub-response. # - Asynchronous operations. If an API call embeds asynchronous operation # results in its response, the status of those operations should be # represented directly using the `Status` message. # - Logging. If some API errors are stored in logs, the message `Status` could # be used directly after any stripping needed for security/privacy reasons. # Corresponds to the JSON property `error` # @return [Google::Apis::SecuritycenterV1beta1::Status] attr_accessor :error # Service-specific metadata associated with the operation. It typically # contains progress information and common metadata such as create time. # Some services might not provide such metadata. Any method that returns a # long-running operation should document the metadata type, if any. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # The server-assigned name, which is only unique within the same service that # originally returns it. If you use the default HTTP mapping, the # `name` should be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # The normal response of the operation in case of success. If the original # method returns no data on success, such as `Delete`, the response is # `google.protobuf.Empty`. If the original method is standard # `Get`/`Create`/`Update`, the response should be the resource. For other # methods, the response should have the type `XxxResponse`, where `Xxx` # is the original method name. For example, if the original method name # is `TakeSnapshot()`, the inferred response type is # `TakeSnapshotResponse`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @done = args[:done] if args.key?(:done) @error = args[:error] if args.key?(:error) @metadata = args[:metadata] if args.key?(:metadata) @name = args[:name] if args.key?(:name) @response = args[:response] if args.key?(:response) end end # User specified settings that are attached to the Cloud Security Command # Center (Cloud SCC) organization. class OrganizationSettings include Google::Apis::Core::Hashable # The configuration used for Asset Discovery runs. # Corresponds to the JSON property `assetDiscoveryConfig` # @return [Google::Apis::SecuritycenterV1beta1::AssetDiscoveryConfig] attr_accessor :asset_discovery_config # A flag that indicates if Asset Discovery should be enabled. If the flag is # set to `true`, then discovery of assets will occur. If it is set to `false, # all historical assets will remain, but discovery of future assets will not # occur. # Corresponds to the JSON property `enableAssetDiscovery` # @return [Boolean] attr_accessor :enable_asset_discovery alias_method :enable_asset_discovery?, :enable_asset_discovery # The relative resource name of the settings. See: # https://cloud.google.com/apis/design/resource_names#relative_resource_name # Example: # "organizations/123/organizationSettings". # 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) @asset_discovery_config = args[:asset_discovery_config] if args.key?(:asset_discovery_config) @enable_asset_discovery = args[:enable_asset_discovery] if args.key?(:enable_asset_discovery) @name = args[:name] if args.key?(:name) end end # Defines an Identity and Access Management (IAM) policy. It is used to # specify access control policies for Cloud Platform resources. # A `Policy` consists of a list of `bindings`. A `binding` binds a list of # `members` to a `role`, where the members can be user accounts, Google groups, # Google domains, and service accounts. A `role` is a named list of permissions # defined by IAM. # **JSON Example** # ` # "bindings": [ # ` # "role": "roles/owner", # "members": [ # "user:mike@example.com", # "group:admins@example.com", # "domain:google.com", # "serviceAccount:my-other-app@appspot.gserviceaccount.com" # ] # `, # ` # "role": "roles/viewer", # "members": ["user:sean@example.com"] # ` # ] # ` # **YAML Example** # bindings: # - members: # - user:mike@example.com # - group:admins@example.com # - domain:google.com # - serviceAccount:my-other-app@appspot.gserviceaccount.com # role: roles/owner # - members: # - user:sean@example.com # role: roles/viewer # For a description of IAM and its features, see the # [IAM developer's guide](https://cloud.google.com/iam/docs). class Policy include Google::Apis::Core::Hashable # Specifies cloud audit logging configuration for this policy. # Corresponds to the JSON property `auditConfigs` # @return [Array] attr_accessor :audit_configs # Associates a list of `members` to a `role`. # `bindings` with no members will result in an error. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings # `etag` is used for optimistic concurrency control as a way to help # prevent simultaneous updates of a policy from overwriting each other. # It is strongly suggested that systems make use of the `etag` in the # read-modify-write cycle to perform policy updates in order to avoid race # conditions: An `etag` is returned in the response to `getIamPolicy`, and # systems are expected to put that etag in the request to `setIamPolicy` to # ensure that their change will be applied to the same version of the policy. # If no `etag` is provided in the call to `setIamPolicy`, then the existing # policy is overwritten blindly. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag # Deprecated. # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @audit_configs = args[:audit_configs] if args.key?(:audit_configs) @bindings = args[:bindings] if args.key?(:bindings) @etag = args[:etag] if args.key?(:etag) @version = args[:version] if args.key?(:version) end end # Request message for running asset discovery for an organization. class RunAssetDiscoveryRequest include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # Cloud SCC managed properties. These properties are managed by Cloud SCC and # cannot be modified by the user. class SecurityCenterProperties include Google::Apis::Core::Hashable # The full resource name of the GCP 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` # @return [String] attr_accessor :resource_name # Owners of the Google Cloud resource. # Corresponds to the JSON property `resourceOwners` # @return [Array] attr_accessor :resource_owners # The full resource name of the immediate parent of the resource. See: # https://cloud.google.com/apis/design/resource_names#full_resource_name # Corresponds to the JSON property `resourceParent` # @return [String] attr_accessor :resource_parent # The full resource name of the project the resource belongs to. See: # https://cloud.google.com/apis/design/resource_names#full_resource_name # Corresponds to the JSON property `resourceProject` # @return [String] attr_accessor :resource_project # The type of the GCP 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. # Corresponds to the JSON property `resourceType` # @return [String] attr_accessor :resource_type def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @resource_name = args[:resource_name] if args.key?(:resource_name) @resource_owners = args[:resource_owners] if args.key?(:resource_owners) @resource_parent = args[:resource_parent] if args.key?(:resource_parent) @resource_project = args[:resource_project] if args.key?(:resource_project) @resource_type = args[:resource_type] if args.key?(:resource_type) 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 # 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] attr_accessor :marks # 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". # 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 # Request message for updating a finding's state. class SetFindingStateRequest include Google::Apis::Core::Hashable # The time at which the updated state takes effect. # Corresponds to the JSON property `startTime` # @return [String] attr_accessor :start_time # The desired 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) @start_time = args[:start_time] if args.key?(:start_time) @state = args[:state] if args.key?(:state) end end # Request message for `SetIamPolicy` method. class SetIamPolicyRequest include Google::Apis::Core::Hashable # Defines an Identity and Access Management (IAM) policy. It is used to # specify access control policies for Cloud Platform resources. # A `Policy` consists of a list of `bindings`. A `binding` binds a list of # `members` to a `role`, where the members can be user accounts, Google groups, # Google domains, and service accounts. A `role` is a named list of permissions # defined by IAM. # **JSON Example** # ` # "bindings": [ # ` # "role": "roles/owner", # "members": [ # "user:mike@example.com", # "group:admins@example.com", # "domain:google.com", # "serviceAccount:my-other-app@appspot.gserviceaccount.com" # ] # `, # ` # "role": "roles/viewer", # "members": ["user:sean@example.com"] # ` # ] # ` # **YAML Example** # bindings: # - members: # - user:mike@example.com # - group:admins@example.com # - domain:google.com # - serviceAccount:my-other-app@appspot.gserviceaccount.com # role: roles/owner # - members: # - user:sean@example.com # role: roles/viewer # For a description of IAM and its features, see the # [IAM developer's guide](https://cloud.google.com/iam/docs). # Corresponds to the JSON property `policy` # @return [Google::Apis::SecuritycenterV1beta1::Policy] attr_accessor :policy # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only # the fields in the mask will be modified. If no mask is provided, the # following default mask is used: # paths: "bindings, etag" # This field is only used by Cloud IAM. # Corresponds to the JSON property `updateMask` # @return [String] attr_accessor :update_mask def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @policy = args[:policy] if args.key?(:policy) @update_mask = args[:update_mask] if args.key?(:update_mask) end end # Cloud Security Command Center's (Cloud SCC) finding source. A finding source # is an entity or a mechanism that can produce a finding. A source is like a # container of findings that come from the same scanner, logger, monitor, etc. class Source include Google::Apis::Core::Hashable # The description of the source (max of 1024 characters). # Example: # "Cloud Security Scanner is a web security scanner for common # vulnerabilities in App Engine applications. It can automatically # scan and detect four common vulnerabilities, including cross-site-scripting # (XSS), Flash injection, mixed content (HTTP in HTTPS), and # outdated/insecure libraries." # Corresponds to the JSON property `description` # @return [String] attr_accessor :description # The source’s display name. # A source’s display name must be unique amongst its siblings, for example, # two sources with the same parent can't share the same display name. # The display name must start and end with a letter or digit, may contain # letters, digits, spaces, hyphens, and underscores, and can be no longer # than 32 characters. This is captured by the regular expression: # [\p`L`\p`N`](`\p`L`\p`N`_- ]`0,30`[\p`L`\p`N`])?. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name # The relative resource name of this source. See: # https://cloud.google.com/apis/design/resource_names#relative_resource_name # Example: # "organizations/123/sources/456" # 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) @description = args[:description] if args.key?(:description) @display_name = args[:display_name] if args.key?(:display_name) @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). The error model is designed to be: # - Simple to use and understand for most users # - Flexible enough to meet unexpected needs # # Overview # The `Status` message contains three pieces of data: error code, error # message, and error details. The error code should be an enum value of # google.rpc.Code, but it may accept additional error codes if needed. The # error message should be a developer-facing English message that helps # developers *understand* and *resolve* the error. If a localized user-facing # error message is needed, put the localized message in the error details or # localize it in the client. The optional error details may contain arbitrary # information about the error. There is a predefined set of error detail types # in the package `google.rpc` that can be used for common error conditions. # # Language mapping # The `Status` message is the logical representation of the error model, but it # is not necessarily the actual wire format. When the `Status` message is # exposed in different client libraries and different wire protocols, it can be # mapped differently. For example, it will likely be mapped to some exceptions # in Java, but more likely mapped to some error codes in C. # # Other uses # The error model and the `Status` message can be used in a variety of # environments, either with or without APIs, to provide a # consistent developer experience across different environments. # Example uses of this error model include: # - Partial errors. If a service needs to return partial errors to the client, # it may embed the `Status` in the normal response to indicate the partial # errors. # - Workflow errors. A typical workflow has multiple steps. Each step may # have a `Status` message for error reporting. # - Batch operations. If a client uses batch request and batch response, the # `Status` message should be used directly inside batch response, one for # each error sub-response. # - Asynchronous operations. If an API call embeds asynchronous operation # results in its response, the status of those operations should be # represented directly using the `Status` message. # - Logging. If some API errors are stored in logs, the message `Status` could # be used directly after any stripping needed for security/privacy reasons. class Status include Google::Apis::Core::Hashable # The status code, which should be an enum value of google.rpc.Code. # Corresponds to the JSON property `code` # @return [Fixnum] attr_accessor :code # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details # A developer-facing error message, which should be in English. Any # user-facing error message should be localized and sent in the # google.rpc.Status.details field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @code = args[:code] if args.key?(:code) @details = args[:details] if args.key?(:details) @message = args[:message] if args.key?(:message) end end # Request message for `TestIamPermissions` method. class TestIamPermissionsRequest include Google::Apis::Core::Hashable # The set of permissions to check for the `resource`. Permissions with # wildcards (such as '*' or 'storage.*') are not allowed. For more # information see # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @permissions = args[:permissions] if args.key?(:permissions) end end # Response message for `TestIamPermissions` method. class TestIamPermissionsResponse include Google::Apis::Core::Hashable # A subset of `TestPermissionsRequest.permissions` that the caller is # allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @permissions = args[:permissions] if args.key?(:permissions) end end end end end