feat: Sustainability Projection

Google APIs · copybara-github · commit 44d6bef0ca6d · 2022-02-10T12:46:49.000-08:00
Incorporate above new features, as well as update .bazel files.

PiperOrigin-RevId: 427821134
diff --git a/google/cloud/recommender/v1beta1/insight.proto b/google/cloud/recommender/v1beta1/insight.proto
@@ -84,7 +84,7 @@ message Insight {
   // Reference to an associated recommendation.
   message RecommendationReference {
     // Recommendation resource name, e.g.
-    // `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]`
+    // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]
     string recommendation = 1;
   }
 
diff --git a/google/cloud/recommender/v1beta1/insight_type_config.proto b/google/cloud/recommender/v1beta1/insight_type_config.proto
@@ -67,7 +67,7 @@ message InsightTypeConfig {
   // 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.
+  // with dashes (-), underscores (_), dots (.), and alphanumerics between.
   map<string, string> annotations = 6;
 
   // A user-settable field to provide a human-readable name to be used in user
diff --git a/google/cloud/recommender/v1beta1/recommendation.proto b/google/cloud/recommender/v1beta1/recommendation.proto
@@ -265,6 +265,17 @@ message SecurityProjection {
   google.protobuf.Struct details = 2;
 }
 
+// Contains metadata about how much sustainability a recommendation can save or
+// incur.
+message SustainabilityProjection {
+  // Carbon Footprint generated in kg of CO2 equivalent.
+  // Chose kg_c_o2e so that the name renders correctly in camelCase (kgCO2e).
+  double kg_c_o2e = 1;
+
+  // Duration for which this sustanability applies.
+  google.protobuf.Duration duration = 2;
+}
+
 // Contains the impact a recommendation can have for a given category.
 message Impact {
   // The category of the impact.
@@ -298,6 +309,9 @@ message Impact {
 
     // Use with CategoryType.SECURITY
     SecurityProjection security_projection = 101;
+
+    // Use with CategoryType.SUSTAINABILITY
+    SustainabilityProjection sustainability_projection = 102;
   }
 }
 
diff --git a/google/cloud/recommender/v1beta1/recommender_config.proto b/google/cloud/recommender/v1beta1/recommender_config.proto
@@ -67,7 +67,7 @@ message RecommenderConfig {
   // 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.
+  // with dashes (-), underscores (_), dots (.), and alphanumerics between.
   map<string, string> annotations = 6;
 
   // A user-settable field to provide a human-readable name to be used in user

Original file line number	Diff line number	Diff line change
`@@ -84,7 +84,7 @@ message Insight {`
`84`	`84`	`// Reference to an associated recommendation.`
`85`	`85`	`message RecommendationReference {`
`86`	`86`	`// Recommendation resource name, e.g.`
`87`		- // `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]`
	`87`	`+ // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]`
`88`	`88`	`string recommendation = 1;`
`89`	`89`	`}`
`90`	`90`