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
id
metadata?: google.bigtable.admin.v2.IInstance;
name
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.
|
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>;
create(options, callback)
create(options: InstanceOptions, callback: CreateInstanceCallback): void;
Returns |
---|
Type | Description |
void | |
createAppProfile(id, options)
createAppProfile(id: string, options?: AppProfileOptions): Promise<CreateAppProfileResponse>;
createAppProfile(id, options, callback)
createAppProfile(id: string, options: AppProfileOptions, callback: CreateAppProfileCallback): void;
Returns |
---|
Type | Description |
void | |
createAppProfile(id, callback)
createAppProfile(id: string, callback: CreateAppProfileCallback): void;
Returns |
---|
Type | Description |
void | |
createCluster(id, options)
createCluster(id: string, options?: CreateClusterOptions): Promise<CreateClusterResponse>;
createCluster(id, options, callback)
createCluster(id: string, options: CreateClusterOptions, callback: CreateClusterCallback): void;
Returns |
---|
Type | Description |
void | |
createCluster(id, callback)
createCluster(id: string, callback: CreateClusterCallback): void;
Returns |
---|
Type | Description |
void | |
createTable(id, options)
createTable(id: string, options?: CreateTableOptions): Promise<CreateTableResponse>;
createTable(id, options, callback)
createTable(id: string, options: CreateTableOptions, callback: CreateTableCallback): void;
Returns |
---|
Type | Description |
void | |
createTable(id, callback)
createTable(id: string, callback: CreateTableCallback): void;
Returns |
---|
Type | Description |
void | |
createTableFromBackup(config)
createTableFromBackup(config: CreateTableFromBackupConfig): Promise<RestoreTableResponse>;
Parameter |
---|
Name | Description |
config |
CreateTableFromBackupConfig
|
createTableFromBackup(config, callback)
createTableFromBackup(config: CreateTableFromBackupConfig, callback: RestoreTableCallback): void;
Returns |
---|
Type | Description |
void | |
delete(gaxOptions)
delete(gaxOptions?: CallOptions): Promise<DeleteInstanceResponse>;
Parameter |
---|
Name | Description |
gaxOptions |
CallOptions
|
delete(gaxOptions, callback)
delete(gaxOptions: CallOptions, callback: DeleteInstanceCallback): void;
Returns |
---|
Type | Description |
void | |
delete(callback)
delete(callback: DeleteInstanceCallback): void;
Returns |
---|
Type | Description |
void | |
exists(options)
exists(options?: CallOptions): Promise<InstanceExistsResponse>;
Parameter |
---|
Name | Description |
options |
CallOptions
|
exists(options, callback)
exists(options: CallOptions, callback: InstanceExistsCallback): void;
Returns |
---|
Type | Description |
void | |
exists(callback)
exists(callback: InstanceExistsCallback): void;
Returns |
---|
Type | Description |
void | |
get(gaxOptions)
get(gaxOptions?: CallOptions): Promise<GetInstanceResponse>;
Parameter |
---|
Name | Description |
gaxOptions |
CallOptions
|
get(gaxOptions, callback)
get(gaxOptions: CallOptions, callback: GetInstanceCallback): void;
Returns |
---|
Type | Description |
void | |
get(callback)
get(callback: GetInstanceCallback): void;
Returns |
---|
Type | Description |
void | |
getAppProfiles(options)
getAppProfiles(options?: CallOptions): Promise<GetAppProfilesResponse>;
Parameter |
---|
Name | Description |
options |
CallOptions
|
getAppProfiles(options, callback)
getAppProfiles(options: CallOptions, callback: GetAppProfilesCallback): void;
Returns |
---|
Type | Description |
void | |
getAppProfiles(callback)
getAppProfiles(callback: GetAppProfilesCallback): void;
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.
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>;
getBackups(options, callback)
getBackups(options: GetBackupsOptions, callback: GetBackupsCallback): void;
Returns |
---|
Type | Description |
void | |
getBackups(callback)
getBackups(callback: GetBackupsCallback): void;
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
|
getClusters(options, callback)
getClusters(options: CallOptions, callback: GetClustersCallback): void;
Returns |
---|
Type | Description |
void | |
getClusters(callback)
getClusters(callback: GetClustersCallback): void;
Returns |
---|
Type | Description |
void | |
getIamPolicy(options)
getIamPolicy(options?: GetIamPolicyOptions): Promise<[Policy]>;
Returns |
---|
Type | Description |
Promise<[Policy]> | |
getIamPolicy(options, callback)
getIamPolicy(options: GetIamPolicyOptions, callback: GetIamPolicyCallback): void;
Returns |
---|
Type | Description |
void | |
getMetadata(options?: CallOptions): Promise<GetInstanceMetadataResponse>;
Parameter |
---|
Name | Description |
options |
CallOptions
|
getMetadata(options: CallOptions, callback: GetInstanceMetadataCallback): void;
Returns |
---|
Type | Description |
void | |
getMetadata(callback: GetInstanceMetadataCallback): void;
Returns |
---|
Type | Description |
void | |
getTables(options)
getTables(options?: GetTablesOptions): Promise<GetTablesResponse>;
getTables(options, callback)
getTables(options: GetTablesOptions, callback: GetTablesCallback): void;
Returns |
---|
Type | Description |
void | |
getTables(callback)
getTables(callback: GetTablesCallback): void;
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
|
setIamPolicy(policy, gaxOptions, callback)
setIamPolicy(policy: Policy, gaxOptions: CallOptions, callback: SetIamPolicyCallback): void;
Returns |
---|
Type | Description |
void | |
setIamPolicy(policy, callback)
setIamPolicy(policy: Policy, callback: SetIamPolicyCallback): void;
Returns |
---|
Type | Description |
void | |
setMetadata(metadata: IInstance, options?: CallOptions): Promise<SetInstanceMetadataResponse>;
Parameters |
---|
Name | Description |
metadata |
IInstance
|
options |
CallOptions
|
setMetadata(metadata: IInstance, options: CallOptions, callback: SetInstanceMetadataCallback): void;
Returns |
---|
Type | Description |
void | |
setMetadata(metadata: IInstance, callback: SetInstanceMetadataCallback): void;
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
|
testIamPermissions(permissions, callback)
testIamPermissions(permissions: string | string[], callback: TestIamPermissionsCallback): void;
Returns |
---|
Type | Description |
void | |
testIamPermissions(permissions, gaxOptions, callback)
testIamPermissions(permissions: string | string[], gaxOptions: CallOptions, callback: TestIamPermissionsCallback): void;
Returns |
---|
Type | Description |
void | |