feat: generate libraries

Author: parthea

.librarian/state.yaml

@@ -2,7 +2,7 @@ image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-li
 libraries:
   - id: google-cloud-spanner
     version: 3.63.0
-    last_generated_commit: a17b84add8318f780fcc8a027815d5fee644b9f7
+    last_generated_commit: 94bc991b3f1df58bc841801631715894a7ac5e28
     apis:
       - path: google/spanner/admin/instance/v1
         service_config: spanner.yaml

google/cloud/spanner_admin_instance_v1/types/spanner_instance_admin.py

@@ -542,11 +542,24 @@ class AutoscalingTargets(proto.Message):
 
         Attributes:
             high_priority_cpu_utilization_percent (int):
-                Required. The target high priority cpu utilization
+                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.
+                [10, 90] inclusive. If not specified or set to 0, the
+                autoscaler skips scaling based on high priority CPU
+                utilization.
+            total_cpu_utilization_percent (int):
+                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.
             storage_utilization_percent (int):
                 Required. The target storage utilization percentage that the
                 autoscaler should be trying to achieve for the instance.
@@ -558,6 +571,10 @@ class AutoscalingTargets(proto.Message):
             proto.INT32,
             number=1,
         )
+        total_cpu_utilization_percent: int = proto.Field(
+            proto.INT32,
+            number=4,
+        )
         storage_utilization_percent: int = proto.Field(
             proto.INT32,
             number=2,
@@ -593,6 +610,58 @@ class AutoscalingConfigOverrides(proto.Message):
                     Optional. If specified, overrides the autoscaling target
                     high_priority_cpu_utilization_percent in the top-level
                     autoscaling configuration for the selected replicas.
+                autoscaling_target_total_cpu_utilization_percent (int):
+                    Optional. If specified, overrides the autoscaling target
+                    ``total_cpu_utilization_percent`` in the top-level
+                    autoscaling configuration for the selected replicas.
+                disable_high_priority_cpu_autoscaling (bool):
+                    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.
+                disable_total_cpu_autoscaling (bool):
+                    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.
             """
 
             autoscaling_limits: "AutoscalingConfig.AutoscalingLimits" = proto.Field(
@@ -604,6 +673,18 @@ class AutoscalingConfigOverrides(proto.Message):
                 proto.INT32,
                 number=2,
             )
+            autoscaling_target_total_cpu_utilization_percent: int = proto.Field(
+                proto.INT32,
+                number=4,
+            )
+            disable_high_priority_cpu_autoscaling: bool = proto.Field(
+                proto.BOOL,
+                number=5,
+            )
+            disable_total_cpu_autoscaling: bool = proto.Field(
+                proto.BOOL,
+                number=6,
+            )
 
         replica_selection: common.ReplicaSelection = proto.Field(
             proto.MESSAGE,

google/cloud/spanner_v1/types/__init__.py

@@ -34,7 +34,6 @@
     BatchWriteRequest,
     BatchWriteResponse,
     BeginTransactionRequest,
-    ClientContext,
     CommitRequest,
     CreateSessionRequest,
     DeleteSessionRequest,
@@ -88,7 +87,6 @@
     "BatchWriteRequest",
     "BatchWriteResponse",
     "BeginTransactionRequest",
-    "ClientContext",
     "CommitRequest",
     "CreateSessionRequest",
     "DeleteSessionRequest",

google/cloud/spanner_v1/types/commit_response.py

@@ -20,7 +20,7 @@
 from google.protobuf import timestamp_pb2  # type: ignore
 import proto  # type: ignore
 
-from google.cloud.spanner_v1.types import transaction
+from google.cloud.spanner_v1.types import location, transaction
 
 __protobuf__ = proto.module(
     package="google.spanner.v1",
@@ -54,6 +54,14 @@ class CommitResponse(proto.Message):
             ``IsolationLevel.REPEATABLE_READ``, then the snapshot
             timestamp is the timestamp at which all reads in the
             transaction ran. This timestamp is never returned.
+        cache_update (google.cloud.spanner_v1.types.CacheUpdate):
+            Optional. A cache update expresses a set of changes the
+            client should incorporate into its location cache. The
+            client should discard the changes if they are older than the
+            data it already has. This data can be obtained in response
+            to requests that included a ``RoutingHint`` field, but may
+            also be obtained by explicit location-fetching RPCs which
+            may be added in the future.
     """
 
     class CommitStats(proto.Message):
@@ -98,6 +106,11 @@ class CommitStats(proto.Message):
         number=5,
         message=timestamp_pb2.Timestamp,
     )
+    cache_update: location.CacheUpdate = proto.Field(
+        proto.MESSAGE,
+        number=6,
+        message=location.CacheUpdate,
+    )
 
 
 __all__ = tuple(sorted(__protobuf__.manifest))

google/cloud/spanner_v1/types/location.py

@@ -111,10 +111,9 @@ class Tablet(proto.Message):
             this tablet -- either an IP address or DNS
             hostname and a port number.
         location (str):
-            Where this tablet is located. In the Spanner
-            managed service, this is the name of a region,
-            such as "us-central1". In Spanner Omni, this is
-            a previously created location.
+            Where this tablet is located. This is the
+            name of a Google Cloud region, such as
+            "us-central1".
         role (google.cloud.spanner_v1.types.Tablet.Role):
             The role of the tablet.
         incarnation (bytes):
@@ -593,11 +592,9 @@ class RoutingHint(proto.Message):
             incarnations. The server may include a ``CacheUpdate`` with
             new locations for those tablets.
         client_location (str):
-            If present, the client's current location. In
-            the Spanner managed service, this should be the
-            name of a Google Cloud zone or region, such as
-            "us-central1". In Spanner Omni, this should
-            correspond to a previously created location.
+            If present, the client's current location.
+            This should be the name of a Google Cloud zone
+            or region, such as "us-central1".
 
             If absent, the client's location will be assumed
             to be the same as the location of the server the

google/cloud/spanner_v1/types/result_set.py

@@ -68,6 +68,14 @@ class ResultSet(proto.Message):
             token with the highest sequence number from this transaction
             attempt to the [Commit][google.spanner.v1.Spanner.Commit]
             request for this transaction.
+        cache_update (google.cloud.spanner_v1.types.CacheUpdate):
+            Optional. A cache update expresses a set of changes the
+            client should incorporate into its location cache. The
+            client should discard the changes if they are older than the
+            data it already has. This data can be obtained in response
+            to requests that included a ``RoutingHint`` field, but may
+            also be obtained by explicit location-fetching RPCs which
+            may be added in the future.
     """
 
     metadata: "ResultSetMetadata" = proto.Field(
@@ -90,6 +98,11 @@ class ResultSet(proto.Message):
         number=5,
         message=gs_transaction.MultiplexedSessionPrecommitToken,
     )
+    cache_update: location.CacheUpdate = proto.Field(
+        proto.MESSAGE,
+        number=6,
+        message=location.CacheUpdate,
+    )
 
 
 class PartialResultSet(proto.Message):