google-api-client 0.39.4 → 0.41.0

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

@@ -502,6 +502,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Detaches a subscription from this topic. All messages retained in the
+        # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests
+        # will return FAILED_PRECONDITION. If the subscription is a push
+        # subscription, pushes to the endpoint will stop.
+        # @param [String] subscription
+        #   Required. The subscription to detach.
+        #   Format is `projects/`project`/subscriptions/`subscription``.
+        # @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::PubsubV1::DetachSubscriptionResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::DetachSubscriptionResponse]
+        #
+        # @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 detach_project_subscription(subscription, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+subscription}:detach', options)
+          command.response_representation = Google::Apis::PubsubV1::DetachSubscriptionResponse::Representation
+          command.response_class = Google::Apis::PubsubV1::DetachSubscriptionResponse
+          command.params['subscription'] = subscription unless subscription.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 the configuration details of a subscription.
         # @param [String] subscription
         #   Required. The name of the subscription to get.
@@ -1264,7 +1298,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the names of the subscriptions on this topic.
+        # Lists the names of the attached subscriptions on this topic.
         # @param [String] topic
         #   Required. The name of the topic that subscriptions are attached to.
         #   Format is `projects/`project`/topics/`topic``.

data/generated/google/apis/{customsearch_v1.rb → recommender_v1.rb}

@@ -12,20 +12,23 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'google/apis/customsearch_v1/service.rb'
-require 'google/apis/customsearch_v1/classes.rb'
-require 'google/apis/customsearch_v1/representations.rb'
+require 'google/apis/recommender_v1/service.rb'
+require 'google/apis/recommender_v1/classes.rb'
+require 'google/apis/recommender_v1/representations.rb'
 
 module Google
   module Apis
-    # Custom Search API
+    # Recommender API
     #
-    # Searches over a website or collection of websites
+    # 
     #
-    # @see https://developers.google.com/custom-search/v1/introduction
-    module CustomsearchV1
+    # @see https://cloud.google.com/recommender/docs/
+    module RecommenderV1
       VERSION = 'V1'
-      REVISION = '20200504'
+      REVISION = '20200516'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end
 end

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

@@ -0,0 +1,505 @@
+# 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 RecommenderV1
+      
+      # Contains metadata about how much money a recommendation can save or incur.
+      class GoogleCloudRecommenderV1CostProjection
+        include Google::Apis::Core::Hashable
+      
+        # Represents an amount of money with its currency type.
+        # Corresponds to the JSON property `cost`
+        # @return [Google::Apis::RecommenderV1::GoogleTypeMoney]
+        attr_accessor :cost
+      
+        # Duration for which this cost applies.
+        # Corresponds to the JSON property `duration`
+        # @return [String]
+        attr_accessor :duration
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cost = args[:cost] if args.key?(:cost)
+          @duration = args[:duration] if args.key?(:duration)
+        end
+      end
+      
+      # Contains the impact a recommendation can have for a given category.
+      class GoogleCloudRecommenderV1Impact
+        include Google::Apis::Core::Hashable
+      
+        # Category that is being targeted.
+        # Corresponds to the JSON property `category`
+        # @return [String]
+        attr_accessor :category
+      
+        # Contains metadata about how much money a recommendation can save or incur.
+        # Corresponds to the JSON property `costProjection`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1CostProjection]
+        attr_accessor :cost_projection
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @category = args[:category] if args.key?(:category)
+          @cost_projection = args[:cost_projection] if args.key?(:cost_projection)
+        end
+      end
+      
+      # Response to the `ListRecommendations` method.
+      class GoogleCloudRecommenderV1ListRecommendationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A token that can be used to request the next page of results. This field is
+        # empty if there are no additional results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The set of recommendations for the `parent` resource.
+        # Corresponds to the JSON property `recommendations`
+        # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation>]
+        attr_accessor :recommendations
+      
+        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)
+          @recommendations = args[:recommendations] if args.key?(:recommendations)
+        end
+      end
+      
+      # Request for the `MarkRecommendationClaimed` Method.
+      class GoogleCloudRecommenderV1MarkRecommendationClaimedRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Fingerprint of the Recommendation. Provides optimistic locking.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # State properties to include with this state. Overwrites any existing
+        # `state_metadata`.
+        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
+        # Corresponds to the JSON property `stateMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :state_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @state_metadata = args[:state_metadata] if args.key?(:state_metadata)
+        end
+      end
+      
+      # Request for the `MarkRecommendationFailed` Method.
+      class GoogleCloudRecommenderV1MarkRecommendationFailedRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Fingerprint of the Recommendation. Provides optimistic locking.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # State properties to include with this state. Overwrites any existing
+        # `state_metadata`.
+        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
+        # Corresponds to the JSON property `stateMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :state_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @state_metadata = args[:state_metadata] if args.key?(:state_metadata)
+        end
+      end
+      
+      # Request for the `MarkRecommendationSucceeded` Method.
+      class GoogleCloudRecommenderV1MarkRecommendationSucceededRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Fingerprint of the Recommendation. Provides optimistic locking.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # State properties to include with this state. Overwrites any existing
+        # `state_metadata`.
+        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
+        # Corresponds to the JSON property `stateMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :state_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @state_metadata = args[:state_metadata] if args.key?(:state_metadata)
+        end
+      end
+      
+      # Contains an operation for a resource loosely based on the JSON-PATCH format
+      # with support for:
+      # * Custom filters for describing partial array patch.
+      # * Extended path values for describing nested arrays.
+      # * Custom fields for describing the resource for which the operation is being
+      # described.
+      # * Allows extension to custom operations not natively supported by RFC6902.
+      # See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
+      class GoogleCloudRecommenderV1Operation
+        include Google::Apis::Core::Hashable
+      
+        # Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
+        # 'copy', 'test' and custom operations. This field is case-insensitive and
+        # always populated.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+      
+        # Path to the target field being operated on. If the operation is at the
+        # resource level, then path should be "/". This field is always populated.
+        # Corresponds to the JSON property `path`
+        # @return [String]
+        attr_accessor :path
+      
+        # Set of filters to apply if `path` refers to array elements or nested array
+        # elements in order to narrow down to a single unique element that is being
+        # tested/modified.
+        # This is intended to be an exact match per filter. To perform advanced
+        # matching, use path_value_matchers.
+        # * Example: `
+        # "/versions/*/name" : "it-123"
+        # "/versions/*/targetSize/percent": 20
+        # `
+        # * Example: `
+        # "/bindings/*/role": "roles/admin"
+        # "/bindings/*/condition" : null
+        # `
+        # * Example: `
+        # "/bindings/*/role": "roles/admin"
+        # "/bindings/*/members/*" : ["x@google.com", "y@google.com"]
+        # `
+        # When both path_filters and path_value_matchers are set, an implicit AND
+        # must be performed.
+        # Corresponds to the JSON property `pathFilters`
+        # @return [Hash<String,Object>]
+        attr_accessor :path_filters
+      
+        # Similar to path_filters, this contains set of filters to apply if `path`
+        # field referes to array elements. This is meant to support value matching
+        # beyond exact match. To perform exact match, use path_filters.
+        # When both path_filters and path_value_matchers are set, an implicit AND
+        # must be performed.
+        # Corresponds to the JSON property `pathValueMatchers`
+        # @return [Hash<String,Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ValueMatcher>]
+        attr_accessor :path_value_matchers
+      
+        # Contains the fully qualified resource name. This field is always populated.
+        # ex: //cloudresourcemanager.googleapis.com/projects/foo.
+        # Corresponds to the JSON property `resource`
+        # @return [String]
+        attr_accessor :resource
+      
+        # Type of GCP resource being modified/tested. This field is always populated.
+        # Example: cloudresourcemanager.googleapis.com/Project,
+        # compute.googleapis.com/Instance
+        # Corresponds to the JSON property `resourceType`
+        # @return [String]
+        attr_accessor :resource_type
+      
+        # Can be set with action 'copy' or 'move' to indicate the source field within
+        # resource or source_resource, ignored if provided for other operation types.
+        # Corresponds to the JSON property `sourcePath`
+        # @return [String]
+        attr_accessor :source_path
+      
+        # Can be set with action 'copy' to copy resource configuration across
+        # different resources of the same type. Example: A resource clone can be
+        # done via action = 'copy', path = "/", from = "/",
+        # source_resource = <source> and resource_name = <target>.
+        # This field is empty for all other values of `action`.
+        # Corresponds to the JSON property `sourceResource`
+        # @return [String]
+        attr_accessor :source_resource
+      
+        # Value for the `path` field. Will be set for actions:'add'/'replace'.
+        # Maybe set for action: 'test'. Either this or `value_matcher` will be set
+        # for 'test' operation. An exact match must be performed.
+        # Corresponds to the JSON property `value`
+        # @return [Object]
+        attr_accessor :value
+      
+        # Contains various matching options for values for a GCP resource field.
+        # Corresponds to the JSON property `valueMatcher`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ValueMatcher]
+        attr_accessor :value_matcher
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @path = args[:path] if args.key?(:path)
+          @path_filters = args[:path_filters] if args.key?(:path_filters)
+          @path_value_matchers = args[:path_value_matchers] if args.key?(:path_value_matchers)
+          @resource = args[:resource] if args.key?(:resource)
+          @resource_type = args[:resource_type] if args.key?(:resource_type)
+          @source_path = args[:source_path] if args.key?(:source_path)
+          @source_resource = args[:source_resource] if args.key?(:source_resource)
+          @value = args[:value] if args.key?(:value)
+          @value_matcher = args[:value_matcher] if args.key?(:value_matcher)
+        end
+      end
+      
+      # Group of operations that need to be performed atomically.
+      class GoogleCloudRecommenderV1OperationGroup
+        include Google::Apis::Core::Hashable
+      
+        # List of operations across one or more resources that belong to this group.
+        # Loosely based on RFC6902 and should be performed in the order they appear.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Operation>]
+        attr_accessor :operations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      end
+      
+      # A recommendation along with a suggested action. E.g., a rightsizing
+      # recommendation for an underutilized VM, IAM role recommendations, etc
+      class GoogleCloudRecommenderV1Recommendation
+        include Google::Apis::Core::Hashable
+      
+        # Optional set of additional impact that this recommendation may have when
+        # trying to optimize for the primary category. These may be positive
+        # or negative.
+        # Corresponds to the JSON property `additionalImpact`
+        # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact>]
+        attr_accessor :additional_impact
+      
+        # Contains what resources are changing and how they are changing.
+        # Corresponds to the JSON property `content`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1RecommendationContent]
+        attr_accessor :content
+      
+        # Free-form human readable summary in English. The maximum length is 500
+        # characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Fingerprint of the Recommendation. Provides optimistic locking when
+        # updating states.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Last time this recommendation was refreshed by the system that created it
+        # in the first place.
+        # Corresponds to the JSON property `lastRefreshTime`
+        # @return [String]
+        attr_accessor :last_refresh_time
+      
+        # Name of recommendation.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Contains the impact a recommendation can have for a given category.
+        # Corresponds to the JSON property `primaryImpact`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact]
+        attr_accessor :primary_impact
+      
+        # Contains an identifier for a subtype of recommendations produced for the
+        # same recommender. Subtype is a function of content and impact, meaning a
+        # new subtype might be added when significant changes to `content` or
+        # `primary_impact.category` are introduced. See the Recommenders section
+        # to see a list of subtypes for a given Recommender.
+        # Examples:
+        # For recommender = "google.iam.policy.Recommender",
+        # recommender_subtype can be one of "REMOVE_ROLE"/"REPLACE_ROLE"
+        # Corresponds to the JSON property `recommenderSubtype`
+        # @return [String]
+        attr_accessor :recommender_subtype
+      
+        # Information for state. Contains state and metadata.
+        # Corresponds to the JSON property `stateInfo`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1RecommendationStateInfo]
+        attr_accessor :state_info
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_impact = args[:additional_impact] if args.key?(:additional_impact)
+          @content = args[:content] if args.key?(:content)
+          @description = args[:description] if args.key?(:description)
+          @etag = args[:etag] if args.key?(:etag)
+          @last_refresh_time = args[:last_refresh_time] if args.key?(:last_refresh_time)
+          @name = args[:name] if args.key?(:name)
+          @primary_impact = args[:primary_impact] if args.key?(:primary_impact)
+          @recommender_subtype = args[:recommender_subtype] if args.key?(:recommender_subtype)
+          @state_info = args[:state_info] if args.key?(:state_info)
+        end
+      end
+      
+      # Contains what resources are changing and how they are changing.
+      class GoogleCloudRecommenderV1RecommendationContent
+        include Google::Apis::Core::Hashable
+      
+        # Operations to one or more Google Cloud resources grouped in such a way
+        # that, all operations within one group are expected to be performed
+        # atomically and in an order.
+        # Corresponds to the JSON property `operationGroups`
+        # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1OperationGroup>]
+        attr_accessor :operation_groups
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @operation_groups = args[:operation_groups] if args.key?(:operation_groups)
+        end
+      end
+      
+      # Information for state. Contains state and metadata.
+      class GoogleCloudRecommenderV1RecommendationStateInfo
+        include Google::Apis::Core::Hashable
+      
+        # The state of the recommendation, Eg ACTIVE, SUCCEEDED, FAILED.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # A map of metadata for the state, provided by user or automations systems.
+        # Corresponds to the JSON property `stateMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :state_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @state = args[:state] if args.key?(:state)
+          @state_metadata = args[:state_metadata] if args.key?(:state_metadata)
+        end
+      end
+      
+      # Contains various matching options for values for a GCP resource field.
+      class GoogleCloudRecommenderV1ValueMatcher
+        include Google::Apis::Core::Hashable
+      
+        # To be used for full regex matching. The regular expression is using the
+        # Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
+        # used with RE2::FullMatch
+        # Corresponds to the JSON property `matchesPattern`
+        # @return [String]
+        attr_accessor :matches_pattern
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @matches_pattern = args[:matches_pattern] if args.key?(:matches_pattern)
+        end
+      end
+      
+      # Represents an amount of money with its currency type.
+      class GoogleTypeMoney
+        include Google::Apis::Core::Hashable
+      
+        # The 3-letter currency code defined in ISO 4217.
+        # Corresponds to the JSON property `currencyCode`
+        # @return [String]
+        attr_accessor :currency_code
+      
+        # Number of nano (10^-9) units of the amount.
+        # The value must be between -999,999,999 and +999,999,999 inclusive.
+        # If `units` is positive, `nanos` must be positive or zero.
+        # If `units` is zero, `nanos` can be positive, zero, or negative.
+        # If `units` is negative, `nanos` must be negative or zero.
+        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        # Corresponds to the JSON property `nanos`
+        # @return [Fixnum]
+        attr_accessor :nanos
+      
+        # The whole units of the amount.
+        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        # Corresponds to the JSON property `units`
+        # @return [Fixnum]
+        attr_accessor :units
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @currency_code = args[:currency_code] if args.key?(:currency_code)
+          @nanos = args[:nanos] if args.key?(:nanos)
+          @units = args[:units] if args.key?(:units)
+        end
+      end
+    end
+  end
+end