Struct BigtableInstanceAdmin

Source

pub struct BigtableInstanceAdmin { /* private fields */ }

Expand description

Implements a client for the Cloud Bigtable Admin API.

§Example

let client = BigtableInstanceAdmin::builder().build().await?;
// use `client` to make requests to the Cloud Bigtable Admin API.

§Service Description

Service for creating, configuring, and deleting Cloud Bigtable Instances and Clusters. Provides access to the Instance and Cluster schemas only, not the tables’ metadata or data stored in those tables.

§Configuration

To configure BigtableInstanceAdmin use the with_* methods in the type returned by builder(). The default configuration should work for most applications. Common configuration changes include

with_endpoint(): by default this client uses the global default endpoint (https://bigtableadmin.googleapis.com). Applications using regional endpoints or running in restricted networks (e.g. a network configured override this default.
with_credentials(): by default this client uses Application Default Credentials. Applications using custom authentication may need to override this default.

§Pooling and Cloning

BigtableInstanceAdmin holds a connection pool internally, it is advised to create one and the reuse it. You do not need to wrap BigtableInstanceAdmin in an Rc or Arc to reuse it, because it already uses an Arc internally.

Implementations§

Source §

impl BigtableInstanceAdmin

Source

pub fn builder() -> ClientBuilder

Returns a builder for BigtableInstanceAdmin.

let client = BigtableInstanceAdmin::builder().build().await?;

Source

pub fn from_stub<T>(stub: T) -> Self
where T: BigtableInstanceAdmin + 'static,

Creates a new client from the provided stub.

The most common case for calling this function is in tests mocking the client’s behavior.

Source

pub fn create_instance(&self) -> CreateInstance

Create an instance within a project.

Note that exactly one of Cluster.serve_nodes and Cluster.cluster_config.cluster_autoscaling_config can be set. If serve_nodes is set to non-zero, then the cluster is manually scaled. If cluster_config.cluster_autoscaling_config is non-empty, then autoscaling is enabled.

§Long running operations

This method is used to start, and/or poll a long-running Operation. The Working with long-running operations chapter in the user guide covers these operations in detail.

Source

pub fn get_instance(&self) -> GetInstance

Gets information about an instance.

Source

pub fn list_instances(&self) -> ListInstances

Lists information about instances in a project.

Source

pub fn update_instance(&self) -> UpdateInstance

Updates an instance within a project. This method updates only the display name and type for an Instance. To update other Instance properties, such as labels, use PartialUpdateInstance.

Source

pub fn partial_update_instance(&self) -> PartialUpdateInstance

Partially updates an instance within a project. This method can modify all fields of an Instance and is the preferred way to update an Instance.

§Long running operations

This method is used to start, and/or poll a long-running Operation. The Working with long-running operations chapter in the user guide covers these operations in detail.

Source

pub fn delete_instance(&self) -> DeleteInstance

Delete an instance from a project.

Source

pub fn create_cluster(&self) -> CreateCluster

Creates a cluster within an instance.

Note that exactly one of Cluster.serve_nodes and Cluster.cluster_config.cluster_autoscaling_config can be set. If serve_nodes is set to non-zero, then the cluster is manually scaled. If cluster_config.cluster_autoscaling_config is non-empty, then autoscaling is enabled.

§Long running operations

This method is used to start, and/or poll a long-running Operation. The Working with long-running operations chapter in the user guide covers these operations in detail.

Source

pub fn get_cluster(&self) -> GetCluster

Gets information about a cluster.

Source

pub fn list_clusters(&self) -> ListClusters

Lists information about clusters in an instance.

Source

pub fn update_cluster(&self) -> UpdateCluster

Updates a cluster within an instance.

Note that UpdateCluster does not support updating cluster_config.cluster_autoscaling_config. In order to update it, you must use PartialUpdateCluster.

§Long running operations

This method is used to start, and/or poll a long-running Operation. The Working with long-running operations chapter in the user guide covers these operations in detail.

Source

pub fn partial_update_cluster(&self) -> PartialUpdateCluster

Partially updates a cluster within a project. This method is the preferred way to update a Cluster.

To enable and update autoscaling, set cluster_config.cluster_autoscaling_config. When autoscaling is enabled, serve_nodes is treated as an OUTPUT_ONLY field, meaning that updates to it are ignored. Note that an update cannot simultaneously set serve_nodes to non-zero and cluster_config.cluster_autoscaling_config to non-empty, and also specify both in the update_mask.

To disable autoscaling, clear cluster_config.cluster_autoscaling_config, and explicitly set a serve_node count via the update_mask.