chore(bigtable): deprecate legacy handwritten Client and Instance admin methods

packages/google-cloud-bigtable/google/cloud/bigtable/client.py

@@ -291,6 +291,10 @@ def table_data_client(self):
     def table_admin_client(self):
         """Getter for the gRPC stub used for the Table Admin API.
 
+        .. deprecated:: 2.30.0
+            Use :class:`google.cloud.bigtable_admin_v2.BigtableTableAdminClient`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -324,6 +328,10 @@ def table_admin_client(self):
     def instance_admin_client(self):
         """Getter for the gRPC stub used for the Table Admin API.
 
+        .. deprecated:: 2.30.0
+            Use :class:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -423,6 +431,11 @@ def instance(self, instance_id, display_name=None, instance_type=None, labels=No
     def list_instances(self):
         """List instances owned by the project.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.list_instances`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -446,6 +459,11 @@ def list_instances(self):
     def list_clusters(self):
         """List the clusters in the project.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.list_clusters`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py

packages/google-cloud-bigtable/google/cloud/bigtable/instance.py

@@ -229,6 +229,11 @@ def create(
     ):
         """Create this instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.create_instance`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -338,6 +343,11 @@ def create(
     def exists(self):
         """Check whether the instance already exists.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.get_instance`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -358,6 +368,11 @@ def exists(self):
     def reload(self):
         """Reload the metadata for this instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.get_instance`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -376,6 +391,11 @@ def reload(self):
     def update(self):
         """Updates an instance within a project.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.partial_update_instance`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -423,6 +443,11 @@ def update(self):
     def delete(self):
         """Delete this instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.delete_instance`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -454,6 +479,11 @@ def delete(self):
     def get_iam_policy(self, requested_policy_version=None):
         """Gets the access control policy for an instance resource.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.get_iam_policy`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -491,6 +521,11 @@ def set_iam_policy(self, policy):
         """Sets the access control policy on an instance resource. Replaces any
         existing policy.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.set_iam_policy`
+            instead.
+
         For more information about policy, please see documentation of
         class `google.cloud.bigtable.policy.Policy`
 
@@ -518,6 +553,11 @@ def test_iam_permissions(self, permissions):
         """Returns permissions that the caller has on the specified instance
         resource.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.test_iam_permissions`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -556,6 +596,10 @@ def cluster(
     ):
         """Factory to create a cluster associated with this instance.
 
+        .. deprecated:: 2.30.0
+            Use :class:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -620,6 +664,11 @@ def cluster(
     def list_clusters(self):
         """List the clusters in this instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.list_clusters`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -672,6 +721,11 @@ def table(self, table_id, mutation_timeout=None, app_profile_id=None):
     def list_tables(self):
         """List the tables in this instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableTableAdminClient.list_tables`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -711,6 +765,10 @@ def app_profile(
     ):
         """Factory to create AppProfile associated with this instance.
 
+        .. deprecated:: 2.30.0
+            Use :class:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py
@@ -764,6 +822,11 @@ def app_profile(
     def list_app_profiles(self):
         """Lists information about AppProfiles in an instance.
 
+        .. deprecated:: 2.30.0
+            Use
+            :meth:`google.cloud.bigtable_admin_v2.BigtableInstanceAdminClient.list_app_profiles`
+            instead.
+
         For example:
 
         .. literalinclude:: snippets.py