google-apis-recommender_v1 0.1.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14fd323be59984e99e9863b90528ec5f4b1a4b25c907b3ce568c44cf0876ca2b
-  data.tar.gz: 3ee8667cd09dfe5baaaab2034f255d44d68eac79e79591b33a84b3280186b792
+  metadata.gz: d7734955e85ab3a0ab81b7e4b798554211e4f3faa5be7b29d11cc8218f411611
+  data.tar.gz: 12e060222999ebc282a187b6da48d45b569038f80b52565e8afaf5b03d74d2aa
 SHA512:
-  metadata.gz: 28b68f982ba69a6e0d468b67c0a6e7ed8a5a4484747e2567fb761bf2ed50de0a3303e3a9358f5f25717f7b0b4cd3018723dc0a10d976e8fb8a22595f3fed5dfb
-  data.tar.gz: 5726184f06e1b87f4f831fc901e429b1d12034cdaff75c56a2bc0a4a8dc4d9d3010dba5611ff53e3191340849d84ade9c5d792cc4da147585ed1b0722f4696d6
+  metadata.gz: c6890ccaa552edddffff58096cded2813f535b748031a365d8d9b22cc9c92cb7ca50216b5239492727f353713c463f589e37e3a6f3b3e33c6b2fb0474446935c
+  data.tar.gz: afcd640bf46a960deecd650895770dd6e8691162198e1586e0d64c30daa0c2a53d3296be4a05715b9ebf6f2e43c98b5c8dc8f4471d36828b90352609952e65c9

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release history for google-apis-recommender_v1
 
+### v0.6.0 (2021-05-13)
+
+* Regenerated from discovery document revision 20210510
+
+### v0.5.0 (2021-03-24)
+
+* Regenerated from discovery document revision 20210319
+
+### v0.4.0 (2021-03-10)
+
+* Regenerated from discovery document revision 20210307
+* Regenerated using generator version 0.2.0
+
+### v0.3.0 (2021-03-04)
+
+* Regenerated from discovery document revision 20210227
+
+### v0.2.0 (2021-01-21)
+
+* Regenerated from discovery document revision 20210118
+* Regenerated using generator version 0.1.2
+
 ### v0.1.0 (2021-01-07)
 
 * Regenerated using generator version 0.1.1

data/lib/google/apis/recommender_v1.rb

@@ -29,7 +29,7 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V1'
 
-      # View and manage your data across Google Cloud Platform services
+      # See, edit, configure, and delete your Google Cloud Platform data
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end

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

@@ -61,6 +61,11 @@ module Google
         # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1CostProjection]
         attr_accessor :cost_projection
       
+        # Contains various ways of describing the impact on Security.
+        # Corresponds to the JSON property `securityProjection`
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1SecurityProjection]
+        attr_accessor :security_projection
+      
         def initialize(**args)
            update!(**args)
         end
@@ -69,6 +74,7 @@ module Google
         def update!(**args)
           @category = args[:category] if args.key?(:category)
           @cost_projection = args[:cost_projection] if args.key?(:cost_projection)
+          @security_projection = args[:security_projection] if args.key?(:security_projection)
         end
       end
       
@@ -126,6 +132,11 @@ module Google
         # @return [String]
         attr_accessor :observation_period
       
+        # Insight's severity.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
         # Information related to insight state.
         # Corresponds to the JSON property `stateInfo`
         # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1InsightStateInfo]
@@ -151,6 +162,7 @@ module Google
           @last_refresh_time = args[:last_refresh_time] if args.key?(:last_refresh_time)
           @name = args[:name] if args.key?(:name)
           @observation_period = args[:observation_period] if args.key?(:observation_period)
+          @severity = args[:severity] if args.key?(:severity)
           @state_info = args[:state_info] if args.key?(:state_info)
           @target_resources = args[:target_resources] if args.key?(:target_resources)
         end
@@ -396,9 +408,9 @@ module Google
         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.
+        # refers 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
@@ -530,6 +542,11 @@ module Google
         # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact]
         attr_accessor :primary_impact
       
+        # Recommendation's priority.
+        # Corresponds to the JSON property `priority`
+        # @return [String]
+        attr_accessor :priority
+      
         # 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 `
@@ -560,6 +577,7 @@ module Google
           @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)
+          @priority = args[:priority] if args.key?(:priority)
           @recommender_subtype = args[:recommender_subtype] if args.key?(:recommender_subtype)
           @state_info = args[:state_info] if args.key?(:state_info)
         end
@@ -631,6 +649,25 @@ module Google
         end
       end
       
+      # Contains various ways of describing the impact on Security.
+      class GoogleCloudRecommenderV1SecurityProjection
+        include Google::Apis::Core::Hashable
+      
+        # Additional security impact details that is provided by the recommender.
+        # Corresponds to the JSON property `details`
+        # @return [Hash<String,Object>]
+        attr_accessor :details
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @details = args[:details] if args.key?(:details)
+        end
+      end
+      
       # Contains various matching options for values for a GCP resource field.
       class GoogleCloudRecommenderV1ValueMatcher
         include Google::Apis::Core::Hashable

data/lib/google/apis/recommender_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RecommenderV1
       # Version of the google-apis-recommender_v1 gem
-      GEM_VERSION = "0.1.0"
+      GEM_VERSION = "0.6.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.1"
+      GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20201113"
+      REVISION = "20210510"
     end
   end
 end

data/lib/google/apis/recommender_v1/representations.rb

@@ -124,6 +124,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRecommenderV1SecurityProjection
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRecommenderV1ValueMatcher
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -151,6 +157,8 @@ module Google
           property :category, as: 'category'
           property :cost_projection, as: 'costProjection', class: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1CostProjection, decorator: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1CostProjection::Representation
       
+          property :security_projection, as: 'securityProjection', class: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1SecurityProjection, decorator: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1SecurityProjection::Representation
+      
         end
       end
       
@@ -167,6 +175,7 @@ module Google
           property :last_refresh_time, as: 'lastRefreshTime'
           property :name, as: 'name'
           property :observation_period, as: 'observationPeriod'
+          property :severity, as: 'severity'
           property :state_info, as: 'stateInfo', class: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1InsightStateInfo, decorator: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1InsightStateInfo::Representation
       
           collection :target_resources, as: 'targetResources'
@@ -279,6 +288,7 @@ module Google
           property :name, as: 'name'
           property :primary_impact, as: 'primaryImpact', class: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact, decorator: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact::Representation
       
+          property :priority, as: 'priority'
           property :recommender_subtype, as: 'recommenderSubtype'
           property :state_info, as: 'stateInfo', class: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1RecommendationStateInfo, decorator: Google::Apis::RecommenderV1::GoogleCloudRecommenderV1RecommendationStateInfo::Representation
       
@@ -308,6 +318,13 @@ module Google
         end
       end
       
+      class GoogleCloudRecommenderV1SecurityProjection
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :details, as: 'details'
+        end
+      end
+      
       class GoogleCloudRecommenderV1ValueMatcher
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/recommender_v1/service.rb

@@ -49,6 +49,1005 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Gets the requested insight. Requires the recommender.*.get IAM permission for
+        # the specified insight type.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_billing_account_location_insight_type_insight(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists insights for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified insight type.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
+        #   INSIGHT_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]
+        #   /insightTypes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   insightTypes/[INSIGHT_TYPE_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP
+        #   Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+        #   supported insight types: https://cloud.google.com/recommender/docs/insights/
+        #   insight-types.
+        # @param [String] filter
+        #   Optional. Filter expression to restrict the insights returned. Supported
+        #   filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: *
+        #   `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype =
+        #   PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.
+        #   state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These
+        #   expressions are based on the filter language described at https://google.aip.
+        #   dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_account_location_insight_type_insights(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/insights', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Insight State as Accepted. Users can use this method to indicate to
+        # the Recommender API that they have applied some action based on the insight.
+        # This stops the insight content from being updated. MarkInsightAccepted can be
+        # applied to insights in ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified insight.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest] google_cloud_recommender_v1_mark_insight_accepted_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @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 mark_billing_account_location_insight_type_insight_accepted(name, google_cloud_recommender_v1_mark_insight_accepted_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAccepted', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_insight_accepted_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the requested recommendation. Requires the recommender.*.get IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_billing_account_location_recommender_recommendation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists recommendations for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified recommender.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
+        #   RECOMMENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/recommenders/[RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+        #   https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported
+        #   recommenders: https://cloud.google.com/recommender/docs/recommenders.
+        # @param [String] filter
+        #   Filter expression to restrict the recommendations returned. Supported filter
+        #   fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `
+        #   stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype
+        #   = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR
+        #   priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)
+        #   ` (These expressions are based on the filter language described at https://
+        #   google.aip.dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_account_location_recommender_recommendations(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/recommendations', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Claimed. Users can use this method to
+        # indicate to the Recommender API that they are starting to apply the
+        # recommendation themselves. This stops the recommendation content from being
+        # updated. Associated insights are frozen and placed in the ACCEPTED state.
+        # MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
+        # SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest] google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_billing_account_location_recommender_recommendation_claimed(name, google_cloud_recommender_v1_mark_recommendation_claimed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markClaimed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Failed. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation failed. This stops the recommendation content
+        # from being updated. Associated insights are frozen and placed in the ACCEPTED
+        # state. MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+        # CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest] google_cloud_recommender_v1_mark_recommendation_failed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_billing_account_location_recommender_recommendation_failed(name, google_cloud_recommender_v1_mark_recommendation_failed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markFailed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_failed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Succeeded. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation was successful. This stops the recommendation
+        # content from being updated. Associated insights are frozen and placed in the
+        # ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations
+        # in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.
+        # update IAM permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest] google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_billing_account_location_recommender_recommendation_succeeded(name, google_cloud_recommender_v1_mark_recommendation_succeeded_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markSucceeded', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the requested insight. Requires the recommender.*.get IAM permission for
+        # the specified insight type.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_folder_location_insight_type_insight(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists insights for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified insight type.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
+        #   INSIGHT_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]
+        #   /insightTypes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   insightTypes/[INSIGHT_TYPE_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP
+        #   Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+        #   supported insight types: https://cloud.google.com/recommender/docs/insights/
+        #   insight-types.
+        # @param [String] filter
+        #   Optional. Filter expression to restrict the insights returned. Supported
+        #   filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: *
+        #   `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype =
+        #   PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.
+        #   state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These
+        #   expressions are based on the filter language described at https://google.aip.
+        #   dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_folder_location_insight_type_insights(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/insights', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Insight State as Accepted. Users can use this method to indicate to
+        # the Recommender API that they have applied some action based on the insight.
+        # This stops the insight content from being updated. MarkInsightAccepted can be
+        # applied to insights in ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified insight.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest] google_cloud_recommender_v1_mark_insight_accepted_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @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 mark_folder_location_insight_type_insight_accepted(name, google_cloud_recommender_v1_mark_insight_accepted_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAccepted', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_insight_accepted_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the requested recommendation. Requires the recommender.*.get IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_folder_location_recommender_recommendation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists recommendations for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified recommender.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
+        #   RECOMMENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/recommenders/[RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+        #   https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported
+        #   recommenders: https://cloud.google.com/recommender/docs/recommenders.
+        # @param [String] filter
+        #   Filter expression to restrict the recommendations returned. Supported filter
+        #   fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `
+        #   stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype
+        #   = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR
+        #   priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)
+        #   ` (These expressions are based on the filter language described at https://
+        #   google.aip.dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_folder_location_recommender_recommendations(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/recommendations', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Claimed. Users can use this method to
+        # indicate to the Recommender API that they are starting to apply the
+        # recommendation themselves. This stops the recommendation content from being
+        # updated. Associated insights are frozen and placed in the ACCEPTED state.
+        # MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
+        # SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest] google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_folder_location_recommender_recommendation_claimed(name, google_cloud_recommender_v1_mark_recommendation_claimed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markClaimed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Failed. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation failed. This stops the recommendation content
+        # from being updated. Associated insights are frozen and placed in the ACCEPTED
+        # state. MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+        # CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest] google_cloud_recommender_v1_mark_recommendation_failed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_folder_location_recommender_recommendation_failed(name, google_cloud_recommender_v1_mark_recommendation_failed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markFailed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_failed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Succeeded. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation was successful. This stops the recommendation
+        # content from being updated. Associated insights are frozen and placed in the
+        # ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations
+        # in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.
+        # update IAM permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest] google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_folder_location_recommender_recommendation_succeeded(name, google_cloud_recommender_v1_mark_recommendation_succeeded_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markSucceeded', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the requested insight. Requires the recommender.*.get IAM permission for
+        # the specified insight type.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_location_insight_type_insight(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists insights for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified insight type.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
+        #   INSIGHT_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]
+        #   /insightTypes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   insightTypes/[INSIGHT_TYPE_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP
+        #   Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+        #   supported insight types: https://cloud.google.com/recommender/docs/insights/
+        #   insight-types.
+        # @param [String] filter
+        #   Optional. Filter expression to restrict the insights returned. Supported
+        #   filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: *
+        #   `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype =
+        #   PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.
+        #   state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These
+        #   expressions are based on the filter language described at https://google.aip.
+        #   dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_location_insight_type_insights(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/insights', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListInsightsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Insight State as Accepted. Users can use this method to indicate to
+        # the Recommender API that they have applied some action based on the insight.
+        # This stops the insight content from being updated. MarkInsightAccepted can be
+        # applied to insights in ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified insight.
+        # @param [String] name
+        #   Required. Name of the insight.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest] google_cloud_recommender_v1_mark_insight_accepted_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Insight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight]
+        #
+        # @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 mark_organization_location_insight_type_insight_accepted(name, google_cloud_recommender_v1_mark_insight_accepted_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markAccepted', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_insight_accepted_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Insight
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the requested recommendation. Requires the recommender.*.get IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_location_recommender_recommendation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists recommendations for a Cloud project. Requires the recommender.*.list IAM
+        # permission for the specified recommender.
+        # @param [String] parent
+        #   Required. The container resource on which to execute the request. Acceptable
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
+        #   RECOMMENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/recommenders/[RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+        #   https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported
+        #   recommenders: https://cloud.google.com/recommender/docs/recommenders.
+        # @param [String] filter
+        #   Filter expression to restrict the recommendations returned. Supported filter
+        #   fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `
+        #   stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype
+        #   = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR
+        #   priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)
+        #   ` (These expressions are based on the filter language described at https://
+        #   google.aip.dev/160)
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. If not specified, the server will determine the
+        #   number of results to return.
+        # @param [String] page_token
+        #   Optional. If present, retrieves the next batch of results from the preceding
+        #   call to this method. `page_token` must be the value of `next_page_token` from
+        #   the previous response. The values of other method parameters must be identical
+        #   to those in the previous call.
+        # @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::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_location_recommender_recommendations(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/recommendations', options)
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ListRecommendationsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Claimed. Users can use this method to
+        # indicate to the Recommender API that they are starting to apply the
+        # recommendation themselves. This stops the recommendation content from being
+        # updated. Associated insights are frozen and placed in the ACCEPTED state.
+        # MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
+        # SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest] google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_organization_location_recommender_recommendation_claimed(name, google_cloud_recommender_v1_mark_recommendation_claimed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markClaimed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_claimed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Failed. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation failed. This stops the recommendation content
+        # from being updated. Associated insights are frozen and placed in the ACCEPTED
+        # state. MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+        # CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM
+        # permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest] google_cloud_recommender_v1_mark_recommendation_failed_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_organization_location_recommender_recommendation_failed(name, google_cloud_recommender_v1_mark_recommendation_failed_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markFailed', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_failed_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Recommendation State as Succeeded. Users can use this method to
+        # indicate to the Recommender API that they have applied the recommendation
+        # themselves, and the operation was successful. This stops the recommendation
+        # content from being updated. Associated insights are frozen and placed in the
+        # ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations
+        # in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.
+        # update IAM permission for the specified recommender.
+        # @param [String] name
+        #   Required. Name of the recommendation.
+        # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest] google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+        # @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::RecommenderV1::GoogleCloudRecommenderV1Recommendation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation]
+        #
+        # @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 mark_organization_location_recommender_recommendation_succeeded(name, google_cloud_recommender_v1_mark_recommendation_succeeded_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:markSucceeded', options)
+          command.request_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest::Representation
+          command.request_object = google_cloud_recommender_v1_mark_recommendation_succeeded_request_object
+          command.response_representation = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation::Representation
+          command.response_class = Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Recommendation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the requested insight. Requires the recommender.*.get IAM permission for
         # the specified insight type.
         # @param [String] name
@@ -84,13 +1083,22 @@ module Google
         # permission for the specified insight type.
         # @param [String] parent
         #   Required. The container resource on which to execute the request. Acceptable
-        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
-        #   INSIGHT_TYPE_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https:/
-        #   /cloud.google.com/recommender/docs/insights/insight-types.)
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
+        #   INSIGHT_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]
+        #   /insightTypes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   insightTypes/[INSIGHT_TYPE_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP
+        #   Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+        #   supported insight types: https://cloud.google.com/recommender/docs/insights/
+        #   insight-types.
         # @param [String] filter
         #   Optional. Filter expression to restrict the insights returned. Supported
-        #   filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
+        #   filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: *
+        #   `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype =
+        #   PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.
+        #   state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These
+        #   expressions are based on the filter language described at https://google.aip.
+        #   dev/160)
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. If not specified, the server will determine the
@@ -202,14 +1210,21 @@ module Google
         # permission for the specified recommender.
         # @param [String] parent
         #   Required. The container resource on which to execute the request. Acceptable
-        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
-        #   RECOMMENDER_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://
-        #   cloud.google.com/recommender/docs/recommenders.
+        #   formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
+        #   RECOMMENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/
+        #   recommenders/[RECOMMENDER_ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[
+        #   LOCATION]/recommenders/[RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+        #   https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported
+        #   recommenders: https://cloud.google.com/recommender/docs/recommenders.
         # @param [String] filter
         #   Filter expression to restrict the recommendations returned. Supported filter
-        #   fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:
-        #   "FAILED"
+        #   fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `
+        #   stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype
+        #   = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR
+        #   priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)
+        #   ` (These expressions are based on the filter language described at https://
+        #   google.aip.dev/160)
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. If not specified, the server will determine the