Client for interacting with Google Cloud Bigtable API.
Parameters
Name
Description
project
strorunicode
(Optional) The ID of the project which owns the instances, tables and data. If not provided, will attempt to determine from the environment.
credentials
google.auth.credentials.Credentials
(Optional) The OAuth2 Credentials to use for this client. If not passed, falls back to the default inferred from the environment.
read_only
bool
(Optional) Boolean indicating if the data scope should be for reading only (or for writing as well). Defaults to :data:False.
admin
bool
(Optional) Boolean indicating if the client will be used to interact with the Instance Admin or Table Admin APIs. This requires the :const:ADMIN_SCOPE. Defaults to :data:False. :type: client_info:google.api_core.gapic_v1.client_info.ClientInfo
(Optional) The display name for the instance in the Cloud Console UI. (Must be between 4 and 30 characters.) If this value is not set in the constructor, will fall back to the instance ID.
(Optional) Labels are a flexible and lightweight mechanism for organizing cloud resources into groups that reflect a customer's organizational needs and deployment strategies. They can be used to filter resources and aggregate metrics. Label keys must be between 1 and 63 characters long. Maximum 64 labels can be associated with a given resource. Label values must be between 0 and 63 characters long. Keys and values must both be under 128 bytes.
(clusters, failed_locations), where 'clusters' is list ofCluster, and 'failed_locations' is a list of strings representing locations which could not be resolved.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Class Client (2.32.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.32.0 (latest)](/python/docs/reference/bigtable/latest/google.cloud.bigtable.client.Client)\n- [2.31.0](/python/docs/reference/bigtable/2.31.0/google.cloud.bigtable.client.Client)\n- [2.30.1](/python/docs/reference/bigtable/2.30.1/google.cloud.bigtable.client.Client)\n- [2.29.0](/python/docs/reference/bigtable/2.29.0/google.cloud.bigtable.client.Client)\n- [2.28.1](/python/docs/reference/bigtable/2.28.1/google.cloud.bigtable.client.Client)\n- [2.26.0](/python/docs/reference/bigtable/2.26.0/google.cloud.bigtable.client.Client)\n- [2.25.0](/python/docs/reference/bigtable/2.25.0/google.cloud.bigtable.client.Client)\n- [2.24.0](/python/docs/reference/bigtable/2.24.0/google.cloud.bigtable.client.Client)\n- [2.23.1](/python/docs/reference/bigtable/2.23.1/google.cloud.bigtable.client.Client)\n- [2.22.0](/python/docs/reference/bigtable/2.22.0/google.cloud.bigtable.client.Client)\n- [2.21.0](/python/docs/reference/bigtable/2.21.0/google.cloud.bigtable.client.Client)\n- [2.20.0](/python/docs/reference/bigtable/2.20.0/google.cloud.bigtable.client.Client)\n- [2.19.0](/python/docs/reference/bigtable/2.19.0/google.cloud.bigtable.client.Client)\n- [2.18.1](/python/docs/reference/bigtable/2.18.1/google.cloud.bigtable.client.Client)\n- [2.17.0](/python/docs/reference/bigtable/2.17.0/google.cloud.bigtable.client.Client)\n- [2.16.0](/python/docs/reference/bigtable/2.16.0/google.cloud.bigtable.client.Client)\n- [2.15.0](/python/docs/reference/bigtable/2.15.0/google.cloud.bigtable.client.Client)\n- [2.14.1](/python/docs/reference/bigtable/2.14.1/google.cloud.bigtable.client.Client)\n- [2.13.2](/python/docs/reference/bigtable/2.13.2/google.cloud.bigtable.client.Client)\n- [2.12.0](/python/docs/reference/bigtable/2.12.0/google.cloud.bigtable.client.Client)\n- [2.11.3](/python/docs/reference/bigtable/2.11.3/google.cloud.bigtable.client.Client)\n- [2.10.1](/python/docs/reference/bigtable/2.10.1/google.cloud.bigtable.client.Client)\n- [2.9.0](/python/docs/reference/bigtable/2.9.0/google.cloud.bigtable.client.Client)\n- [2.8.1](/python/docs/reference/bigtable/2.8.1/google.cloud.bigtable.client.Client)\n- [2.7.1](/python/docs/reference/bigtable/2.7.1/google.cloud.bigtable.client.Client)\n- [2.6.0](/python/docs/reference/bigtable/2.6.0/google.cloud.bigtable.client.Client)\n- [2.5.2](/python/docs/reference/bigtable/2.5.2/google.cloud.bigtable.client.Client)\n- [2.4.0](/python/docs/reference/bigtable/2.4.0/google.cloud.bigtable.client.Client)\n- [2.3.3](/python/docs/reference/bigtable/2.3.3/google.cloud.bigtable.client.Client)\n- [2.2.0](/python/docs/reference/bigtable/2.2.0/google.cloud.bigtable.client.Client)\n- [2.1.0](/python/docs/reference/bigtable/2.1.0/google.cloud.bigtable.client.Client)\n- [2.0.0](/python/docs/reference/bigtable/2.0.0/google.cloud.bigtable.client.Client)\n- [1.7.3](/python/docs/reference/bigtable/1.7.3/google.cloud.bigtable.client.Client)\n- [1.6.1](/python/docs/reference/bigtable/1.6.1/google.cloud.bigtable.client.Client)\n- [1.5.1](/python/docs/reference/bigtable/1.5.1/google.cloud.bigtable.client.Client)\n- [1.4.0](/python/docs/reference/bigtable/1.4.0/google.cloud.bigtable.client.Client)\n- [1.3.0](/python/docs/reference/bigtable/1.3.0/google.cloud.bigtable.client.Client)\n- [1.2.1](/python/docs/reference/bigtable/1.2.1/google.cloud.bigtable.client.Client)\n- [1.1.0](/python/docs/reference/bigtable/1.1.0/google.cloud.bigtable.client.Client)\n- [1.0.0](/python/docs/reference/bigtable/1.0.0/google.cloud.bigtable.client.Client)\n- [0.34.0](/python/docs/reference/bigtable/0.34.0/google.cloud.bigtable.client.Client) \n\n Client(\n project=None,\n credentials=None,\n read_only=False,\n admin=False,\n client_info=None,\n client_options=None,\n admin_client_options=None,\n channel=None,\n )\n\nClient for interacting with Google Cloud Bigtable API.\n| **Note:** Since the Cloud Bigtable API requires the gRPC transport, no `_http` argument is accepted by this class.\n\nProperties\n----------\n\n### instance_admin_client\n\nGetter for the gRPC stub used for the Table Admin API.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_instance_admin_client\\]\n:end-before: \\[END bigtable_api_instance_admin_client\\]\n:dedent: 4\n\n### project_path\n\n\u003cbr /\u003e\n\nProject name to be used with Instance Admin API.\n\n\u003cbr /\u003e\n\n| **Note:** This property will not change if `project` does not, but the return value is not cached.\n.. literalinclude:: snippets.py :start-after: \\[START bigtable_api_project_path\\] :end-before: \\[END bigtable_api_project_path\\] :dedent: 4\n\n\u003cbr /\u003e\n\nThe project name is of the form\n\n\u003cbr /\u003e\n\n `\"projects/{project}\"`\n\n### table_admin_client\n\nGetter for the gRPC stub used for the Table Admin API.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_table_admin_client\\]\n:end-before: \\[END bigtable_api_table_admin_client\\]\n:dedent: 4\n\n### table_data_client\n\nGetter for the gRPC stub used for the Table Admin API.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_table_data_client\\]\n:end-before: \\[END bigtable_api_table_data_client\\]\n:dedent: 4\n\nMethods\n-------\n\n### instance\n\n instance(instance_id, display_name=None, instance_type=None, labels=None)\n\nFactory to create a instance associated with this client.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_create_prod_instance\\]\n:end-before: \\[END bigtable_api_create_prod_instance\\]\n:dedent: 4\n\n### list_clusters\n\n list_clusters()\n\nList the clusters in the project.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_list_clusters_in_project\\]\n:end-before: \\[END bigtable_api_list_clusters_in_project\\]\n:dedent: 4\n\n### list_instances\n\n list_instances()\n\nList instances owned by the project.\n\nFor example:\n\n.. literalinclude:: snippets.py\n:start-after: \\[START bigtable_api_list_instances\\]\n:end-before: \\[END bigtable_api_list_instances\\]\n:dedent: 4"]]