Service for creating, configuring, and deleting Cloud Bigtable tables.
Provides access to the table schemas only, not the data stored within the tables.
Equality
Instances of this class created via copy-construction or copy-assignment always compare equal. Instances created with equal std::shared_ptr<*Connection>
objects compare equal. Objects that compare equal share the same underlying resources.
Performance
Creating a new instance of this class is a relatively expensive operation, new objects establish new connections to the service. In contrast, copy-construction, move-construction, and the corresponding assignment operations are relatively efficient as the copies share all underlying resources.
Thread Safety
Concurrent access to different instances of this class, even if they compare equal, is guaranteed to work. Two or more threads operating on the same instance of this class is not guaranteed to work. Since copy-construction and move-construction is a relatively efficient operation, consider using such a copy when using this class from multiple threads.
Constructors
BigtableTableAdminClient(BigtableTableAdminClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BigtableTableAdminClient const &
|
BigtableTableAdminClient(BigtableTableAdminClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BigtableTableAdminClient &&
|
BigtableTableAdminClient(std::shared_ptr< BigtableTableAdminConnection >, Options)
Parameters | |
---|---|
Name | Description |
connection |
std::shared_ptr< BigtableTableAdminConnection >
|
opts |
Options
|
Operators
operator=(BigtableTableAdminClient const &)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BigtableTableAdminClient const &
|
Returns | |
---|---|
Type | Description |
BigtableTableAdminClient & |
operator=(BigtableTableAdminClient &&)
Copy and move support
Parameter | |
---|---|
Name | Description |
|
BigtableTableAdminClient &&
|
Returns | |
---|---|
Type | Description |
BigtableTableAdminClient & |
Functions
CreateTable(std::string const &, std::string const &, google::bigtable::admin::v2::Table const &, Options)
Creates a new table in the specified instance.
The table can be created with a full set of initial column families, specified in the request.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The unique name of the instance in which to create the table. Values are of the form |
table_id |
std::string const &
Required. The name by which the new table should be referred to within the parent instance, e.g., |
table |
google::bigtable::admin::v2::Table const &
Required. The Table to create. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateTable(google::bigtable::admin::v2::CreateTableRequest const &, Options)
Creates a new table in the specified instance.
The table can be created with a full set of initial column families, specified in the request.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CreateTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ListTables(std::string const &, Options)
Lists all tables served from a specified instance.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The unique name of the instance for which tables should be listed. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::Table > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListTables(google::bigtable::admin::v2::ListTablesRequest, Options)
Lists all tables served from a specified instance.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::ListTablesRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::Table > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetTable(std::string const &, Options)
Gets metadata information about the specified table.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the requested table. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetTable(google::bigtable::admin::v2::GetTableRequest const &, Options)
Gets metadata information about the specified table.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::GetTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateTable(google::bigtable::admin::v2::Table const &, google::protobuf::FieldMask const &, Options)
Updates a specified table.
Parameters | |
---|---|
Name | Description |
table |
google::bigtable::admin::v2::Table const &
Required. The table to update. The table's |
update_mask |
google::protobuf::FieldMask const &
Required. The list of fields to update. A mask specifying which fields (e.g.
|
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
A |
UpdateTable(NoAwaitTag, google::bigtable::admin::v2::Table const &, google::protobuf::FieldMask const &, Options)
Updates a specified table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
table |
google::bigtable::admin::v2::Table const &
|
update_mask |
google::protobuf::FieldMask const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateTable(google::bigtable::admin::v2::UpdateTableRequest const &, Options)
Updates a specified table.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::UpdateTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
A |
UpdateTable(NoAwaitTag, google::bigtable::admin::v2::UpdateTableRequest const &, Options)
Updates a specified table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::UpdateTableRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateTable(google::longrunning::Operation const &, Options)
Updates a specified table.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
DeleteTable(std::string const &, Options)
Permanently deletes a specified table and all of its data.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the table to be deleted. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
DeleteTable(google::bigtable::admin::v2::DeleteTableRequest const &, Options)
Permanently deletes a specified table and all of its data.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::DeleteTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
UndeleteTable(std::string const &, Options)
Restores a specified table which was accidentally deleted.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the table to be restored. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
A |
UndeleteTable(NoAwaitTag, std::string const &, Options)
Restores a specified table which was accidentally deleted.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
name |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UndeleteTable(google::bigtable::admin::v2::UndeleteTableRequest const &, Options)
Restores a specified table which was accidentally deleted.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::UndeleteTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
A |
UndeleteTable(NoAwaitTag, google::bigtable::admin::v2::UndeleteTableRequest const &, Options)
Restores a specified table which was accidentally deleted.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::UndeleteTableRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UndeleteTable(google::longrunning::Operation const &, Options)
Restores a specified table which was accidentally deleted.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
CreateAuthorizedView(std::string const &, google::bigtable::admin::v2::AuthorizedView const &, std::string const &, Options)
Creates a new AuthorizedView in a table.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. This is the name of the table the AuthorizedView belongs to. Values are of the form |
authorized_view |
google::bigtable::admin::v2::AuthorizedView const &
Required. The AuthorizedView to create. |
authorized_view_id |
std::string const &
Required. The id of the AuthorizedView to create. This AuthorizedView must not already exist. The |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
A |
CreateAuthorizedView(NoAwaitTag, std::string const &, google::bigtable::admin::v2::AuthorizedView const &, std::string const &, Options)
Creates a new AuthorizedView in a table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
authorized_view |
google::bigtable::admin::v2::AuthorizedView const &
|
authorized_view_id |
std::string const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateAuthorizedView(google::bigtable::admin::v2::CreateAuthorizedViewRequest const &, Options)
Creates a new AuthorizedView in a table.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CreateAuthorizedViewRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
A |
CreateAuthorizedView(NoAwaitTag, google::bigtable::admin::v2::CreateAuthorizedViewRequest const &, Options)
Creates a new AuthorizedView in a table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::CreateAuthorizedViewRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateAuthorizedView(google::longrunning::Operation const &, Options)
Creates a new AuthorizedView in a table.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
ListAuthorizedViews(std::string const &, Options)
Lists all AuthorizedViews from a specific table.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The unique name of the table for which AuthorizedViews should be listed. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::AuthorizedView > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListAuthorizedViews(google::bigtable::admin::v2::ListAuthorizedViewsRequest, Options)
Lists all AuthorizedViews from a specific table.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::ListAuthorizedViewsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::AuthorizedView > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
GetAuthorizedView(std::string const &, Options)
Gets information from a specified AuthorizedView.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the requested AuthorizedView. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::AuthorizedView > |
the result of the RPC. The response message type (google.bigtable.admin.v2.AuthorizedView) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetAuthorizedView(google::bigtable::admin::v2::GetAuthorizedViewRequest const &, Options)
Gets information from a specified AuthorizedView.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::GetAuthorizedViewRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::AuthorizedView > |
the result of the RPC. The response message type (google.bigtable.admin.v2.AuthorizedView) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateAuthorizedView(google::bigtable::admin::v2::AuthorizedView const &, google::protobuf::FieldMask const &, Options)
Updates an AuthorizedView in a table.
Parameters | |
---|---|
Name | Description |
authorized_view |
google::bigtable::admin::v2::AuthorizedView const &
Required. The AuthorizedView to update. The |
update_mask |
google::protobuf::FieldMask const &
Optional. The list of fields to update. A mask specifying which fields in the AuthorizedView resource should be updated. This mask is relative to the AuthorizedView resource, not to the request message. A field will be overwritten if it is in the mask. If empty, all fields set in the request will be overwritten. A special value |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
A |
UpdateAuthorizedView(NoAwaitTag, google::bigtable::admin::v2::AuthorizedView const &, google::protobuf::FieldMask const &, Options)
Updates an AuthorizedView in a table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
authorized_view |
google::bigtable::admin::v2::AuthorizedView const &
|
update_mask |
google::protobuf::FieldMask const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateAuthorizedView(google::bigtable::admin::v2::UpdateAuthorizedViewRequest const &, Options)
Updates an AuthorizedView in a table.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::UpdateAuthorizedViewRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
A |
UpdateAuthorizedView(NoAwaitTag, google::bigtable::admin::v2::UpdateAuthorizedViewRequest const &, Options)
Updates an AuthorizedView in a table.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::UpdateAuthorizedViewRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
UpdateAuthorizedView(google::longrunning::Operation const &, Options)
Updates an AuthorizedView in a table.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::AuthorizedView > > |
DeleteAuthorizedView(std::string const &, Options)
Permanently deletes a specified AuthorizedView.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the AuthorizedView to be deleted. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
DeleteAuthorizedView(google::bigtable::admin::v2::DeleteAuthorizedViewRequest const &, Options)
Permanently deletes a specified AuthorizedView.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::DeleteAuthorizedViewRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
ModifyColumnFamilies(std::string const &, std::vector< google::bigtable::admin::v2::ModifyColumnFamiliesRequest::Modification > const &, Options)
Performs a series of column family modifications on the specified table.
Either all or none of the modifications will occur before this method returns, but data requests received prior to that point may see a table where only some modifications have taken effect.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the table whose families should be modified. Values are of the form |
modifications |
std::vector< google::bigtable::admin::v2::ModifyColumnFamiliesRequest::Modification > const &
Required. Modifications to be atomically applied to the specified table's families. Entries are applied in order, meaning that earlier modifications can be masked by later ones (in the case of repeated updates to the same family, for example). |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
ModifyColumnFamilies(google::bigtable::admin::v2::ModifyColumnFamiliesRequest const &, Options)
Performs a series of column family modifications on the specified table.
Either all or none of the modifications will occur before this method returns, but data requests received prior to that point may see a table where only some modifications have taken effect.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::ModifyColumnFamiliesRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Table > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Table) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
DropRowRange(google::bigtable::admin::v2::DropRowRangeRequest const &, Options)
Permanently drop/delete a row range from a specified table.
The request can specify whether to delete all rows in a table, or only those that match a particular prefix.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::DropRowRangeRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
GenerateConsistencyToken(std::string const &, Options)
Generates a consistency token for a Table, which can be used in CheckConsistency to check whether mutations to the table that finished before this call started have been replicated.
The tokens will be available for 90 days.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the Table for which to create a consistency token. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::GenerateConsistencyTokenResponse > |
the result of the RPC. The response message type (google.bigtable.admin.v2.GenerateConsistencyTokenResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GenerateConsistencyToken(google::bigtable::admin::v2::GenerateConsistencyTokenRequest const &, Options)
Generates a consistency token for a Table, which can be used in CheckConsistency to check whether mutations to the table that finished before this call started have been replicated.
The tokens will be available for 90 days.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::GenerateConsistencyTokenRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::GenerateConsistencyTokenResponse > |
the result of the RPC. The response message type (google.bigtable.admin.v2.GenerateConsistencyTokenResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CheckConsistency(std::string const &, std::string const &, Options)
Checks replication consistency based on a consistency token, that is, if replication has caught up based on the conditions specified in the token and the check request.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the Table for which to check replication consistency. Values are of the form |
consistency_token |
std::string const &
Required. The token created using GenerateConsistencyToken for the Table. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::CheckConsistencyResponse > |
the result of the RPC. The response message type (google.bigtable.admin.v2.CheckConsistencyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CheckConsistency(google::bigtable::admin::v2::CheckConsistencyRequest const &, Options)
Checks replication consistency based on a consistency token, that is, if replication has caught up based on the conditions specified in the token and the check request.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CheckConsistencyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::CheckConsistencyResponse > |
the result of the RPC. The response message type (google.bigtable.admin.v2.CheckConsistencyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
CreateBackup(std::string const &, std::string const &, google::bigtable::admin::v2::Backup const &, Options)
Starts creating a new Cloud Bigtable Backup.
The returned backup long-running operation can be used to track creation of the backup. The metadata field type is CreateBackupMetadata. The response field type is Backup, if successful. Cancelling the returned operation will stop the creation and delete the backup.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. This must be one of the clusters in the instance in which this table is located. The backup will be stored in this cluster. Values are of the form |
backup_id |
std::string const &
Required. The id of the backup to be created. The |
backup |
google::bigtable::admin::v2::Backup const &
Required. The backup to create. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
A |
CreateBackup(NoAwaitTag, std::string const &, std::string const &, google::bigtable::admin::v2::Backup const &, Options)
Starts creating a new Cloud Bigtable Backup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
backup_id |
std::string const &
|
backup |
google::bigtable::admin::v2::Backup const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateBackup(google::bigtable::admin::v2::CreateBackupRequest const &, Options)
Starts creating a new Cloud Bigtable Backup.
The returned backup long-running operation can be used to track creation of the backup. The metadata field type is CreateBackupMetadata. The response field type is Backup, if successful. Cancelling the returned operation will stop the creation and delete the backup.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CreateBackupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
A |
CreateBackup(NoAwaitTag, google::bigtable::admin::v2::CreateBackupRequest const &, Options)
Starts creating a new Cloud Bigtable Backup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::CreateBackupRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CreateBackup(google::longrunning::Operation const &, Options)
Starts creating a new Cloud Bigtable Backup.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
GetBackup(std::string const &, Options)
Gets metadata on a pending or completed Cloud Bigtable Backup.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the backup. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Backup > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Backup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetBackup(google::bigtable::admin::v2::GetBackupRequest const &, Options)
Gets metadata on a pending or completed Cloud Bigtable Backup.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::GetBackupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Backup > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Backup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateBackup(google::bigtable::admin::v2::Backup const &, google::protobuf::FieldMask const &, Options)
Updates a pending or completed Cloud Bigtable Backup.
Parameters | |
---|---|
Name | Description |
backup |
google::bigtable::admin::v2::Backup const &
Required. The backup to update.
|
update_mask |
google::protobuf::FieldMask const &
Required. A mask specifying which fields (e.g. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Backup > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Backup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
UpdateBackup(google::bigtable::admin::v2::UpdateBackupRequest const &, Options)
Updates a pending or completed Cloud Bigtable Backup.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::UpdateBackupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::bigtable::admin::v2::Backup > |
the result of the RPC. The response message type (google.bigtable.admin.v2.Backup) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
DeleteBackup(std::string const &, Options)
Deletes a pending or completed Cloud Bigtable backup.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. Name of the backup to delete. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
DeleteBackup(google::bigtable::admin::v2::DeleteBackupRequest const &, Options)
Deletes a pending or completed Cloud Bigtable backup.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::DeleteBackupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
Status |
a |
ListBackups(std::string const &, Options)
Lists Cloud Bigtable backups.
Returns both completed and pending backups.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The cluster to list backups from. Values are of the form |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::Backup > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
ListBackups(google::bigtable::admin::v2::ListBackupsRequest, Options)
Lists Cloud Bigtable backups.
Returns both completed and pending backups.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::ListBackupsRequest
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StreamRange< google::bigtable::admin::v2::Backup > |
a StreamRange to iterate of the results. See the documentation of this type for details. In brief, this class has |
RestoreTable(google::bigtable::admin::v2::RestoreTableRequest const &, Options)
Create a new table by restoring from a completed backup.
The returned table long-running operation can be used to track the progress of the operation, and to cancel it. The metadata field type is RestoreTableMetadata. The response type is Table, if successful.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::RestoreTableRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
A |
RestoreTable(NoAwaitTag, google::bigtable::admin::v2::RestoreTableRequest const &, Options)
Create a new table by restoring from a completed backup.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::RestoreTableRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
RestoreTable(google::longrunning::Operation const &, Options)
Create a new table by restoring from a completed backup.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Table > > |
CopyBackup(std::string const &, std::string const &, std::string const &, google::protobuf::Timestamp const &, Options)
Copy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.
Parameters | |
---|---|
Name | Description |
parent |
std::string const &
Required. The name of the destination cluster that will contain the backup copy. The cluster must already exist. Values are of the form: |
backup_id |
std::string const &
Required. The id of the new backup. The |
source_backup |
std::string const &
Required. The source backup to be copied from. The source backup needs to be in READY state for it to be copied. Copying a copied backup is not allowed. Once CopyBackup is in progress, the source backup cannot be deleted or cleaned up on expiration until CopyBackup is finished. Values are of the form: |
expire_time |
google::protobuf::Timestamp const &
Required. Required. The expiration time of the copied backup with microsecond granularity that must be at least 6 hours and at most 30 days from the time the request is received. Once the |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
A |
CopyBackup(NoAwaitTag, std::string const &, std::string const &, std::string const &, google::protobuf::Timestamp const &, Options)
Copy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
parent |
std::string const &
|
backup_id |
std::string const &
|
source_backup |
std::string const &
|
expire_time |
google::protobuf::Timestamp const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CopyBackup(google::bigtable::admin::v2::CopyBackupRequest const &, Options)
Copy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CopyBackupRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
A |
CopyBackup(NoAwaitTag, google::bigtable::admin::v2::CopyBackupRequest const &, Options)
Copy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.
Specifying the NoAwaitTag
immediately returns the [google::longrunning::Operation
] that corresponds to the Long Running Operation that has been started. No polling for operation status occurs.
Parameters | |
---|---|
Name | Description |
|
NoAwaitTag
|
request |
google::bigtable::admin::v2::CopyBackupRequest const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
StatusOr< google::longrunning::Operation > |
CopyBackup(google::longrunning::Operation const &, Options)
Copy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.
This method accepts a google::longrunning::Operation
that corresponds to a previously started Long Running Operation (LRO) and polls the status of the LRO in the background.
Parameters | |
---|---|
Name | Description |
operation |
google::longrunning::Operation const &
|
opts |
Options
|
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::Backup > > |
GetIamPolicy(std::string const &, Options)
Gets the access control policy for a Table or Backup resource.
Returns an empty policy if the resource exists but does not have a policy set.
Parameters | |
---|---|
Name | Description |
resource |
std::string const &
REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
GetIamPolicy(google::iam::v1::GetIamPolicyRequest const &, Options)
Gets the access control policy for a Table or Backup resource.
Returns an empty policy if the resource exists but does not have a policy set.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::GetIamPolicyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
SetIamPolicy(std::string const &, google::iam::v1::Policy const &, Options)
Sets the access control policy on a Table or Backup resource.
Replaces any existing policy.
Parameters | |
---|---|
Name | Description |
resource |
std::string const &
REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. |
policy |
google::iam::v1::Policy const &
REQUIRED: The complete policy to be applied to the |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
SetIamPolicy(std::string const &, IamUpdater const &, Options)
Updates the IAM policy for resource
using an optimistic concurrency control loop.
The loop fetches the current policy for resource
, and passes it to updater
, which should return the new policy. This new policy should use the current etag so that the read-modify-write cycle can detect races and rerun the update when there is a mismatch. If the new policy does not have an etag, the existing policy will be blindly overwritten. If updater
does not yield a policy, the control loop is terminated and kCancelled is returned.
Parameters | |
---|---|
Name | Description |
resource |
std::string const &
Required. The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. |
updater |
IamUpdater const &
Required. Functor to map the current policy to a new one. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
google::iam::v1::Policy |
SetIamPolicy(google::iam::v1::SetIamPolicyRequest const &, Options)
Sets the access control policy on a Table or Backup resource.
Replaces any existing policy.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::SetIamPolicyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::Policy > |
the result of the RPC. The response message type (google.iam.v1.Policy) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
TestIamPermissions(std::string const &, std::vector< std::string > const &, Options)
Returns permissions that the caller has on the specified Table or Backup resource.
Parameters | |
---|---|
Name | Description |
resource |
std::string const &
REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. |
permissions |
std::vector< std::string > const &
The set of permissions to check for the |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::TestIamPermissionsResponse > |
the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
TestIamPermissions(google::iam::v1::TestIamPermissionsRequest const &, Options)
Returns permissions that the caller has on the specified Table or Backup resource.
Parameters | |
---|---|
Name | Description |
request |
google::iam::v1::TestIamPermissionsRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
StatusOr< google::iam::v1::TestIamPermissionsResponse > |
the result of the RPC. The response message type (google.iam.v1.TestIamPermissionsResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
AsyncCheckConsistency(std::string const &, std::string const &, Options)
Checks replication consistency based on a consistency token, that is, if replication has caught up based on the conditions specified in the token and the check request.
Parameters | |
---|---|
Name | Description |
name |
std::string const &
Required. The unique name of the Table for which to check replication consistency. Values are of the form |
consistency_token |
std::string const &
Required. The token created using GenerateConsistencyToken for the Table. |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::CheckConsistencyResponse > > |
the result of the RPC. The response message type (google.bigtable.admin.v2.CheckConsistencyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |
AsyncCheckConsistency(google::bigtable::admin::v2::CheckConsistencyRequest const &, Options)
Checks replication consistency based on a consistency token, that is, if replication has caught up based on the conditions specified in the token and the check request.
Parameters | |
---|---|
Name | Description |
request |
google::bigtable::admin::v2::CheckConsistencyRequest const &
Unary RPCs, such as the one wrapped by this function, receive a single |
opts |
Options
Optional. Override the class-level options, such as retry and backoff policies. |
Returns | |
---|---|
Type | Description |
future< StatusOr< google::bigtable::admin::v2::CheckConsistencyResponse > > |
the result of the RPC. The response message type (google.bigtable.admin.v2.CheckConsistencyResponse) is mapped to a C++ class using the Protobuf mapping rules. If the request fails, the |