Class Instance (5.1.2)

Create an Instance object to interact with a Cloud Bigtable instance.

Package

@google-cloud/bigtable

Example


const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');

Constructors

(constructor)(bigtable, id)

constructor(bigtable: Bigtable, id: string);

Constructs a new instance of the Instance class

Parameters
Name Description
bigtable Bigtable
id string

Properties

bigtable

bigtable: Bigtable;

id

id: string;

metadata

metadata?: google.bigtable.admin.v2.IInstance;

name

name: string;

Methods

appProfile(name)

appProfile(name: string): AppProfile;

Get a reference to a Bigtable App Profile.

Parameter
Name Description
name string

The name of the app profile.

Returns
Type Description
AppProfile

{AppProfile}

cluster(id)

cluster(id: string): Cluster;

Get a reference to a Bigtable Cluster.

Parameter
Name Description
id string

The id of the cluster.

Returns
Type Description
Cluster

{Cluster}

create(options)

create(options: InstanceOptions): Promise<CreateInstanceResponse>;
Parameter
Name Description
options InstanceOptions
Returns
Type Description
Promise<CreateInstanceResponse>

create(options, callback)

create(options: InstanceOptions, callback: CreateInstanceCallback): void;
Parameters
Name Description
options InstanceOptions
callback CreateInstanceCallback
Returns
Type Description
void

createAppProfile(id, options)

createAppProfile(id: string, options?: AppProfileOptions): Promise<CreateAppProfileResponse>;
Parameters
Name Description
id string
options AppProfileOptions
Returns
Type Description
Promise<CreateAppProfileResponse>

createAppProfile(id, options, callback)

createAppProfile(id: string, options: AppProfileOptions, callback: CreateAppProfileCallback): void;
Parameters
Name Description
id string
options AppProfileOptions
callback CreateAppProfileCallback
Returns
Type Description
void

createAppProfile(id, callback)

createAppProfile(id: string, callback: CreateAppProfileCallback): void;
Parameters
Name Description
id string
callback CreateAppProfileCallback
Returns
Type Description
void

createCluster(id, options)

createCluster(id: string, options?: CreateClusterOptions): Promise<CreateClusterResponse>;
Parameters
Name Description
id string
options CreateClusterOptions
Returns
Type Description
Promise<CreateClusterResponse>

createCluster(id, options, callback)

createCluster(id: string, options: CreateClusterOptions, callback: CreateClusterCallback): void;
Parameters
Name Description
id string
options CreateClusterOptions
callback CreateClusterCallback
Returns
Type Description
void

createCluster(id, callback)

createCluster(id: string, callback: CreateClusterCallback): void;
Parameters
Name Description
id string
callback CreateClusterCallback
Returns
Type Description
void

createTable(id, options)

createTable(id: string, options?: CreateTableOptions): Promise<CreateTableResponse>;
Parameters
Name Description
id string
options CreateTableOptions
Returns
Type Description
Promise<CreateTableResponse>

createTable(id, options, callback)

createTable(id: string, options: CreateTableOptions, callback: CreateTableCallback): void;
Parameters
Name Description
id string
options CreateTableOptions
callback CreateTableCallback
Returns
Type Description
void

createTable(id, callback)

createTable(id: string, callback: CreateTableCallback): void;
Parameters
Name Description
id string
callback CreateTableCallback
Returns
Type Description
void

createTableFromBackup(config)

createTableFromBackup(config: CreateTableFromBackupConfig): Promise<RestoreTableResponse>;
Parameter
Name Description
config CreateTableFromBackupConfig
Returns
Type Description
Promise<RestoreTableResponse>

createTableFromBackup(config, callback)

createTableFromBackup(config: CreateTableFromBackupConfig, callback: RestoreTableCallback): void;
Parameters
Name Description
config CreateTableFromBackupConfig
callback RestoreTableCallback
Returns
Type Description
void

delete(gaxOptions)

delete(gaxOptions?: CallOptions): Promise<DeleteInstanceResponse>;
Parameter
Name Description
gaxOptions CallOptions
Returns
Type Description
Promise<DeleteInstanceResponse>

delete(gaxOptions, callback)

delete(gaxOptions: CallOptions, callback: DeleteInstanceCallback): void;
Parameters
Name Description
gaxOptions CallOptions
callback DeleteInstanceCallback
Returns
Type Description
void

delete(callback)

delete(callback: DeleteInstanceCallback): void;
Parameter
Name Description
callback DeleteInstanceCallback
Returns
Type Description
void

exists(options)

exists(options?: CallOptions): Promise<InstanceExistsResponse>;
Parameter
Name Description
options CallOptions
Returns
Type Description
Promise<InstanceExistsResponse>

exists(options, callback)

exists(options: CallOptions, callback: InstanceExistsCallback): void;
Parameters
Name Description
options CallOptions
callback InstanceExistsCallback
Returns
Type Description
void

exists(callback)

exists(callback: InstanceExistsCallback): void;
Parameter
Name Description
callback InstanceExistsCallback
Returns
Type Description
void

get(gaxOptions)

get(gaxOptions?: CallOptions): Promise<GetInstanceResponse>;
Parameter
Name Description
gaxOptions CallOptions
Returns
Type Description
Promise<GetInstanceResponse>

get(gaxOptions, callback)

get(gaxOptions: CallOptions, callback: GetInstanceCallback): void;
Parameters
Name Description
gaxOptions CallOptions
callback GetInstanceCallback
Returns
Type Description
void

get(callback)

get(callback: GetInstanceCallback): void;
Parameter
Name Description
callback GetInstanceCallback
Returns
Type Description
void

getAppProfiles(options)

getAppProfiles(options?: CallOptions): Promise<GetAppProfilesResponse>;
Parameter
Name Description
options CallOptions
Returns
Type Description
Promise<GetAppProfilesResponse>

getAppProfiles(options, callback)

getAppProfiles(options: CallOptions, callback: GetAppProfilesCallback): void;
Parameters
Name Description
options CallOptions
callback GetAppProfilesCallback
Returns
Type Description
void

getAppProfiles(callback)

getAppProfiles(callback: GetAppProfilesCallback): void;
Parameter
Name Description
callback GetAppProfilesCallback
Returns
Type Description
void

getAppProfilesStream(gaxOptions)

getAppProfilesStream(gaxOptions?: CallOptions): NodeJS.ReadableStream;

Get AppProfile objects for all the App Profiles in your Cloud Bigtable instance as a readable object stream.

Parameter
Name Description
gaxOptions CallOptions

Request configuration options, outlined here: https://googleapis.github.io/gax-nodejs/CallSettings.html. for a complete list of options.

Returns
Type Description
NodeJS.ReadableStream

{stream}

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');

instance.getAppProfilesStream()
  .on('error', console.error)
  .on('data', function(appProfile) {
    // appProfile is a AppProfile object.
  })
  .on('end', () => {
    // All appProfiles retrieved.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing and API requests.
//-
instance.getAppProfilesStream()
  .on('data', function(appProfile) {
    this.end();
  });

getBackups(options)

getBackups(options?: GetBackupsOptions): Promise<GetBackupsResponse>;
Parameter
Name Description
options GetBackupsOptions
Returns
Type Description
Promise<GetBackupsResponse>

getBackups(options, callback)

getBackups(options: GetBackupsOptions, callback: GetBackupsCallback): void;
Parameters
Name Description
options GetBackupsOptions
callback GetBackupsCallback
Returns
Type Description
void

getBackups(callback)

getBackups(callback: GetBackupsCallback): void;
Parameter
Name Description
callback GetBackupsCallback
Returns
Type Description
void

getBackupsStream(options)

getBackupsStream(options?: GetBackupsOptions): NodeJS.ReadableStream;

Get Cloud Bigtable Backup instances within this instance. This returns both completed and pending backups as a readable stream.

Parameter
Name Description
options GetBackupsOptions

Configuration object. See for a complete list of options.

Returns
Type Description
NodeJS.ReadableStream

{ReadableStream

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');

instance.getBackupsStream()
  .on('error', console.error)
  .on('data', function(backup) {
    // backup is a Backup object.
  })
  .on('end', () => {
    // All backups retrieved.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing and API requests.
//-
instance.getBackupsStream()
  .on('data', function(backup) {
    this.end();
  });

getClusters(options)

getClusters(options?: CallOptions): Promise<GetClustersResponse>;
Parameter
Name Description
options CallOptions
Returns
Type Description
Promise<GetClustersResponse>

getClusters(options, callback)

getClusters(options: CallOptions, callback: GetClustersCallback): void;
Parameters
Name Description
options CallOptions
callback GetClustersCallback
Returns
Type Description
void

getClusters(callback)

getClusters(callback: GetClustersCallback): void;
Parameter
Name Description
callback GetClustersCallback
Returns
Type Description
void

getIamPolicy(options)

getIamPolicy(options?: GetIamPolicyOptions): Promise<[Policy]>;
Parameter
Name Description
options GetIamPolicyOptions
Returns
Type Description
Promise<[Policy]>

getIamPolicy(options, callback)

getIamPolicy(options: GetIamPolicyOptions, callback: GetIamPolicyCallback): void;
Parameters
Name Description
options GetIamPolicyOptions
callback GetIamPolicyCallback
Returns
Type Description
void

getMetadata(options)

getMetadata(options?: CallOptions): Promise<GetInstanceMetadataResponse>;
Parameter
Name Description
options CallOptions
Returns
Type Description
Promise<GetInstanceMetadataResponse>

getMetadata(options, callback)

getMetadata(options: CallOptions, callback: GetInstanceMetadataCallback): void;
Parameters
Name Description
options CallOptions
callback GetInstanceMetadataCallback
Returns
Type Description
void

getMetadata(callback)

getMetadata(callback: GetInstanceMetadataCallback): void;
Parameter
Name Description
callback GetInstanceMetadataCallback
Returns
Type Description
void

getTables(options)

getTables(options?: GetTablesOptions): Promise<GetTablesResponse>;
Parameter
Name Description
options GetTablesOptions
Returns
Type Description
Promise<GetTablesResponse>

getTables(options, callback)

getTables(options: GetTablesOptions, callback: GetTablesCallback): void;
Parameters
Name Description
options GetTablesOptions
callback GetTablesCallback
Returns
Type Description
void

getTables(callback)

getTables(callback: GetTablesCallback): void;
Parameter
Name Description
callback GetTablesCallback
Returns
Type Description
void

getTablesStream(options)

getTablesStream(options?: GetTablesOptions): NodeJS.ReadableStream;

Get Table objects for all the tables in your Cloud Bigtable instance as a readable object stream.

Parameter
Name Description
options GetTablesOptions

Query object. See for a complete list of options.

Returns
Type Description
NodeJS.ReadableStream

{stream}

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');

instance.getTablesStream()
  .on('error', console.error)
  .on('data', function(table) {
    // table is a Table object.
  })
  .on('end', () => {
    // All tables retrieved.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing and API requests.
//-
instance.getTablesStream()
  .on('data', function(table) {
    this.end();
  });

getTypeType_(type)

static getTypeType_(type?: string): number;

Maps the instance type to the proper integer.

Parameter
Name Description
type string

The instance type (production, development).

Returns
Type Description
number

{number}

Example

Instance.getTypeType_('production');
// 1

setIamPolicy(policy, gaxOptions)

setIamPolicy(policy: Policy, gaxOptions?: CallOptions): Promise<SetIamPolicyResponse>;
Parameters
Name Description
policy Policy
gaxOptions CallOptions
Returns
Type Description
Promise<SetIamPolicyResponse>

setIamPolicy(policy, gaxOptions, callback)

setIamPolicy(policy: Policy, gaxOptions: CallOptions, callback: SetIamPolicyCallback): void;
Parameters
Name Description
policy Policy
gaxOptions CallOptions
callback SetIamPolicyCallback
Returns
Type Description
void

setIamPolicy(policy, callback)

setIamPolicy(policy: Policy, callback: SetIamPolicyCallback): void;
Parameters
Name Description
policy Policy
callback SetIamPolicyCallback
Returns
Type Description
void

setMetadata(metadata, options)

setMetadata(metadata: IInstance, options?: CallOptions): Promise<SetInstanceMetadataResponse>;
Parameters
Name Description
metadata IInstance
options CallOptions
Returns
Type Description
Promise<SetInstanceMetadataResponse>

setMetadata(metadata, options, callback)

setMetadata(metadata: IInstance, options: CallOptions, callback: SetInstanceMetadataCallback): void;
Parameters
Name Description
metadata IInstance
options CallOptions
callback SetInstanceMetadataCallback
Returns
Type Description
void

setMetadata(metadata, callback)

setMetadata(metadata: IInstance, callback: SetInstanceMetadataCallback): void;
Parameters
Name Description
metadata IInstance
callback SetInstanceMetadataCallback
Returns
Type Description
void

table(id)

table(id: string): Table;

Get a reference to a Bigtable table.

Parameter
Name Description
id string

Unique identifier of the table.

Returns
Type Description
Table

{Table}

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');
const table = instance.table('presidents');

testIamPermissions(permissions, gaxOptions)

testIamPermissions(permissions: string | string[], gaxOptions?: CallOptions): Promise<TestIamPermissionsResponse>;
Parameters
Name Description
permissions string | string[]
gaxOptions CallOptions
Returns
Type Description
Promise<TestIamPermissionsResponse>

testIamPermissions(permissions, callback)

testIamPermissions(permissions: string | string[], callback: TestIamPermissionsCallback): void;
Parameters
Name Description
permissions string | string[]
callback TestIamPermissionsCallback
Returns
Type Description
void

testIamPermissions(permissions, gaxOptions, callback)

testIamPermissions(permissions: string | string[], gaxOptions: CallOptions, callback: TestIamPermissionsCallback): void;
Parameters
Name Description
permissions string | string[]
gaxOptions CallOptions
callback TestIamPermissionsCallback
Returns
Type Description
void