feat: Support utilization insights and cloud hub

Google APIs · copybara-github · commit 1676bd0af0bf · 2026-05-28T12:05:01.000-07:00
docs: Add identifier annotation for field name

PiperOrigin-RevId: 922901240
diff --git a/google/cloud/recommender/v1/insight.proto b/google/cloud/recommender/v1/insight.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.recommender.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/struct.proto";
@@ -95,8 +96,8 @@ message Insight {
     string recommendation = 1;
   }
 
-  // Name of the insight.
-  string name = 1;
+  // Identifier. Name of the insight.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Free-form human readable summary in English. The maximum length is 500
   // characters.
diff --git a/google/cloud/recommender/v1/insight_type_config.proto b/google/cloud/recommender/v1/insight_type_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -37,10 +37,10 @@ message InsightTypeConfig {
     pattern: "billingAccounts/{billing_account}/locations/{location}/insightTypes/{insight_type}/config"
   };
 
-  // Name of insight type config.
+  // Identifier. Name of insight type config.
   // Eg,
   // projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // InsightTypeGenerationConfig which configures the generation of
   // insights for this insight type.
diff --git a/google/cloud/recommender/v1/recommendation.proto b/google/cloud/recommender/v1/recommendation.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.recommender.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/struct.proto";
@@ -71,8 +72,8 @@ message Recommendation {
     string insight = 1;
   }
 
-  // Name of recommendation.
-  string name = 1;
+  // Identifier. Name of recommendation.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Free-form human readable summary in English. The maximum length is 500
   // characters.
@@ -123,6 +124,9 @@ message Recommendation {
   // exclusive group. This means that only one recommendation within the group
   // is suggested to be applied.
   string xor_group_id = 18;
+
+  // Fully qualified resource names that this recommendation is targeting.
+  repeated string target_resources = 19;
 }
 
 // Contains what resources are changing and how they are changing.
@@ -236,6 +240,7 @@ message Operation {
 
 // Contains various matching options for values for a GCP resource field.
 message ValueMatcher {
+  // To be used for full regex matching.
   oneof match_variant {
     // To be used for full regex matching. The regular expression is using the
     // Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
@@ -346,6 +351,9 @@ message Impact {
     // Use with CategoryType.RELIABILITY
     ReliabilityProjection reliability_projection = 103;
   }
+
+  // The service that this impact is associated with.
+  string service = 3;
 }
 
 // Information for state. Contains state and metadata.
diff --git a/google/cloud/recommender/v1/recommender_config.proto b/google/cloud/recommender/v1/recommender_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -37,10 +37,10 @@ message RecommenderConfig {
     pattern: "billingAccounts/{billing_account}/locations/{location}/recommenders/{recommender}/config"
   };
 
-  // Name of recommender config.
+  // Identifier. Name of recommender config.
   // Eg,
   // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // RecommenderGenerationConfig which configures the Generation of
   // recommendations for this recommender.
diff --git a/google/cloud/recommender/v1/recommender_service.proto b/google/cloud/recommender/v1/recommender_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Copyright 2025 Google LLC`
	`1`	`+// Copyright 2026 Google LLC`
`2`	`2`	`//`
`3`	`3`	`// Licensed under the Apache License, Version 2.0 (the "License");`
`4`	`4`	`// you may not use this file except in compliance with the License.`