feat: [google-cloud-alloydb-connectors] Sync AlloyDB API changes from HEAD to stable (googleapis#13894)

gcf-owl-bot[bot] · web-flow · commit 673b3a2e7e11 · 2025-05-15T20:03:59.000+05:00
BEGIN_COMMIT_OVERRIDE feat: Sync AlloyDB API changes from HEAD to stable feat: Add new CSQL API for supporting Cluster creation from Cloud SQL feat: Add new methods for exporting, importing and upgrade Cluster operations feat: Add new fields to support observability configurations, machine types and PSC related configs docs: A comment for field `encryption_config` in message `.google.cloud.alloydb.v1.AutomatedBackupPolicy` is changed docs: A comment for field `encryption_config` in message `.google.cloud.alloydb.v1.ContinuousBackupConfig` is changed docs: A comment for message `Instance` is changed docs: A comment for field `zone_id` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `id` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `ip` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `state` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `database_flags` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `user` in message `.google.cloud.alloydb.v1.ExecuteSqlRequest` is changed docs: A comment for field `use_metadata_exchange` in message `.google.cloud.alloydb.v1.GenerateClientCertificateRequest` is changed docs: A comment for field `requested_cancellation` in message `.google.cloud.alloydb.v1.OperationMetadata` is changed END_COMMIT_OVERRIDE - [ ] Regenerate this pull request now. feat: Add new CSQL API for supporting Cluster creation from Cloud SQL feat: Add new methods for exporting, importing and upgrade Cluster operations feat: Add new fields to support observability configurations, machine types and PSC related configs docs: A comment for field `encryption_config` in message `.google.cloud.alloydb.v1.AutomatedBackupPolicy` is changed docs: A comment for field `encryption_config` in message `.google.cloud.alloydb.v1.ContinuousBackupConfig` is changed docs: A comment for message `Instance` is changed docs: A comment for field `zone_id` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `id` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `ip` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `state` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `database_flags` in message `.google.cloud.alloydb.v1.Instance` is changed docs: A comment for field `user` in message `.google.cloud.alloydb.v1.ExecuteSqlRequest` is changed docs: A comment for field `use_metadata_exchange` in message `.google.cloud.alloydb.v1.GenerateClientCertificateRequest` is changed docs: A comment for field `requested_cancellation` in message `.google.cloud.alloydb.v1.OperationMetadata` is changed PiperOrigin-RevId: 757903570 Source-Link: googleapis/googleapis@809eb53 Source-Link: https://github.com/googleapis/googleapis-gen/commit/7b4500dffccde37372af17c6ee07a3332720fde2 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGItY29ubmVjdG9ycy8uT3dsQm90LnlhbWwiLCJoIjoiN2I0NTAwZGZmY2NkZTM3MzcyYWYxN2M2ZWUwN2EzMzMyNzIwZmRlMiJ9 --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/packages/google-cloud-alloydb-connectors/docs/connectors_v1alpha/services_.rst b/packages/google-cloud-alloydb-connectors/docs/connectors_v1alpha/services_.rst
@@ -0,0 +1,4 @@
+Services for Google Cloud Alloydb Connectors v1alpha API
+========================================================
+.. toctree::
+    :maxdepth: 2
diff --git a/packages/google-cloud-alloydb-connectors/docs/connectors_v1alpha/types_.rst b/packages/google-cloud-alloydb-connectors/docs/connectors_v1alpha/types_.rst
@@ -0,0 +1,6 @@
+Types for Google Cloud Alloydb Connectors v1alpha API
+=====================================================
+
+.. automodule:: google.cloud.alloydb.connectors_v1alpha.types
+    :members:
+    :show-inheritance:
diff --git a/packages/google-cloud-alloydb-connectors/docs/connectors_v1beta/services_.rst b/packages/google-cloud-alloydb-connectors/docs/connectors_v1beta/services_.rst
@@ -0,0 +1,4 @@
+Services for Google Cloud Alloydb Connectors v1beta API
+=======================================================
+.. toctree::
+    :maxdepth: 2
diff --git a/packages/google-cloud-alloydb-connectors/docs/connectors_v1beta/types_.rst b/packages/google-cloud-alloydb-connectors/docs/connectors_v1beta/types_.rst
@@ -0,0 +1,6 @@
+Types for Google Cloud Alloydb Connectors v1beta API
+====================================================
+
+.. automodule:: google.cloud.alloydb.connectors_v1beta.types
+    :members:
+    :show-inheritance:
diff --git a/packages/google-cloud-alloydb-connectors/docs/index.rst b/packages/google-cloud-alloydb-connectors/docs/index.rst
@@ -2,6 +2,9 @@
 
 .. include:: multiprocessing.rst
 
+This package includes clients for multiple versions of AlloyDB connectors.
+By default, you will get version ``connectors_v1``.
+
 
 API Reference
 -------------
@@ -11,6 +14,22 @@ API Reference
     connectors_v1/services_
     connectors_v1/types_
 
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    connectors_v1alpha/services_
+    connectors_v1alpha/types_
+
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    connectors_v1beta/services_
+    connectors_v1beta/types_
+
 
 Changelog
 ---------
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/__init__.py
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from google.cloud.alloydb.connectors_v1alpha import gapic_version as package_version
+
+__version__ = package_version.__version__
+
+
+from .types.resources import MetadataExchangeRequest, MetadataExchangeResponse
+
+__all__ = (
+    "MetadataExchangeRequest",
+    "MetadataExchangeResponse",
+)
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/gapic_metadata.json b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/gapic_metadata.json
@@ -0,0 +1,7 @@
+ {
+  "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+  "language": "python",
+  "libraryPackage": "google.cloud.alloydb.connectors_v1alpha",
+  "protoPackage": "google.cloud.alloydb.connectors.v1alpha",
+  "schema": "1.0"
+}
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/gapic_version.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/gapic_version.py
@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/py.typed b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/py.typed
@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-alloydb-connectors package uses inline types.
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/services/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/services/__init__.py
@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/types/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/types/__init__.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from .resources import MetadataExchangeRequest, MetadataExchangeResponse
+
+__all__ = (
+    "MetadataExchangeRequest",
+    "MetadataExchangeResponse",
+)
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/types/resources.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1alpha/types/resources.py
@@ -0,0 +1,121 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from __future__ import annotations
+
+from typing import MutableMapping, MutableSequence
+
+import proto  # type: ignore
+
+__protobuf__ = proto.module(
+    package="google.cloud.alloydb.connectors.v1alpha",
+    manifest={
+        "MetadataExchangeRequest",
+        "MetadataExchangeResponse",
+    },
+)
+
+
+class MetadataExchangeRequest(proto.Message):
+    r"""Message used by AlloyDB connectors to exchange client and
+    connection metadata with the server after a successful TLS
+    handshake. This metadata includes an IAM token, which is used to
+    authenticate users based on their IAM identity. The sole purpose
+    of this message is for the use of AlloyDB connectors. Clients
+    should not rely on this message directly as there can be
+    breaking changes in the future.
+
+    Attributes:
+        user_agent (str):
+            Optional. Connector information.
+        auth_type (google.cloud.alloydb.connectors_v1alpha.types.MetadataExchangeRequest.AuthType):
+            Authentication type.
+        oauth2_token (str):
+            IAM token used for both IAM user authentiation and
+            ``alloydb.instances.connect`` permission check.
+    """
+
+    class AuthType(proto.Enum):
+        r"""AuthType contains all supported authentication types.
+
+        Values:
+            AUTH_TYPE_UNSPECIFIED (0):
+                Authentication type is unspecified and DB_NATIVE is used by
+                default
+            DB_NATIVE (1):
+                Database native authentication
+                (user/password)
+            AUTO_IAM (2):
+                Automatic IAM authentication
+        """
+        AUTH_TYPE_UNSPECIFIED = 0
+        DB_NATIVE = 1
+        AUTO_IAM = 2
+
+    user_agent: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+    auth_type: AuthType = proto.Field(
+        proto.ENUM,
+        number=2,
+        enum=AuthType,
+    )
+    oauth2_token: str = proto.Field(
+        proto.STRING,
+        number=3,
+    )
+
+
+class MetadataExchangeResponse(proto.Message):
+    r"""Message for response to metadata exchange request. The sole
+    purpose of this message is for the use of AlloyDB connectors.
+    Clients should not rely on this message directly as there can be
+    breaking changes in the future.
+
+    Attributes:
+        response_code (google.cloud.alloydb.connectors_v1alpha.types.MetadataExchangeResponse.ResponseCode):
+            Response code.
+        error (str):
+            Optional. Error message.
+    """
+
+    class ResponseCode(proto.Enum):
+        r"""Response code.
+
+        Values:
+            RESPONSE_CODE_UNSPECIFIED (0):
+                Unknown response code
+            OK (1):
+                Success
+            ERROR (2):
+                Failure
+        """
+        RESPONSE_CODE_UNSPECIFIED = 0
+        OK = 1
+        ERROR = 2
+
+    response_code: ResponseCode = proto.Field(
+        proto.ENUM,
+        number=1,
+        enum=ResponseCode,
+    )
+    error: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
+
+
+__all__ = tuple(sorted(__protobuf__.manifest))
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/__init__.py
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from google.cloud.alloydb.connectors_v1beta import gapic_version as package_version
+
+__version__ = package_version.__version__
+
+
+from .types.resources import MetadataExchangeRequest, MetadataExchangeResponse
+
+__all__ = (
+    "MetadataExchangeRequest",
+    "MetadataExchangeResponse",
+)
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/gapic_metadata.json b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/gapic_metadata.json
@@ -0,0 +1,7 @@
+ {
+  "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+  "language": "python",
+  "libraryPackage": "google.cloud.alloydb.connectors_v1beta",
+  "protoPackage": "google.cloud.alloydb.connectors.v1beta",
+  "schema": "1.0"
+}
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/gapic_version.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/gapic_version.py
@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+__version__ = "0.0.0"  # {x-release-please-version}
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/py.typed b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/py.typed
@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-alloydb-connectors package uses inline types.
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/services/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/services/__init__.py
@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/types/__init__.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/types/__init__.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from .resources import MetadataExchangeRequest, MetadataExchangeResponse
+
+__all__ = (
+    "MetadataExchangeRequest",
+    "MetadataExchangeResponse",
+)
diff --git a/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/types/resources.py b/packages/google-cloud-alloydb-connectors/google/cloud/alloydb/connectors_v1beta/types/resources.py
diff --git a/packages/google-cloud-alloydb-connectors/scripts/fixup_connectors_v1alpha_keywords.py b/packages/google-cloud-alloydb-connectors/scripts/fixup_connectors_v1alpha_keywords.py
diff --git a/packages/google-cloud-alloydb-connectors/scripts/fixup_connectors_v1beta_keywords.py b/packages/google-cloud-alloydb-connectors/scripts/fixup_connectors_v1beta_keywords.py
diff --git a/packages/google-cloud-alloydb-connectors/tests/unit/gapic/connectors_v1alpha/__init__.py b/packages/google-cloud-alloydb-connectors/tests/unit/gapic/connectors_v1alpha/__init__.py
diff --git a/packages/google-cloud-alloydb-connectors/tests/unit/gapic/connectors_v1beta/__init__.py b/packages/google-cloud-alloydb-connectors/tests/unit/gapic/connectors_v1beta/__init__.py

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+# Marker file for PEP 561.`
	`2`	`+# The google-cloud-alloydb-connectors package uses inline types.`