feat: Add transport override to enable the use of REST instead of GRPC

PiperOrigin-RevId: 611159115

google/cloud/aiplatform/initializer.py

@@ -104,6 +104,7 @@ def __init__(self):
         self._network = None
         self._service_account = None
         self._api_endpoint = None
+        self._api_transport = None
 
     def init(
         self,
@@ -121,6 +122,7 @@ def init(
         network: Optional[str] = None,
         service_account: Optional[str] = None,
         api_endpoint: Optional[str] = None,
+        api_transport: Optional[str] = None,
     ):
         """Updates common initialization parameters with provided options.
 
@@ -179,6 +181,8 @@ def init(
             api_endpoint (str):
                 Optional. The desired API endpoint,
                 e.g., us-central1-aiplatform.googleapis.com
+            api_transport (str):
+                Optional. The transport method which is either 'grpc' or 'rest'
         Raises:
             ValueError:
                 If experiment_description is provided but experiment is not.
@@ -231,6 +235,15 @@ def init(
                 backing_tensorboard=experiment_tensorboard,
             )
 
+        if api_transport:
+            VALID_TRANSPORT_TYPES = ["grpc", "rest"]
+            if api_transport not in VALID_TRANSPORT_TYPES:
+                raise ValueError(
+                    f"{api_transport} is not a valid transport type. "
+                    + f"Valid transport types: {VALID_TRANSPORT_TYPES}"
+                )
+            self._api_transport = api_transport
+
     def get_encryption_spec(
         self,
         encryption_spec_key_name: Optional[str],
@@ -481,6 +494,17 @@ def create_client(
             "client_info": client_info,
         }
 
+        # Do not pass "grpc", rely on gapic defaults unless "rest" is specified
+        if self._api_transport == "rest":
+            if "Async" in client_class.__name__:
+                # Warn user that "rest" is not supported and use grpc instead
+                logging.warning(
+                    "REST is not supported for async clients, "
+                    + "falling back to grpc."
+                )
+            else:
+                kwargs["transport"] = self._api_transport
+
         return client_class(**kwargs)
 
 

google/cloud/aiplatform/utils/__init__.py

@@ -388,6 +388,7 @@ def __init__(
             client_options: client_options.ClientOptions,
             client_info: gapic_v1.client_info.ClientInfo,
             credentials: Optional[auth_credentials.Credentials] = None,
+            transport: Optional[str] = None,
         ):
             """Stores parameters needed to instantiate client.
 
@@ -400,20 +401,30 @@ def __init__(
                     Required. Client info to pass to client.
                 credentials (auth_credentials.credentials):
                     Optional. Client credentials to pass to client.
+                transport (str):
+                    Optional. Transport type to pass to client.
             """
 
             self._client_class = client_class
             self._credentials = credentials
             self._client_options = client_options
             self._client_info = client_info
+            self._api_transport = transport
 
         def __getattr__(self, name: str) -> Any:
             """Instantiates client and returns attribute of the client."""
-            temporary_client = self._client_class(
+
+            kwargs = dict(
                 credentials=self._credentials,
                 client_options=self._client_options,
                 client_info=self._client_info,
             )
+
+            if self._api_transport is not None:
+                kwargs["transport"] = self._api_transport
+
+            temporary_client = self._client_class(**kwargs)
+
             return getattr(temporary_client, name)
 
     @property
@@ -448,6 +459,7 @@ def __init__(
         client_options: client_options.ClientOptions,
         client_info: gapic_v1.client_info.ClientInfo,
         credentials: Optional[auth_credentials.Credentials] = None,
+        transport: Optional[str] = None,
     ):
         """Stores parameters needed to instantiate client.
 
@@ -458,21 +470,28 @@ def __init__(
                 Required. Client info to pass to client.
             credentials (auth_credentials.credentials):
                 Optional. Client credentials to pass to client.
+            transport (str):
+                Optional. Transport type to pass to client.
         """
+        kwargs = dict(
+            credentials=credentials,
+            client_options=client_options,
+            client_info=client_info,
+        )
+
+        if transport is not None:
+            kwargs["transport"] = transport
 
         self._clients = {
             version: self.WrappedClient(
                 client_class=client_class,
                 client_options=client_options,
                 client_info=client_info,
                 credentials=credentials,
+                transport=transport,
             )
             if self._is_temporary
-            else client_class(
-                client_options=client_options,
-                client_info=client_info,
-                credentials=credentials,
-            )
+            else client_class(**kwargs)
             for version, client_class in self._version_map
         }