Create an Instance object to interact with a Cloud Bigtable instance.
Package
@google-cloud/bigtableExample
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
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.
name
string
The name of the app profile.
cluster(id)
cluster
(
id
:
string
)
:
Cluster
;
Get a reference to a Bigtable Cluster.
id
string
The id of the cluster.
create(options)
create
(
options
:
InstanceOptions
)
:
Promise<CreateInstanceResponse>
;
create(options, callback)
create
(
options
:
InstanceOptions
,
callback
:
CreateInstanceCallback
)
:
void
;
void
createAppProfile(id, options)
createAppProfile
(
id
:
string
,
options
?:
AppProfileOptions
)
:
Promise<CreateAppProfileResponse>
;
createAppProfile(id, options, callback)
createAppProfile
(
id
:
string
,
options
:
AppProfileOptions
,
callback
:
CreateAppProfileCallback
)
:
void
;
void
createAppProfile(id, callback)
createAppProfile
(
id
:
string
,
callback
:
CreateAppProfileCallback
)
:
void
;
void
createCluster(id, options)
createCluster
(
id
:
string
,
options
?:
CreateClusterOptions
)
:
Promise<CreateClusterResponse>
;
createCluster(id, options, callback)
createCluster
(
id
:
string
,
options
:
CreateClusterOptions
,
callback
:
CreateClusterCallback
)
:
void
;
void
createCluster(id, callback)
createCluster
(
id
:
string
,
callback
:
CreateClusterCallback
)
:
void
;
void
createTable(id, options)
createTable
(
id
:
string
,
options
?:
CreateTableOptions
)
:
Promise<CreateTableResponse>
;
createTable(id, options, callback)
createTable
(
id
:
string
,
options
:
CreateTableOptions
,
callback
:
CreateTableCallback
)
:
void
;
void
createTable(id, callback)
createTable
(
id
:
string
,
callback
:
CreateTableCallback
)
:
void
;
void
createTableFromBackup(config)
createTableFromBackup
(
config
:
CreateTableFromBackupConfig
)
:
Promise<RestoreTableResponse>
;
config
CreateTableFromBackupConfig
createTableFromBackup(config, callback)
createTableFromBackup
(
config
:
CreateTableFromBackupConfig
,
callback
:
RestoreTableCallback
)
:
void
;
void
delete(gaxOptions)
delete
(
gaxOptions
?:
CallOptions
)
:
Promise<DeleteInstanceResponse>
;
gaxOptions
CallOptions
delete(gaxOptions, callback)
delete
(
gaxOptions
:
CallOptions
,
callback
:
DeleteInstanceCallback
)
:
void
;
void
delete(callback)
delete
(
callback
:
DeleteInstanceCallback
)
:
void
;
void
exists(options)
exists
(
options
?:
CallOptions
)
:
Promise<InstanceExistsResponse>
;
options
CallOptions
exists(options, callback)
exists
(
options
:
CallOptions
,
callback
:
InstanceExistsCallback
)
:
void
;
void
exists(callback)
exists
(
callback
:
InstanceExistsCallback
)
:
void
;
void
get(gaxOptions)
get
(
gaxOptions
?:
CallOptions
)
:
Promise<GetInstanceResponse>
;
gaxOptions
CallOptions
get(gaxOptions, callback)
get
(
gaxOptions
:
CallOptions
,
callback
:
GetInstanceCallback
)
:
void
;
void
get(callback)
get
(
callback
:
GetInstanceCallback
)
:
void
;
void
getAppProfiles(options)
getAppProfiles
(
options
?:
CallOptions
)
:
Promise<GetAppProfilesResponse>
;
options
CallOptions
getAppProfiles(options, callback)
getAppProfiles
(
options
:
CallOptions
,
callback
:
GetAppProfilesCallback
)
:
void
;
void
getAppProfiles(callback)
getAppProfiles
(
callback
:
GetAppProfilesCallback
)
:
void
;
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.
gaxOptions
CallOptions
Request configuration options, outlined here: https://googleapis.github.io/gax-nodejs/CallSettings.html . for a complete list of options.
NodeJS.ReadableStream
{stream}
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
;
void
getBackups(callback)
getBackups
(
callback
:
GetBackupsCallback
)
:
void
;
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.
options
NodeJS.ReadableStream
{ReadableStream
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>
;
options
CallOptions
getClusters(options, callback)
getClusters
(
options
:
CallOptions
,
callback
:
GetClustersCallback
)
:
void
;
void
getClusters(callback)
getClusters
(
callback
:
GetClustersCallback
)
:
void
;
void
getIamPolicy(options)
getIamPolicy
(
options
?:
GetIamPolicyOptions
)
:
Promise
< [
Policy
]>;
getIamPolicy(options, callback)
getIamPolicy
(
options
:
GetIamPolicyOptions
,
callback
:
GetIamPolicyCallback
)
:
void
;
void
getMetadata(options)
getMetadata
(
options
?:
CallOptions
)
:
Promise<GetInstanceMetadataResponse>
;
options
CallOptions
getMetadata(options, callback)
getMetadata
(
options
:
CallOptions
,
callback
:
GetInstanceMetadataCallback
)
:
void
;
void
getMetadata(callback)
getMetadata
(
callback
:
GetInstanceMetadataCallback
)
:
void
;
void
getTables(options)
getTables
(
options
?:
GetTablesOptions
)
:
Promise<GetTablesResponse>
;
getTables(options, callback)
getTables
(
options
:
GetTablesOptions
,
callback
:
GetTablesCallback
)
:
void
;
void
getTables(callback)
getTables
(
callback
:
GetTablesCallback
)
:
void
;
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.
options
NodeJS.ReadableStream
{stream}
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.
type
string
The instance type (production, development).
number
{number}
Instance
.
getTypeType_
(
'production'
);
// 1
setIamPolicy(policy, gaxOptions)
setIamPolicy
(
policy
:
Policy
,
gaxOptions
?:
CallOptions
)
:
Promise<SetIamPolicyResponse>
;
setIamPolicy(policy, gaxOptions, callback)
setIamPolicy
(
policy
:
Policy
,
gaxOptions
:
CallOptions
,
callback
:
SetIamPolicyCallback
)
:
void
;
void
setIamPolicy(policy, callback)
setIamPolicy
(
policy
:
Policy
,
callback
:
SetIamPolicyCallback
)
:
void
;
void
setMetadata(metadata, options)
setMetadata
(
metadata
:
IInstance
,
options
?:
CallOptions
)
:
Promise<SetInstanceMetadataResponse>
;
setMetadata(metadata, options, callback)
setMetadata
(
metadata
:
IInstance
,
options
:
CallOptions
,
callback
:
SetInstanceMetadataCallback
)
:
void
;
metadata
options
CallOptions
callback
void
setMetadata(metadata, callback)
setMetadata
(
metadata
:
IInstance
,
callback
:
SetInstanceMetadataCallback
)
:
void
;
void
table(id)
table
(
id
:
string
)
:
Table
;
Get a reference to a Bigtable table.
id
string
Unique identifier of the table.
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>
;
permissions
string | string[]
gaxOptions
CallOptions
testIamPermissions(permissions, callback)
testIamPermissions
(
permissions
:
string
|
string
[],
callback
:
TestIamPermissionsCallback
)
:
void
;
void
testIamPermissions(permissions, gaxOptions, callback)
testIamPermissions
(
permissions
:
string
|
string
[],
gaxOptions
:
CallOptions
,
callback
:
TestIamPermissionsCallback
)
:
void
;
permissions
string | string[]
gaxOptions
CallOptions
callback
void
view(tableName, viewName)
view
(
tableName
:
string
,
viewName
:
string
)
:
AuthorizedView
;
Gets an Authorized View object for making authorized view grpc calls.
tableName
string
The name for the Table
viewName
string
The name for the Authorized view
AuthorizedView