For Agents
Provision and manage Cloud Bigtable instances, clusters, tables, app profiles, and backups. Agents can create tables, modify column families, and manage authorized views.
Get started with Cloud Bigtable Admin API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create a Bigtable table"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Cloud Bigtable Admin API API.
Create and resize Bigtable instances and their clusters across regions
Manage tables including modifying column families and dropping row ranges
Define authorized views that scope readers to a subset of rows and columns
Create app profiles to route traffic between clusters with single- or multi-cluster routing
GET STARTED
Use for: I need to create a new Bigtable instance with two clusters, Create a new table inside an existing Bigtable instance, Modify the column families on an existing Bigtable table, List all clusters in a Bigtable instance
Not supported: Does not read or write Bigtable rows, run analytics queries, or manage GCE infrastructure — use for Bigtable instance, cluster, table, and backup administration only.
The Cloud Bigtable Admin API manages Bigtable instances, clusters, app profiles, tables, authorized views, column families, and backups. It is the control plane for Bigtable — used to provision and resize clusters, create tables and column families, define app profiles for routing, and back up and restore data — while the data plane API handles reads and writes. Operators use it to script cluster scaling, capacity changes, and DR. It also exposes IAM policy management on instances, tables, and authorized views.
Back up tables and restore them into the same or a different instance
Manage IAM policies on instances, tables, and authorized views
Check table consistency with consistency tokens for replicated workloads
Patterns agents use Cloud Bigtable Admin API API for, with concrete tasks.
★ Provision a Replicated Cluster
Provision a Bigtable instance with two clusters in different regions for HA and multi-region reads. Instances are created at /v2/{parent}/instances and clusters at /v2/{parent}/clusters with the desired serveNodes and storageType. Combined with multi-cluster app profiles, this gives applications transparent failover.
Create instance prod with two clusters: prod-c1 in us-central1 with 5 SSD nodes and prod-c2 in us-east1 with 5 SSD nodes.
Schema and Table Lifecycle
Create tables, define column families, and evolve schemas with modifyColumnFamilies. Tables are managed at /v2/{parent}/tables and column families via /v2/{name}:modifyColumnFamilies. dropRowRange supports targeted cleanup of obsolete prefixes without rewriting the table.
Create table events in instance prod with a column family cf_metrics that has a maxAge of 30 days.
Backup and Restore
Schedule and trigger table backups with /v2/{parent}/backups and restore them into the same or a different instance. Backups are anchored to a cluster and can be retained for up to 90 days. Used for DR runbooks and accidental-delete recovery.
Create a backup of table events in cluster prod-c1 with expireTime 30 days from now, then restore it into instance staging as table events_restored.
Authorized View Access
Create authorized views over a table to expose a row-key prefix and a subset of columns to specific principals, then bind IAM roles to the view. Authorized views are managed at /v2/{parent}/authorizedViews. This avoids granting full table access for narrow read use cases.
Create authorizedView region_us on table events that exposes only rows with prefix US# and columns from family cf_public, then grant roles/bigtable.user to data-readers@example.com on the view.
Agent-Driven Cluster Ops
Let an AI agent take a request like 'add 5 nodes to prod-c1 for the holiday window' and update the cluster through Jentic. The agent loads PATCH /v2/{name} with the new serveNodes value, watches the operation, and reports back when the cluster has scaled. OAuth credentials never leave the Jentic vault.
Scale cluster projects/myproj/instances/prod/clusters/prod-c1 to 10 serveNodes and wait for the long-running operation to complete.
29 endpoints — the cloud bigtable admin api manages bigtable instances, clusters, app profiles, tables, authorized views, column families, and backups.
METHOD
PATH
DESCRIPTION
/v2/{+parent}/instances
Create a Bigtable instance
/v2/{+parent}/clusters
Create a cluster in an instance
/v2/{+parent}/tables
Create a table in an instance
/v2/{+name}:modifyColumnFamilies
Modify column families on a table
/v2/{+name}:dropRowRange
Drop a row range from a table
/v2/{+parent}/backups
Create a backup of a table
/v2/{+parent}/authorizedViews
Create an authorized view on a table
/v2/{+parent}/appProfiles
Create an app profile for cluster routing
/v2/{+parent}/instances
Create a Bigtable instance
/v2/{+parent}/clusters
Create a cluster in an instance
/v2/{+parent}/tables
Create a table in an instance
/v2/{+name}:modifyColumnFamilies
Modify column families on a table
/v2/{+name}:dropRowRange
Drop a row range from a table
Three things that make agents converge on Jentic-routed access.
Credential isolation
Google OAuth 2.0 client credentials and refresh tokens are stored encrypted in the Jentic vault (MAXsystem). The agent only receives short-lived, scope-limited access tokens at execution time.
Intent-based discovery
Agents search Jentic with intents like 'create a Bigtable cluster' or 'back up a Bigtable table' and Jentic returns the right Admin API operation with its full input schema.
Time to first call
Direct integration: 2-3 days for OAuth, the operation polling pattern, and the instance/cluster/table model. Through Jentic: under an hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Cloud Datastore API
Document-style NoSQL database for transactional app data.
Choose Datastore for entity-style transactional data; choose Bigtable for wide-row, high-throughput timeseries or analytics workloads.
Cloud Spanner API
Globally consistent relational database service.
Choose Spanner when SQL and strong global consistency matter; choose Bigtable for low-latency wide-column workloads.
BigQuery API
Analytical warehouse that often consumes Bigtable export or live federation.
Use BigQuery for analytics over Bigtable exports; use Bigtable Admin to manage the underlying tables and clusters.
Specific to using Cloud Bigtable Admin API API through Jentic.
What authentication does the Cloud Bigtable Admin API use?
The Bigtable Admin API uses Google OAuth 2.0 with the cloud-platform and bigtable.admin scopes. Through Jentic, the OAuth refresh token sits encrypted in the vault and the agent receives short-lived scoped access tokens at call time.
Can I create and resize a Bigtable cluster with this API?
Yes. POST /v2/{parent}/clusters creates a new cluster, and PATCH /v2/{name} with serveNodes updates the node count of an existing cluster. Both return long-running operations under /v2/{name}/operations that you poll until done.
What are the rate limits for the Cloud Bigtable Admin API?
Quotas are project-level: typically a small write QPS on the same instance/table and bursty read QPS for list and get operations. Heavy admin churn (rapid create/delete loops) is rate-limited per instance. Check the Google Cloud quotas console for current values.
How do I back up a Bigtable table through Jentic?
Search Jentic for 'create a Bigtable backup', load the schema for POST /v2/{parent}/backups, and execute with sourceTable and expireTime. Jentic forwards the OAuth token; the response is a long-running operation you can poll via /v2/{name}/operations.
Does this API read or write rows?
No. The Admin API only manages instances, clusters, tables, and views. Use the Bigtable data API (bigtable.googleapis.com) to read and write rows in a table.
Can I expose only some rows of a table to a specific service account?
Yes. Create an authorizedView via POST /v2/{parent}/authorizedViews that defines a row-key prefix and column subset, then setIamPolicy on the view to grant roles/bigtable.user to the target principal. The principal can read only what the view exposes.
/v2/{+parent}/backups
Create a backup of a table
/v2/{+parent}/authorizedViews
Create an authorized view on a table
/v2/{+parent}/appProfiles
Create an app profile for cluster routing