google-cloud-recommender-v1 0.8.5 → 0.10.0

data/lib/google/cloud/recommender/v1/recommender/paths.rb

@@ -178,6 +178,49 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified InsightTypeConfig resource string.
+            #
+            # @overload insight_type_config_path(project:, location:, insight_type:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/insightTypes/{insight_type}/config`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param insight_type [String]
+            #
+            # @overload insight_type_config_path(organization:, location:, insight_type:)
+            #   The resource will be in the following format:
+            #
+            #   `organizations/{organization}/locations/{location}/insightTypes/{insight_type}/config`
+            #
+            #   @param organization [String]
+            #   @param location [String]
+            #   @param insight_type [String]
+            #
+            # @return [::String]
+            def insight_type_config_path **args
+              resources = {
+                "insight_type:location:project" => (proc do |project:, location:, insight_type:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/insightTypes/#{insight_type}/config"
+                end),
+                "insight_type:location:organization" => (proc do |organization:, location:, insight_type:|
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "organizations/#{organization}/locations/#{location}/insightTypes/#{insight_type}/config"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified Recommendation resource string.
             #
@@ -332,6 +375,49 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified RecommenderConfig resource string.
+            #
+            # @overload recommender_config_path(project:, location:, recommender:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/recommenders/{recommender}/config`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param recommender [String]
+            #
+            # @overload recommender_config_path(organization:, location:, recommender:)
+            #   The resource will be in the following format:
+            #
+            #   `organizations/{organization}/locations/{location}/recommenders/{recommender}/config`
+            #
+            #   @param organization [String]
+            #   @param location [String]
+            #   @param recommender [String]
+            #
+            # @return [::String]
+            def recommender_config_path **args
+              resources = {
+                "location:project:recommender" => (proc do |project:, location:, recommender:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/recommenders/#{recommender}/config"
+                end),
+                "location:organization:recommender" => (proc do |organization:, location:, recommender:|
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "organizations/#{organization}/locations/#{location}/recommenders/#{recommender}/config"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             extend self
           end
         end

data/lib/google/cloud/recommender/v1/recommender_config_pb.rb

@@ -0,0 +1,37 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/recommender/v1/recommender_config.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/protobuf/struct_pb'
+require 'google/protobuf/timestamp_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/recommender/v1/recommender_config.proto", :syntax => :proto3) do
+    add_message "google.cloud.recommender.v1.RecommenderConfig" do
+      optional :name, :string, 1
+      optional :recommender_generation_config, :message, 2, "google.cloud.recommender.v1.RecommenderGenerationConfig"
+      optional :etag, :string, 3
+      optional :update_time, :message, 4, "google.protobuf.Timestamp"
+      optional :revision_id, :string, 5
+      map :annotations, :string, :string, 6
+      optional :display_name, :string, 7
+    end
+    add_message "google.cloud.recommender.v1.RecommenderGenerationConfig" do
+      optional :params, :message, 1, "google.protobuf.Struct"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Recommender
+      module V1
+        RecommenderConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.RecommenderConfig").msgclass
+        RecommenderGenerationConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.RecommenderGenerationConfig").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/recommender/v1/recommender_service_pb.rb

@@ -1,13 +1,17 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/recommender/v1/recommender_service.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/recommender/v1/insight_pb'
+require 'google/cloud/recommender/v1/insight_type_config_pb'
 require 'google/cloud/recommender/v1/recommendation_pb'
-require 'google/protobuf'
+require 'google/cloud/recommender/v1/recommender_config_pb'
+require 'google/protobuf/field_mask_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/recommender/v1/recommender_service.proto", :syntax => :proto3) do
@@ -57,6 +61,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :state_metadata, :string, :string, 2
       optional :etag, :string, 3
     end
+    add_message "google.cloud.recommender.v1.GetRecommenderConfigRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.recommender.v1.UpdateRecommenderConfigRequest" do
+      optional :recommender_config, :message, 1, "google.cloud.recommender.v1.RecommenderConfig"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+      optional :validate_only, :bool, 3
+    end
+    add_message "google.cloud.recommender.v1.GetInsightTypeConfigRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.recommender.v1.UpdateInsightTypeConfigRequest" do
+      optional :insight_type_config, :message, 1, "google.cloud.recommender.v1.InsightTypeConfig"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+      optional :validate_only, :bool, 3
+    end
   end
 end
 
@@ -74,6 +94,10 @@ module Google
         MarkRecommendationClaimedRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.MarkRecommendationClaimedRequest").msgclass
         MarkRecommendationSucceededRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.MarkRecommendationSucceededRequest").msgclass
         MarkRecommendationFailedRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.MarkRecommendationFailedRequest").msgclass
+        GetRecommenderConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.GetRecommenderConfigRequest").msgclass
+        UpdateRecommenderConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.UpdateRecommenderConfigRequest").msgclass
+        GetInsightTypeConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.GetInsightTypeConfigRequest").msgclass
+        UpdateInsightTypeConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.recommender.v1.UpdateInsightTypeConfigRequest").msgclass
       end
     end
   end

data/lib/google/cloud/recommender/v1/recommender_service_services_pb.rb

@@ -36,8 +36,8 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.recommender.v1.Recommender'
 
-            # Lists insights for a Cloud project. Requires the recommender.*.list IAM
-            # permission for the specified insight type.
+            # Lists insights for the specified Cloud Resource. Requires the
+            # recommender.*.list IAM permission for the specified insight type.
             rpc :ListInsights, ::Google::Cloud::Recommender::V1::ListInsightsRequest, ::Google::Cloud::Recommender::V1::ListInsightsResponse
             # Gets the requested insight. Requires the recommender.*.get IAM permission
             # for the specified insight type.
@@ -49,8 +49,8 @@ module Google
             # MarkInsightAccepted can be applied to insights in ACTIVE state. Requires
             # the recommender.*.update IAM permission for the specified insight.
             rpc :MarkInsightAccepted, ::Google::Cloud::Recommender::V1::MarkInsightAcceptedRequest, ::Google::Cloud::Recommender::V1::Insight
-            # Lists recommendations for a Cloud project. Requires the recommender.*.list
-            # IAM permission for the specified recommender.
+            # Lists recommendations for the specified Cloud Resource. Requires the
+            # recommender.*.list IAM permission for the specified recommender.
             rpc :ListRecommendations, ::Google::Cloud::Recommender::V1::ListRecommendationsRequest, ::Google::Cloud::Recommender::V1::ListRecommendationsResponse
             # Gets the requested recommendation. Requires the recommender.*.get
             # IAM permission for the specified recommender.
@@ -90,6 +90,18 @@ module Google
             # Requires the recommender.*.update IAM permission for the specified
             # recommender.
             rpc :MarkRecommendationFailed, ::Google::Cloud::Recommender::V1::MarkRecommendationFailedRequest, ::Google::Cloud::Recommender::V1::Recommendation
+            # Gets the requested Recommender Config. There is only one instance of the
+            # config for each Recommender.
+            rpc :GetRecommenderConfig, ::Google::Cloud::Recommender::V1::GetRecommenderConfigRequest, ::Google::Cloud::Recommender::V1::RecommenderConfig
+            # Updates a Recommender Config. This will create a new revision of the
+            # config.
+            rpc :UpdateRecommenderConfig, ::Google::Cloud::Recommender::V1::UpdateRecommenderConfigRequest, ::Google::Cloud::Recommender::V1::RecommenderConfig
+            # Gets the requested InsightTypeConfig. There is only one instance of the
+            # config for each InsightType.
+            rpc :GetInsightTypeConfig, ::Google::Cloud::Recommender::V1::GetInsightTypeConfigRequest, ::Google::Cloud::Recommender::V1::InsightTypeConfig
+            # Updates an InsightTypeConfig change. This will create a new revision of the
+            # config.
+            rpc :UpdateInsightTypeConfig, ::Google::Cloud::Recommender::V1::UpdateInsightTypeConfigRequest, ::Google::Cloud::Recommender::V1::InsightTypeConfig
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/recommender/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Recommender
       module V1
-        VERSION = "0.8.5"
+        VERSION = "0.10.0"
       end
     end
   end

data/lib/google/cloud/recommender/v1.rb

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/recommender/v1"
       #     client = ::Google::Cloud::Recommender::V1::Recommender::Client.new
       #

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

data/proto_docs/google/cloud/recommender/v1/insight.rb

@@ -54,6 +54,9 @@ module Google
         # @!attribute [rw] category
         #   @return [::Google::Cloud::Recommender::V1::Insight::Category]
         #     Category being targeted by the insight.
+        # @!attribute [rw] severity
+        #   @return [::Google::Cloud::Recommender::V1::Insight::Severity]
+        #     Insight's severity.
         # @!attribute [rw] etag
         #   @return [::String]
         #     Fingerprint of the Insight. Provides optimistic locking when updating
@@ -92,6 +95,24 @@ module Google
             # This insight is related to manageability.
             MANAGEABILITY = 4
           end
+
+          # Insight severity levels.
+          module Severity
+            # Insight has unspecified severity.
+            SEVERITY_UNSPECIFIED = 0
+
+            # Insight has low severity.
+            LOW = 1
+
+            # Insight has medium severity.
+            MEDIUM = 2
+
+            # Insight has high severity.
+            HIGH = 3
+
+            # Insight has critical severity.
+            CRITICAL = 4
+          end
         end
 
         # Information related to insight state.

data/proto_docs/google/cloud/recommender/v1/insight_type_config.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Recommender
+      module V1
+        # Configuration for an InsightType.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Name of insight type config.
+        #     Eg,
+        #     projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
+        # @!attribute [rw] insight_type_generation_config
+        #   @return [::Google::Cloud::Recommender::V1::InsightTypeGenerationConfig]
+        #     InsightTypeGenerationConfig which configures the generation of
+        #     insights for this insight type.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Fingerprint of the InsightTypeConfig. Provides optimistic locking when
+        #     updating.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Last time when the config was updated.
+        # @!attribute [r] revision_id
+        #   @return [::String]
+        #     Output only. Immutable. The revision ID of the config.
+        #     A new revision is committed whenever the config is changed in any way.
+        #     The format is an 8-character hexadecimal string.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Allows clients to store small amounts of arbitrary data. Annotations must
+        #     follow the Kubernetes syntax.
+        #     The total size of all keys and values combined is limited to 256k.
+        #     Key can have 2 segments: prefix (optional) and name (required),
+        #     separated by a slash (/).
+        #     Prefix must be a DNS subdomain.
+        #     Name must be 63 characters or less, begin and end with alphanumerics,
+        #     with dashes (-), underscores (_), dots (.), and alphanumerics between.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     A user-settable field to provide a human-readable name to be used in user
+        #     interfaces.
+        class InsightTypeConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # A configuration to customize the generation of insights.
+        # Eg, customizing the lookback period considered when generating a
+        # insight.
+        # @!attribute [rw] params
+        #   @return [::Google::Protobuf::Struct]
+        #     Parameters for this InsightTypeGenerationConfig. These configs can be used
+        #     by or are applied to all subtypes.
+        class InsightTypeGenerationConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/recommender/v1/recommendation.rb

@@ -54,6 +54,9 @@ module Google
         #     Optional set of additional impact that this recommendation may have when
         #     trying to optimize for the primary category. These may be positive
         #     or negative.
+        # @!attribute [rw] priority
+        #   @return [::Google::Cloud::Recommender::V1::Recommendation::Priority]
+        #     Recommendation's priority.
         # @!attribute [rw] content
         #   @return [::Google::Cloud::Recommender::V1::RecommendationContent]
         #     Content of the recommendation describing recommended changes to resources.
@@ -67,6 +70,12 @@ module Google
         # @!attribute [rw] associated_insights
         #   @return [::Array<::Google::Cloud::Recommender::V1::Recommendation::InsightReference>]
         #     Insights that led to this recommendation.
+        # @!attribute [rw] xor_group_id
+        #   @return [::String]
+        #     Corresponds to a mutually exclusive group ID within a recommender.
+        #     A non-empty ID indicates that the recommendation belongs to a mutually
+        #     exclusive group. This means that only one recommendation within the group
+        #     is suggested to be applied.
         class Recommendation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -80,6 +89,24 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Recommendation priority levels.
+          module Priority
+            # Recommendation has unspecified priority.
+            PRIORITY_UNSPECIFIED = 0
+
+            # Recommendation has P4 priority (lowest priority).
+            P4 = 1
+
+            # Recommendation has P3 priority (second lowest priority).
+            P3 = 2
+
+            # Recommendation has P2 priority (second highest priority).
+            P2 = 3
+
+            # Recommendation has P1 priority (highest priority).
+            P1 = 4
+          end
         end
 
         # Contains what resources are changing and how they are changing.
@@ -88,6 +115,9 @@ module Google
         #     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.
+        # @!attribute [rw] overview
+        #   @return [::Google::Protobuf::Struct]
+        #     Condensed overview information about the recommendation.
         class RecommendationContent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -114,7 +144,7 @@ module Google
         # See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
         # @!attribute [rw] action
         #   @return [::String]
-        #     Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
+        #     Type of this operation. Contains one of 'add', 'remove', 'replace', 'move',
         #     'copy', 'test' and custom operations. This field is case-insensitive and
         #     always populated.
         # @!attribute [rw] resource_type
@@ -184,7 +214,7 @@ module Google
         # @!attribute [rw] path_value_matchers
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Recommender::V1::ValueMatcher}]
         #     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
+        #     field 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.
@@ -228,6 +258,9 @@ module Google
         #     An approximate projection on amount saved or amount incurred. Negative cost
         #     units indicate cost savings and positive cost units indicate increase.
         #     See google.type.Money documentation for positive/negative units.
+        #
+        #     A user's permissions may affect whether the cost is computed using list
+        #     prices or custom contract prices.
         # @!attribute [rw] duration
         #   @return [::Google::Protobuf::Duration]
         #     Duration for which this cost applies.
@@ -236,6 +269,15 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Contains various ways of describing the impact on Security.
+        # @!attribute [rw] details
+        #   @return [::Google::Protobuf::Struct]
+        #     Additional security impact details that is provided by the recommender.
+        class SecurityProjection
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Contains the impact a recommendation can have for a given category.
         # @!attribute [rw] category
         #   @return [::Google::Cloud::Recommender::V1::Impact::Category]
@@ -243,6 +285,9 @@ module Google
         # @!attribute [rw] cost_projection
         #   @return [::Google::Cloud::Recommender::V1::CostProjection]
         #     Use with CategoryType.COST
+        # @!attribute [rw] security_projection
+        #   @return [::Google::Cloud::Recommender::V1::SecurityProjection]
+        #     Use with CategoryType.SECURITY
         class Impact
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods