Modifying a Cloud Bigtable Instance

After you create a Cloud Bigtable instance, you can update the instance's name and the number of Cloud Bigtable nodes for the cluster that the instance contains. For example, you may want to add nodes to your cluster for a few hours to handle a large load, then reduce the number of nodes again.

There is no downtime when you make changes to your instance and cluster. If you change the number of nodes in your cluster, it typically takes a few minutes under load for Cloud Bigtable to balance performance across all of the nodes.

You cannot update the instance ID, the cluster ID, or the zone in which the cluster is located. To change these values, you must create a new instance with a new ID or zone, copy your data from the old instance into the new one, and then delete the old instance.

Console

To modify a Cloud Bigtable instance:

  1. List instances in your project.
  2. Click the name of the instance you want to modify.
  3. Click EDIT. The Edit instance page appears.
  4. Change the instance's settings as needed, then click Save to save your changes.

gcloud

To show information about existing Cloud Bigtable instances:

  1. Install the Cloud SDK if you haven't already.
  2. Use the beta bigtable instances list command to list existing clusters:

    gcloud beta bigtable instances list
    

To modify a Cloud Bigtable instance:

  1. Install the Cloud SDK if you haven't already.
  2. Use the beta bigtable instances update command to modify an instance:

    gcloud beta bigtable instances update INSTANCE --description DESCRIPTION
    

    Where:

    • INSTANCE: Is the permanent identifier for your instance.
    • DESCRIPTION: Is a new human-readable name that identifies your instance in the Cloud Platform Console.

To modify a Cloud Bigtable cluster:

  1. Install the Cloud SDK if you haven't already.
  2. Use the beta bigtable clusters update command to modify a cluster:

    gcloud beta bigtable clusters update CLUSTER --instance INSTANCE \
        --num-nodes NUM_NODES [--async]
    

    Where:

    • CLUSTER: Is the permanent identifier for your cluster.
    • INSTANCE: Is the permanent identifier for your instance.
    • NUM_NODES: Is the number of nodes to provide in your cluster.

    The command accepts the following optional flag:

    • --async: Return immediately without waiting for the operation to finish.

Send feedback about...

Cloud Bigtable Documentation