feat: Exposing total CPU related fields in AutoscalingConfig (#2490)

* feat: Exposing total CPU related fields in AutoscalingConfig
docs: Update high_priority_cpu_utilization_percent in AutoscalingConfig to be Optional and clarify its behavior when not specified

PiperOrigin-RevId: 845819318

Source-Link: googleapis/googleapis@6e20492

Source-Link: googleapis/googleapis-gen@3bb618d
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiM2JiNjE4ZDE3OTI1MzIzMTcyZWQ4YzE1M2ZiYWJkMzFkNjExMGExMyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

protos/google/spanner/admin/instance/v1/spanner_instance_admin.proto

@@ -933,12 +933,25 @@ message AutoscalingConfig {
 
   // The autoscaling targets for an instance.
   message AutoscalingTargets {
-    // Required. The target high priority cpu utilization percentage that the
+    // Optional. The target high priority cpu utilization percentage that the
     // autoscaler should be trying to achieve for the instance. This number is
     // on a scale from 0 (no utilization) to 100 (full utilization). The valid
-    // range is [10, 90] inclusive.
+    // range is [10, 90] inclusive. If not specified or set to 0, the autoscaler
+    // skips scaling based on high priority CPU utilization.
     int32 high_priority_cpu_utilization_percent = 1
-        [(google.api.field_behavior) = REQUIRED];
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The target total CPU utilization percentage that the autoscaler
+    // should be trying to achieve for the instance. This number is on a scale
+    // from 0 (no utilization) to 100 (full utilization). The valid range is
+    // [10, 90] inclusive. If not specified or set to 0, the autoscaler skips
+    // scaling based on total CPU utilization. If both
+    // `high_priority_cpu_utilization_percent` and
+    // `total_cpu_utilization_percent` are specified, the autoscaler provisions
+    // the larger of the two required compute capacities to satisfy both
+    // targets.
+    int32 total_cpu_utilization_percent = 4
+        [(google.api.field_behavior) = OPTIONAL];
 
     // Required. The target storage utilization percentage that the autoscaler
     // should be trying to achieve for the instance. This number is on a scale
@@ -966,6 +979,60 @@ message AutoscalingConfig {
       // configuration for the selected replicas.
       int32 autoscaling_target_high_priority_cpu_utilization_percent = 2
           [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. If specified, overrides the
+      // autoscaling target `total_cpu_utilization_percent`
+      // in the top-level autoscaling configuration for the selected replicas.
+      int32 autoscaling_target_total_cpu_utilization_percent = 4
+          [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. If true, disables high priority CPU autoscaling for the
+      // selected replicas and ignores
+      // [high_priority_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AutoscalingTargets.high_priority_cpu_utilization_percent]
+      // in the top-level autoscaling configuration.
+      //
+      // When setting this field to true, setting
+      // [autoscaling_target_high_priority_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.autoscaling_target_high_priority_cpu_utilization_percent]
+      // field to a non-zero value for the same replica is not supported.
+      //
+      // If false, the
+      // [autoscaling_target_high_priority_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.autoscaling_target_high_priority_cpu_utilization_percent]
+      // field in the replica will be used if set to a non-zero value.
+      // Otherwise, the
+      // [high_priority_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AutoscalingTargets.high_priority_cpu_utilization_percent]
+      // field in the top-level autoscaling configuration will be used.
+      //
+      // Setting both
+      // [disable_high_priority_cpu_autoscaling][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.disable_high_priority_cpu_autoscaling]
+      // and
+      // [disable_total_cpu_autoscaling][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.disable_total_cpu_autoscaling]
+      // to true for the same replica is not supported.
+      bool disable_high_priority_cpu_autoscaling = 5
+          [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. If true, disables total CPU autoscaling for the selected
+      // replicas and ignores
+      // [total_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AutoscalingTargets.total_cpu_utilization_percent]
+      // in the top-level autoscaling configuration.
+      //
+      // When setting this field to true, setting
+      // [autoscaling_target_total_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.autoscaling_target_total_cpu_utilization_percent]
+      // field to a non-zero value for the same replica is not supported.
+      //
+      // If false, the
+      // [autoscaling_target_total_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.autoscaling_target_total_cpu_utilization_percent]
+      // field in the replica will be used if set to a non-zero value.
+      // Otherwise, the
+      // [total_cpu_utilization_percent][google.spanner.admin.instance.v1.AutoscalingConfig.AutoscalingTargets.total_cpu_utilization_percent]
+      // field in the top-level autoscaling configuration will be used.
+      //
+      // Setting both
+      // [disable_high_priority_cpu_autoscaling][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.disable_high_priority_cpu_autoscaling]
+      // and
+      // [disable_total_cpu_autoscaling][google.spanner.admin.instance.v1.AutoscalingConfig.AsymmetricAutoscalingOption.AutoscalingConfigOverrides.disable_total_cpu_autoscaling]
+      // to true for the same replica is not supported.
+      bool disable_total_cpu_autoscaling = 6
+          [(google.api.field_behavior) = OPTIONAL];
     }
 
     // Required. Selects the replicas to which this AsymmetricAutoscalingOption