Collection: projects.instances.clusters

Resource: Cluster

A resizable group of nodes in a particular cloud location, capable of serving all Tables in the parent Instance.

JSON representation
{
  "name": string,
  "location": string,
  "state": enum(State),
  "serveNodes": number,
  "defaultStorageType": enum(StorageType),
}
Fields
name

string

(OutputOnly) The unique name of the cluster. Values are of the form projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*.

location

string

(CreationOnly) The location where this cluster's nodes and storage reside. For best performance, clients should be located as close as possible to this cluster. Currently only zones are supported, so values should be of the form projects/<project>/locations/<zone>.

state

enum(State)

(OutputOnly) The current state of the cluster.

serveNodes

number

The number of nodes allocated to this cluster. More nodes enable higher throughput and more consistent performance.

defaultStorageType

enum(StorageType)

(CreationOnly) The type of storage used by this cluster to serve its parent instance's tables, unless explicitly overridden.

State

Possible states of a cluster.

Enums
STATE_NOT_KNOWN The state of the cluster could not be determined.
READY The cluster has been successfully created and is ready to serve requests.
CREATING The cluster is currently being created, and may be destroyed if the creation process encounters an error. A cluster may not be able to serve requests while being created.
RESIZING The cluster is currently being resized, and may revert to its previous node count if the process encounters an error. A cluster is still capable of serving requests while being resized, but may exhibit performance as if its number of allocated nodes is between the starting and requested states.
DISABLED The cluster has no backing nodes. The data (tables) still exist, but no operations can be performed on the cluster.

StorageType

Storage media types for persisting Bigtable data.

Enums
STORAGE_TYPE_UNSPECIFIED The user did not specify a storage type.
SSD Flash (SSD) storage should be used.
HDD Magnetic drive (HDD) storage should be used.

Methods

create

Creates a cluster within an instance.

delete

Deletes a cluster from an instance.

get

Gets information about a cluster.

list

Lists information about clusters in an instance.

update

Updates a cluster within an instance.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Bigtable Documentation