feat: [google-cloud-alloydb] Instance.ActivationPolicy field (#14013)

BEGIN_COMMIT_OVERRIDE
feat: Instance.ActivationPolicy field
feat: Cluster.DenyMaintenancePeriod field
feat: InstanceNetworkConfig.network output field
feat: InstanceNetworkConfig.allocated_ip_range_override field
feat: Backup.create_completion_time output field
docs: A comment for field `earliest_restorable_time`
docs: A comment for field `status` in message `PscAutoConnectionConfig`
END_COMMIT_OVERRIDE


- [ ] Regenerate this pull request now.

feat: Cluster.DenyMaintenancePeriod field
feat: InstanceNetworkConfig.network output field
feat: InstanceNetworkConfig.allocated_ip_range_override field
feat: Backup.create_completion_time output field
docs: A comment for field `earliest_restorable_time`
docs: A comment for field `status` in message `PscAutoConnectionConfig`

PiperOrigin-RevId: 772688974

Source-Link:
googleapis/googleapis@1a096dc

Source-Link:
googleapis/googleapis-gen@4ed89b6
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGIvLk93bEJvdC55YW1sIiwiaCI6IjRlZDg5YjYxYWY1MTk1MWM4YWNhMTJhOWIxMmEyNWYxZTU1MzNhYjkifQ==

BEGIN_NESTED_COMMIT
feat: [google-cloud-alloydb] Instance.ActivationPolicy field
feat: Cluster.DenyMaintenancePeriod field
feat: InstanceNetworkConfig.network output field
feat: InstanceNetworkConfig.allocated_ip_range_override field
feat: Backup.create_completion_time output field
docs: A comment for field `earliest_restorable_time`
docs: A comment for field `status` in message `PscAutoConnectionConfig`

PiperOrigin-RevId: 772665820

Source-Link:
googleapis/googleapis@530bb62

Source-Link:
googleapis/googleapis-gen@e7a8c99
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGIvLk93bEJvdC55YW1sIiwiaCI6ImU3YThjOTk0Mjc3ZGM4ODFmMjU2NDUyNzdmMzc0ZjE2MTVkN2NhNDIifQ==
END_NESTED_COMMIT

---------

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

Author: gcf-owl-bot[bot]

packages/google-cloud-alloydb/google/cloud/alloydb/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-alloydb/google/cloud/alloydb_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-alloydb/google/cloud/alloydb_v1/services/alloy_db_admin/async_client.py

@@ -1799,9 +1799,8 @@ async def sample_restore_cluster():
 
         Args:
             request (Optional[Union[google.cloud.alloydb_v1.types.RestoreClusterRequest, dict]]):
-                The request object. Message for restoring a Cluster from
-                a backup or another cluster at a given
-                point in time.
+                The request object. Message for restoring a Cluster from a backup or another
+                cluster at a given point in time. NEXT_ID: 11
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

packages/google-cloud-alloydb/google/cloud/alloydb_v1/services/alloy_db_admin/client.py

@@ -2352,9 +2352,8 @@ def sample_restore_cluster():
 
         Args:
             request (Union[google.cloud.alloydb_v1.types.RestoreClusterRequest, dict]):
-                The request object. Message for restoring a Cluster from
-                a backup or another cluster at a given
-                point in time.
+                The request object. Message for restoring a Cluster from a backup or another
+                cluster at a given point in time. NEXT_ID: 11
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

packages/google-cloud-alloydb/google/cloud/alloydb_v1/services/alloy_db_admin/transports/rest.py

@@ -6890,9 +6890,8 @@ def __call__(
 
             Args:
                 request (~.service.RestoreClusterRequest):
-                    The request object. Message for restoring a Cluster from
-                a backup or another cluster at a given
-                point in time.
+                    The request object. Message for restoring a Cluster from a backup or another
+                cluster at a given point in time. NEXT_ID: 11
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.

packages/google-cloud-alloydb/google/cloud/alloydb_v1/types/resources.py

@@ -20,6 +20,7 @@
 from google.protobuf import duration_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 from google.protobuf import wrappers_pb2  # type: ignore
+from google.type import date_pb2  # type: ignore
 from google.type import dayofweek_pb2  # type: ignore
 from google.type import timeofday_pb2  # type: ignore
 import proto  # type: ignore
@@ -569,11 +570,20 @@ class ContinuousBackupInfo(proto.Message):
             ContinuousBackup is not enabled.
         schedule (MutableSequence[google.type.dayofweek_pb2.DayOfWeek]):
             Output only. Days of the week on which a
-            continuous backup is taken. Output only field.
-            Ignored if passed into the request.
+            continuous backup is taken.
         earliest_restorable_time (google.protobuf.timestamp_pb2.Timestamp):
-            Output only. The earliest restorable time
-            that can be restored to. Output only field.
+            Output only. The earliest restorable time that can be
+            restored to. If continuous backups and recovery was recently
+            enabled, the earliest restorable time is the creation time
+            of the earliest eligible backup within this cluster's
+            continuous backup recovery window. After a cluster has had
+            continuous backups enabled for the duration of its recovery
+            window, the earliest restorable time becomes "now minus the
+            recovery window". For example, assuming a point in time
+            recovery is attempted at 04/16/2025 3:23:00PM with a 14d
+            recovery window, the earliest restorable time would be
+            04/02/2025 3:23:00PM. This field is only visible if the
+            CLUSTER_VIEW_CONTINUOUS_BACKUP cluster view is provided.
     """
 
     encryption_info: "EncryptionInfo" = proto.Field(
@@ -656,6 +666,9 @@ class MaintenanceUpdatePolicy(proto.Message):
         maintenance_windows (MutableSequence[google.cloud.alloydb_v1.types.MaintenanceUpdatePolicy.MaintenanceWindow]):
             Preferred windows to perform maintenance.
             Currently limited to 1.
+        deny_maintenance_periods (MutableSequence[google.cloud.alloydb_v1.types.MaintenanceUpdatePolicy.DenyMaintenancePeriod]):
+            Periods to deny maintenance. Currently
+            limited to 1.
     """
 
     class MaintenanceWindow(proto.Message):
@@ -683,11 +696,58 @@ class MaintenanceWindow(proto.Message):
             message=timeofday_pb2.TimeOfDay,
         )
 
+    class DenyMaintenancePeriod(proto.Message):
+        r"""DenyMaintenancePeriod definition. Excepting emergencies, maintenance
+        will not be scheduled to start within this deny period. The
+        start_date must be less than the end_date.
+
+        Attributes:
+            start_date (google.type.date_pb2.Date):
+                Deny period start date. This can be:
+
+                -  A full date, with non-zero year, month and day values OR
+                -  A month and day value, with a zero year for recurring
+            end_date (google.type.date_pb2.Date):
+                Deny period end date. This can be:
+
+                -  A full date, with non-zero year, month and day values OR
+                -  A month and day value, with a zero year for recurring
+            time (google.type.timeofday_pb2.TimeOfDay):
+                Time in UTC when the deny period starts on start_date and
+                ends on end_date. This can be:
+
+                -  Full time OR
+                -  All zeros for 00:00:00 UTC
+        """
+
+        start_date: date_pb2.Date = proto.Field(
+            proto.MESSAGE,
+            number=1,
+            message=date_pb2.Date,
+        )
+        end_date: date_pb2.Date = proto.Field(
+            proto.MESSAGE,
+            number=2,
+            message=date_pb2.Date,
+        )
+        time: timeofday_pb2.TimeOfDay = proto.Field(
+            proto.MESSAGE,
+            number=3,
+            message=timeofday_pb2.TimeOfDay,
+        )
+
     maintenance_windows: MutableSequence[MaintenanceWindow] = proto.RepeatedField(
         proto.MESSAGE,
         number=1,
         message=MaintenanceWindow,
     )
+    deny_maintenance_periods: MutableSequence[
+        DenyMaintenancePeriod
+    ] = proto.RepeatedField(
+        proto.MESSAGE,
+        number=2,
+        message=DenyMaintenancePeriod,
+    )
 
 
 class MaintenanceSchedule(proto.Message):
@@ -1358,6 +1418,15 @@ class Instance(proto.Message):
         outbound_public_ip_addresses (MutableSequence[str]):
             Output only. All outbound public IP addresses
             configured for the instance.
+        activation_policy (google.cloud.alloydb_v1.types.Instance.ActivationPolicy):
+            Optional. Specifies whether an instance needs to spin up.
+            Once the instance is active, the activation policy can be
+            updated to the ``NEVER`` to stop the instance. Likewise, the
+            activation policy can be updated to ``ALWAYS`` to start the
+            instance. There are restrictions around when an instance
+            can/cannot be activated (for example, a read pool instance
+            should be stopped before stopping primary etc.). Please
+            refer to the API documentation for more details.
     """
 
     class State(proto.Enum):
@@ -1449,6 +1518,21 @@ class AvailabilityType(proto.Enum):
         ZONAL = 1
         REGIONAL = 2
 
+    class ActivationPolicy(proto.Enum):
+        r"""Specifies whether an instance needs to spin up.
+
+        Values:
+            ACTIVATION_POLICY_UNSPECIFIED (0):
+                The policy is not specified.
+            ALWAYS (1):
+                The instance is running.
+            NEVER (2):
+                The instance is not running.
+        """
+        ACTIVATION_POLICY_UNSPECIFIED = 0
+        ALWAYS = 1
+        NEVER = 2
+
     class MachineConfig(proto.Message):
         r"""MachineConfig describes the configuration of a machine.
 
@@ -1734,11 +1818,31 @@ class PscAutoConnectionConfig(proto.Message):
                 Output only. The IP address of the PSC
                 service automation endpoint.
             status (str):
-                Output only. The status of the PSC service
-                automation connection.
+                Output only. The status of the PSC service automation
+                connection. Possible values: "STATE_UNSPECIFIED" - An
+                invalid state as the default case. "ACTIVE" - The connection
+                has been created successfully. "FAILED" - The connection is
+                not functional since some resources on the connection fail
+                to be created. "CREATING" - The connection is being created.
+                "DELETING" - The connection is being deleted.
+                "CREATE_REPAIRING" - The connection is being repaired to
+                complete creation. "DELETE_REPAIRING" - The connection is
+                being repaired to complete deletion.
             consumer_network_status (str):
-                Output only. The status of the service
-                connection policy.
+                Output only. The status of the service connection policy.
+                Possible values: "STATE_UNSPECIFIED" - Default state, when
+                Connection Map is created initially. "VALID" - Set when
+                policy and map configuration is valid, and their matching
+                can lead to allowing creation of PSC Connections subject to
+                other constraints like connections limit.
+                "CONNECTION_POLICY_MISSING" - No Service Connection Policy
+                found for this network and Service Class
+                "POLICY_LIMIT_REACHED" - Service Connection Policy limit
+                reached for this network and Service Class
+                "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer
+                instance project is not in
+                AllowedGoogleProducersResourceHierarchyLevels of the
+                matching ServiceConnectionPolicy.
         """
 
         consumer_project: str = proto.Field(
@@ -1832,6 +1936,23 @@ class InstanceNetworkConfig(proto.Message):
                 Optional. Enabling an outbound public IP
                 address to support a database server sending
                 requests out into the internet.
+            network (str):
+                Output only. The resource link for the VPC network in which
+                instance resources are created and from which they are
+                accessible via Private IP. This will be the same value as
+                the parent cluster's network. It is specified in the form:
+                //
+                ``projects/{project_number}/global/networks/{network_id}``.
+            allocated_ip_range_override (str):
+                Optional. Name of the allocated IP range for the private IP
+                AlloyDB instance, for example:
+                "google-managed-services-default". If set, the instance IPs
+                will be created from this allocated range and will override
+                the IP range used by the parent cluster. The range name must
+                comply with `RFC
+                1035 <http://datatracker.ietf.org/doc/html/rfc1035>`__.
+                Specifically, the name must be 1-63 characters long and
+                match the regular expression `a-z <[-a-z0-9]*[a-z0-9]>`__?.
         """
 
         class AuthorizedNetwork(proto.Message):
@@ -1864,6 +1985,14 @@ class AuthorizedNetwork(proto.Message):
             proto.BOOL,
             number=3,
         )
+        network: str = proto.Field(
+            proto.STRING,
+            number=4,
+        )
+        allocated_ip_range_override: str = proto.Field(
+            proto.STRING,
+            number=5,
+        )
 
     name: str = proto.Field(
         proto.STRING,
@@ -1995,6 +2124,11 @@ class AuthorizedNetwork(proto.Message):
         proto.STRING,
         number=34,
     )
+    activation_policy: ActivationPolicy = proto.Field(
+        proto.ENUM,
+        number=35,
+        enum=ActivationPolicy,
+    )
 
 
 class ConnectionInfo(proto.Message):
@@ -2066,8 +2200,15 @@ class Backup(proto.Message):
             Output only. Create time stamp
         update_time (google.protobuf.timestamp_pb2.Timestamp):
             Output only. Update time stamp
+
+            Users should not infer any meaning from this
+            field. Its value is generally unrelated to the
+            timing of the backup creation operation.
         delete_time (google.protobuf.timestamp_pb2.Timestamp):
             Output only. Delete time stamp
+        create_completion_time (google.protobuf.timestamp_pb2.Timestamp):
+            Output only. Timestamp when the resource
+            finished being created.
         labels (MutableMapping[str, str]):
             Labels as key value pairs
         state (google.cloud.alloydb_v1.types.Backup.State):
@@ -2244,6 +2385,11 @@ class QuantityBasedExpiry(proto.Message):
         number=15,
         message=timestamp_pb2.Timestamp,
     )
+    create_completion_time: timestamp_pb2.Timestamp = proto.Field(
+        proto.MESSAGE,
+        number=26,
+        message=timestamp_pb2.Timestamp,
+    )
     labels: MutableMapping[str, str] = proto.MapField(
         proto.STRING,
         proto.STRING,

packages/google-cloud-alloydb/google/cloud/alloydb_v1/types/service.py

@@ -884,7 +884,7 @@ class StageInfo(proto.Message):
         )
 
     class InstanceUpgradeDetails(proto.Message):
-        r"""Details regarding the upgrade of instaces associated with a
+        r"""Details regarding the upgrade of instances associated with a
         cluster.
 
         Attributes:
@@ -1162,8 +1162,8 @@ class PromoteClusterRequest(proto.Message):
 
 
 class RestoreClusterRequest(proto.Message):
-    r"""Message for restoring a Cluster from a backup or another
-    cluster at a given point in time.
+    r"""Message for restoring a Cluster from a backup or another cluster at
+    a given point in time. NEXT_ID: 11
 
     This message has `oneof`_ fields (mutually exclusive fields).
     For each oneof, at most one member field can be set at the same time.

packages/google-cloud-alloydb/google/cloud/alloydb_v1alpha/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-alloydb/google/cloud/alloydb_v1beta/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.4.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-alloydb/google/cloud/alloydb_v1beta/services/alloy_db_admin/async_client.py

@@ -1805,9 +1805,8 @@ async def sample_restore_cluster():
 
         Args:
             request (Optional[Union[google.cloud.alloydb_v1beta.types.RestoreClusterRequest, dict]]):
-                The request object. Message for restoring a Cluster from
-                a backup or another cluster at a given
-                point in time.
+                The request object. Message for restoring a Cluster from a backup or another
+                cluster at a given point in time. NEXT_ID: 11
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.