google-cloud-bigtable 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7482026aa78be2730c7c84f2f9eb94b777b99a900903757b432b554018609e59
-  data.tar.gz: 1bd67186d8e0b9b768dc15cf8c639dcdc17061fb8553c7102b3cd419540c3d88
+  metadata.gz: 0a1017ef14a932be04b10c48b91c119092d63cb819e3c64afd774123046ebd1c
+  data.tar.gz: 1e31e516af43d142ac8d3a06a58c9a79c8bd145d0dc242df571ea56c201b01d4
 SHA512:
-  metadata.gz: f55df34a047ea018755dfc3e0e68dd617f262fc0216ba53a65c6fd9b3d854aaf722d6a5cfa01d5d3cefc548767471688e049fcb309f5beccb3c92a8a66d6e43c
-  data.tar.gz: 34dd6cebddf95f056bb33d4e57206fbb8d5ac35865205d87c87c8a26288c44729a96b0e7d21941821d064302d88e955ad34bb1e59672edc571d22cf41c7c9acb
+  metadata.gz: 9505756672b52a498ecaf695c639d1f4f01308878e6adbddbe7cf8c4ea36f0f0fc6d26fd8f2874112ba1eb462d4d3a8c83f8f1f456f13fc24bf91473739794c7
+  data.tar.gz: 467538a39acc69162f601920f0924e2707473adf27f0c5b9ee9d9fd3c2be79ac48ffc760c1e7288b586428df49d9f80a123b68f675d2b38f68838d7c82534853

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Release History
 
+### 1.2.1 / 2020-05-21
+
+#### Bug Fixes
+
+* Disable streaming RPC retries in lower-level client
+
 ### 1.2.0 / 2020-03-11
 
 #### Features

data/lib/google/bigtable/admin/v2/bigtable_table_admin_pb.rb

@@ -8,12 +8,14 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/bigtable/admin/v2/common_pb'
 require 'google/bigtable/admin/v2/table_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.bigtable.admin.v2.CreateTableRequest" do
@@ -111,6 +113,58 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :request_time, :message, 2, "google.protobuf.Timestamp"
     optional :finish_time, :message, 3, "google.protobuf.Timestamp"
   end
+  add_message "google.bigtable.admin.v2.CreateBackupRequest" do
+    optional :parent, :string, 1
+    optional :backup_id, :string, 2
+    optional :backup, :message, 3, "google.bigtable.admin.v2.Backup"
+  end
+  add_message "google.bigtable.admin.v2.CreateBackupMetadata" do
+    optional :name, :string, 1
+    optional :source_table, :string, 2
+    optional :start_time, :message, 3, "google.protobuf.Timestamp"
+    optional :end_time, :message, 4, "google.protobuf.Timestamp"
+  end
+  add_message "google.bigtable.admin.v2.GetBackupRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.bigtable.admin.v2.UpdateBackupRequest" do
+    optional :backup, :message, 1, "google.bigtable.admin.v2.Backup"
+    optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+  end
+  add_message "google.bigtable.admin.v2.DeleteBackupRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.bigtable.admin.v2.ListBackupsRequest" do
+    optional :parent, :string, 1
+    optional :filter, :string, 2
+    optional :order_by, :string, 3
+    optional :page_size, :int32, 4
+    optional :page_token, :string, 5
+  end
+  add_message "google.bigtable.admin.v2.ListBackupsResponse" do
+    repeated :backups, :message, 1, "google.bigtable.admin.v2.Backup"
+    optional :next_page_token, :string, 2
+  end
+  add_message "google.bigtable.admin.v2.RestoreTableRequest" do
+    optional :parent, :string, 1
+    optional :table_id, :string, 2
+    oneof :source do
+      optional :backup, :string, 3
+    end
+  end
+  add_message "google.bigtable.admin.v2.RestoreTableMetadata" do
+    optional :name, :string, 1
+    optional :source_type, :enum, 2, "google.bigtable.admin.v2.RestoreSourceType"
+    optional :optimize_table_operation_name, :string, 4
+    optional :progress, :message, 5, "google.bigtable.admin.v2.OperationProgress"
+    oneof :source_info do
+      optional :backup_info, :message, 3, "google.bigtable.admin.v2.BackupInfo"
+    end
+  end
+  add_message "google.bigtable.admin.v2.OptimizeRestoredTableMetadata" do
+    optional :name, :string, 1
+    optional :progress, :message, 2, "google.bigtable.admin.v2.OperationProgress"
+  end
 end
 
 module Google
@@ -138,6 +192,16 @@ module Google
         DeleteSnapshotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.DeleteSnapshotRequest").msgclass
         SnapshotTableMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.SnapshotTableMetadata").msgclass
         CreateTableFromSnapshotMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateTableFromSnapshotMetadata").msgclass
+        CreateBackupRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateBackupRequest").msgclass
+        CreateBackupMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateBackupMetadata").msgclass
+        GetBackupRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.GetBackupRequest").msgclass
+        UpdateBackupRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UpdateBackupRequest").msgclass
+        DeleteBackupRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.DeleteBackupRequest").msgclass
+        ListBackupsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ListBackupsRequest").msgclass
+        ListBackupsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ListBackupsResponse").msgclass
+        RestoreTableRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.RestoreTableRequest").msgclass
+        RestoreTableMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.RestoreTableMetadata").msgclass
+        OptimizeRestoredTableMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.OptimizeRestoredTableMetadata").msgclass
       end
     end
   end

data/lib/google/bigtable/admin/v2/bigtable_table_admin_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/bigtable/admin/v2/bigtable_table_admin.proto for package 'google.bigtable.admin.v2'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 
 require 'grpc'
@@ -109,6 +108,33 @@ module Google
             # recommended for production use. It is not subject to any SLA or deprecation
             # policy.
             rpc :DeleteSnapshot, DeleteSnapshotRequest, Google::Protobuf::Empty
+            # Starts creating a new Cloud Bigtable Backup. The returned backup
+            # [long-running operation][google.longrunning.Operation] can be used to
+            # track creation of the backup. The
+            # [metadata][google.longrunning.Operation.metadata] field type is
+            # [CreateBackupMetadata][google.bigtable.admin.v2.CreateBackupMetadata]. The
+            # [response][google.longrunning.Operation.response] field type is
+            # [Backup][google.bigtable.admin.v2.Backup], if successful. Cancelling the
+            # returned operation will stop the creation and delete the backup.
+            rpc :CreateBackup, CreateBackupRequest, Google::Longrunning::Operation
+            # Gets metadata on a pending or completed Cloud Bigtable Backup.
+            rpc :GetBackup, GetBackupRequest, Backup
+            # Updates a pending or completed Cloud Bigtable Backup.
+            rpc :UpdateBackup, UpdateBackupRequest, Backup
+            # Deletes a pending or completed Cloud Bigtable backup.
+            rpc :DeleteBackup, DeleteBackupRequest, Google::Protobuf::Empty
+            # Lists Cloud Bigtable backups. Returns both completed and pending
+            # backups.
+            rpc :ListBackups, ListBackupsRequest, ListBackupsResponse
+            # Create a new table by restoring from a completed backup. The new table
+            # must be in the same instance as the instance containing the backup. The
+            # returned table [long-running operation][google.longrunning.Operation] can
+            # be used to track the progress of the operation, and to cancel it. The
+            # [metadata][google.longrunning.Operation.metadata] field type is
+            # [RestoreTableMetadata][google.bigtable.admin.RestoreTableMetadata]. The
+            # [response][google.longrunning.Operation.response] type is
+            # [Table][google.bigtable.admin.v2.Table], if successful.
+            rpc :RestoreTable, RestoreTableRequest, Google::Longrunning::Operation
             # Gets the access control policy for a resource.
             # Returns an empty policy if the resource exists but does not have a policy
             # set.

data/lib/google/bigtable/admin/v2/common_pb.rb

@@ -4,9 +4,13 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.bigtable.admin.v2.OperationProgress" do
+    optional :progress_percent, :int32, 1
+    optional :start_time, :message, 2, "google.protobuf.Timestamp"
+    optional :end_time, :message, 3, "google.protobuf.Timestamp"
+  end
   add_enum "google.bigtable.admin.v2.StorageType" do
     value :STORAGE_TYPE_UNSPECIFIED, 0
     value :SSD, 1
@@ -18,6 +22,7 @@ module Google
   module Bigtable
     module Admin
       module V2
+        OperationProgress = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.OperationProgress").msgclass
         StorageType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.StorageType").enummodule
       end
     end

data/lib/google/bigtable/admin/v2/instance_pb.rb

@@ -4,7 +4,6 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/bigtable/admin/v2/common_pb'

data/lib/google/bigtable/admin/v2/table_pb.rb

@@ -4,17 +4,23 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.bigtable.admin.v2.RestoreInfo" do
+    optional :source_type, :enum, 1, "google.bigtable.admin.v2.RestoreSourceType"
+    oneof :source_info do
+      optional :backup_info, :message, 2, "google.bigtable.admin.v2.BackupInfo"
+    end
+  end
   add_message "google.bigtable.admin.v2.Table" do
     optional :name, :string, 1
     map :cluster_states, :string, :message, 2, "google.bigtable.admin.v2.Table.ClusterState"
     map :column_families, :string, :message, 3, "google.bigtable.admin.v2.ColumnFamily"
     optional :granularity, :enum, 4, "google.bigtable.admin.v2.Table.TimestampGranularity"
+    optional :restore_info, :message, 6, "google.bigtable.admin.v2.RestoreInfo"
   end
   add_message "google.bigtable.admin.v2.Table.ClusterState" do
     optional :replication_state, :enum, 1, "google.bigtable.admin.v2.Table.ClusterState.ReplicationState"
@@ -25,6 +31,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :PLANNED_MAINTENANCE, 2
     value :UNPLANNED_MAINTENANCE, 3
     value :READY, 4
+    value :READY_OPTIMIZING, 5
   end
   add_enum "google.bigtable.admin.v2.Table.TimestampGranularity" do
     value :TIMESTAMP_GRANULARITY_UNSPECIFIED, 0
@@ -68,12 +75,37 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :READY, 1
     value :CREATING, 2
   end
+  add_message "google.bigtable.admin.v2.Backup" do
+    optional :name, :string, 1
+    optional :source_table, :string, 2
+    optional :expire_time, :message, 3, "google.protobuf.Timestamp"
+    optional :start_time, :message, 4, "google.protobuf.Timestamp"
+    optional :end_time, :message, 5, "google.protobuf.Timestamp"
+    optional :size_bytes, :int64, 6
+    optional :state, :enum, 7, "google.bigtable.admin.v2.Backup.State"
+  end
+  add_enum "google.bigtable.admin.v2.Backup.State" do
+    value :STATE_UNSPECIFIED, 0
+    value :CREATING, 1
+    value :READY, 2
+  end
+  add_message "google.bigtable.admin.v2.BackupInfo" do
+    optional :backup, :string, 1
+    optional :start_time, :message, 2, "google.protobuf.Timestamp"
+    optional :end_time, :message, 3, "google.protobuf.Timestamp"
+    optional :source_table, :string, 4
+  end
+  add_enum "google.bigtable.admin.v2.RestoreSourceType" do
+    value :RESTORE_SOURCE_TYPE_UNSPECIFIED, 0
+    value :BACKUP, 1
+  end
 end
 
 module Google
   module Bigtable
     module Admin
       module V2
+        RestoreInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.RestoreInfo").msgclass
         Table = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Table").msgclass
         Table::ClusterState = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Table.ClusterState").msgclass
         Table::ClusterState::ReplicationState = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Table.ClusterState.ReplicationState").enummodule
@@ -85,6 +117,10 @@ module Google
         GcRule::Union = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.GcRule.Union").msgclass
         Snapshot = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Snapshot").msgclass
         Snapshot::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Snapshot.State").enummodule
+        Backup = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Backup").msgclass
+        Backup::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.Backup.State").enummodule
+        BackupInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.BackupInfo").msgclass
+        RestoreSourceType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.RestoreSourceType").enummodule
       end
     end
   end

data/lib/google/cloud/bigtable/admin/v2.rb

@@ -16,6 +16,7 @@
 require "google/cloud/bigtable/admin/v2/bigtable_instance_admin_client"
 require "google/cloud/bigtable/admin/v2/bigtable_table_admin_client"
 require "google/bigtable/admin/v2/bigtable_instance_admin_pb"
+require "google/bigtable/admin/v2/table_pb"
 require "google/bigtable/admin/v2/bigtable_table_admin_pb"
 
 module Google

data/lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client.rb

@@ -944,8 +944,8 @@ module Google
             #   The unique name of the cluster. Values are of the form
             #   `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
             # @param serve_nodes [Integer]
-            #   Required. The number of nodes allocated to this cluster. More nodes enable higher
-            #   throughput and more consistent performance.
+            #   Required. The number of nodes allocated to this cluster. More nodes enable
+            #   higher throughput and more consistent performance.
             # @param location [String]
             #   (`CreationOnly`)
             #   The location where this cluster's nodes and storage reside. For best

data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client.rb

@@ -67,7 +67,11 @@ module Google
               "list_snapshots" => Google::Gax::PageDescriptor.new(
                 "page_token",
                 "next_page_token",
-                "snapshots")
+                "snapshots"),
+              "list_backups" => Google::Gax::PageDescriptor.new(
+                "page_token",
+                "next_page_token",
+                "backups")
             }.freeze
 
             private_constant :PAGE_DESCRIPTORS
@@ -92,6 +96,12 @@ module Google
               self::GRPC_INTERCEPTORS = BigtableTableAdminClient::GRPC_INTERCEPTORS
             end
 
+            BACKUP_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+              "projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}"
+            )
+
+            private_constant :BACKUP_PATH_TEMPLATE
+
             CLUSTER_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
               "projects/{project}/instances/{instance}/clusters/{cluster}"
             )
@@ -116,6 +126,21 @@ module Google
 
             private_constant :TABLE_PATH_TEMPLATE
 
+            # Returns a fully-qualified backup resource name string.
+            # @param project [String]
+            # @param instance [String]
+            # @param cluster [String]
+            # @param backup [String]
+            # @return [String]
+            def self.backup_path project, instance, cluster, backup
+              BACKUP_PATH_TEMPLATE.render(
+                :"project" => project,
+                :"instance" => instance,
+                :"cluster" => cluster,
+                :"backup" => backup
+              )
+            end
+
             # Returns a fully-qualified cluster resource name string.
             # @param project [String]
             # @param instance [String]
@@ -420,6 +445,54 @@ module Google
                   {'name' => request.name}
                 end
               )
+              @create_backup = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:create_backup),
+                defaults["create_backup"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'parent' => request.parent}
+                end
+              )
+              @get_backup = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:get_backup),
+                defaults["get_backup"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'name' => request.name}
+                end
+              )
+              @list_backups = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:list_backups),
+                defaults["list_backups"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'parent' => request.parent}
+                end
+              )
+              @update_backup = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:update_backup),
+                defaults["update_backup"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'backup.name' => request.backup.name}
+                end
+              )
+              @delete_backup = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:delete_backup),
+                defaults["delete_backup"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'name' => request.name}
+                end
+              )
+              @restore_table = Google::Gax.create_api_call(
+                @bigtable_table_admin_stub.method(:restore_table),
+                defaults["restore_table"],
+                exception_transformer: exception_transformer,
+                params_extractor: proc do |request|
+                  {'parent' => request.parent}
+                end
+              )
             end
 
             # Service calls
@@ -432,8 +505,8 @@ module Google
             #   Required. The unique name of the instance in which to create the table.
             #   Values are of the form `projects/{project}/instances/{instance}`.
             # @param table_id [String]
-            #   Required. The name by which the new table should be referred to within the parent
-            #   instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
+            #   Required. The name by which the new table should be referred to within the
+            #   parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
             #   Maximum 50 characters.
             # @param table [Google::Bigtable::Admin::V2::Table | Hash]
             #   Required. The Table to create.
@@ -509,12 +582,12 @@ module Google
             #   Required. The unique name of the instance in which to create the table.
             #   Values are of the form `projects/{project}/instances/{instance}`.
             # @param table_id [String]
-            #   Required. The name by which the new table should be referred to within the parent
-            #   instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
+            #   Required. The name by which the new table should be referred to within the
+            #   parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
             # @param source_snapshot [String]
-            #   Required. The unique name of the snapshot from which to restore the table. The
-            #   snapshot and the table must be in the same instance.
-            #   Values are of the form
+            #   Required. The unique name of the snapshot from which to restore the table.
+            #   The snapshot and the table must be in the same instance. Values are of the
+            #   form
             #   `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
@@ -585,8 +658,8 @@ module Google
             # Lists all tables served from a specified instance.
             #
             # @param parent [String]
-            #   Required. The unique name of the instance for which tables should be listed.
-            #   Values are of the form `projects/{project}/instances/{instance}`.
+            #   Required. The unique name of the instance for which tables should be
+            #   listed. Values are of the form `projects/{project}/instances/{instance}`.
             # @param view [Google::Bigtable::Admin::V2::Table::View]
             #   The view to be applied to the returned tables' fields.
             #   Only NAME_ONLY view (default) and REPLICATION_VIEW are supported.
@@ -725,10 +798,10 @@ module Google
             #   Values are of the form
             #   `projects/{project}/instances/{instance}/tables/{table}`.
             # @param modifications [Array<Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification | Hash>]
-            #   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).
+            #   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).
             #   A hash of the same form as `Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification`
             #   can also be provided.
             # @param options [Google::Gax::CallOptions]
@@ -811,8 +884,8 @@ module Google
             # for 90 days.
             #
             # @param name [String]
-            #   Required. The unique name of the Table for which to create a consistency token.
-            #   Values are of the form
+            #   Required. The unique name of the Table for which to create a consistency
+            #   token. Values are of the form
             #   `projects/{project}/instances/{instance}/tables/{table}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
@@ -845,8 +918,8 @@ module Google
             # and the check request.
             #
             # @param name [String]
-            #   Required. The unique name of the Table for which to check replication consistency.
-            #   Values are of the form
+            #   Required. The unique name of the Table for which to check replication
+            #   consistency. Values are of the form
             #   `projects/{project}/instances/{instance}/tables/{table}`.
             # @param consistency_token [String]
             #   Required. The token created using GenerateConsistencyToken for the Table.
@@ -1016,17 +1089,17 @@ module Google
             # policy.
             #
             # @param name [String]
-            #   The unique name of the table to have the snapshot taken.
+            #   Required. The unique name of the table to have the snapshot taken.
             #   Values are of the form
             #   `projects/{project}/instances/{instance}/tables/{table}`.
             # @param cluster [String]
-            #   The name of the cluster where the snapshot will be created in.
+            #   Required. The name of the cluster where the snapshot will be created in.
             #   Values are of the form
             #   `projects/{project}/instances/{instance}/clusters/{cluster}`.
             # @param snapshot_id [String]
-            #   The ID by which the new snapshot should be referred to within the parent
-            #   cluster, e.g., `mysnapshot` of the form: `[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
-            #   rather than
+            #   Required. The ID by which the new snapshot should be referred to within the
+            #   parent cluster, e.g., `mysnapshot` of the form:
+            #   `[_a-zA-Z0-9][-_.a-zA-Z0-9]*` rather than
             #   `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/mysnapshot`.
             # @param description [String]
             #   Description of the snapshot.
@@ -1157,8 +1230,8 @@ module Google
             # policy.
             #
             # @param parent [String]
-            #   Required. The unique name of the cluster for which snapshots should be listed.
-            #   Values are of the form
+            #   Required. The unique name of the cluster for which snapshots should be
+            #   listed. Values are of the form
             #   `projects/{project}/instances/{instance}/clusters/{cluster}`.
             #   Use `{cluster} = '-'` to list snapshots for all clusters in an instance,
             #   e.g., `projects/{project}/instances/{instance}/clusters/-`.
@@ -1249,6 +1322,410 @@ module Google
               @delete_snapshot.call(req, options, &block)
               nil
             end
+
+            # Starts creating a new Cloud Bigtable Backup. The returned backup
+            # {Google::Longrunning::Operation long-running operation} can be used to
+            # track creation of the backup. The
+            # {Google::Longrunning::Operation#metadata metadata} field type is
+            # {Google::Bigtable::Admin::V2::CreateBackupMetadata CreateBackupMetadata}. The
+            # {Google::Longrunning::Operation#response response} field type is
+            # {Google::Bigtable::Admin::V2::Backup Backup}, if successful. Cancelling the
+            # returned operation will stop the creation and delete the backup.
+            #
+            # @param parent [String]
+            #   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 `projects/{project}/instances/{instance}/clusters/{cluster}`.
+            # @param backup_id [String]
+            #   Required. The id of the backup to be created. The `backup_id` along with
+            #   the parent `parent` are combined as \\{parent}/backups/\\{backup_id} to create
+            #   the full backup name, of the form:
+            #   `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup_id}`.
+            #   This string must be between 1 and 50 characters in length and match the
+            #   regex [_a-zA-Z0-9][-_.a-zA-Z0-9]*.
+            # @param backup [Google::Bigtable::Admin::V2::Backup | Hash]
+            #   Required. The backup to create.
+            #   A hash of the same form as `Google::Bigtable::Admin::V2::Backup`
+            #   can also be provided.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @return [Google::Gax::Operation]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_parent = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+            #
+            #   # TODO: Initialize `backup_id`:
+            #   backup_id = ''
+            #
+            #   # TODO: Initialize `backup`:
+            #   backup = {}
+            #
+            #   # Register a callback during the method call.
+            #   operation = bigtable_table_admin_client.create_backup(formatted_parent, backup_id, backup) do |op|
+            #     raise op.results.message if op.error?
+            #     op_results = op.results
+            #     # Process the results.
+            #
+            #     metadata = op.metadata
+            #     # Process the metadata.
+            #   end
+            #
+            #   # Or use the return value to register a callback.
+            #   operation.on_done do |op|
+            #     raise op.results.message if op.error?
+            #     op_results = op.results
+            #     # Process the results.
+            #
+            #     metadata = op.metadata
+            #     # Process the metadata.
+            #   end
+            #
+            #   # Manually reload the operation.
+            #   operation.reload!
+            #
+            #   # Or block until the operation completes, triggering callbacks on
+            #   # completion.
+            #   operation.wait_until_done!
+
+            def create_backup \
+                parent,
+                backup_id,
+                backup,
+                options: nil
+              req = {
+                parent: parent,
+                backup_id: backup_id,
+                backup: backup
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::CreateBackupRequest)
+              operation = Google::Gax::Operation.new(
+                @create_backup.call(req, options),
+                @operations_client,
+                Google::Bigtable::Admin::V2::Backup,
+                Google::Bigtable::Admin::V2::CreateBackupMetadata,
+                call_options: options
+              )
+              operation.on_done { |operation| yield(operation) } if block_given?
+              operation
+            end
+
+            # Gets metadata on a pending or completed Cloud Bigtable Backup.
+            #
+            # @param name [String]
+            #   Required. Name of the backup.
+            #   Values are of the form
+            #   `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Bigtable::Admin::V2::Backup]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Bigtable::Admin::V2::Backup]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_name = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.backup_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[BACKUP]")
+            #   response = bigtable_table_admin_client.get_backup(formatted_name)
+
+            def get_backup \
+                name,
+                options: nil,
+                &block
+              req = {
+                name: name
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::GetBackupRequest)
+              @get_backup.call(req, options, &block)
+            end
+
+            # Lists Cloud Bigtable backups. Returns both completed and pending
+            # backups.
+            #
+            # @param parent [String]
+            #   Required. The cluster to list backups from. Values are of the
+            #   form `projects/{project}/instances/{instance}/clusters/{cluster}`.
+            #   Use `{cluster} = '-'` to list backups for all clusters in an instance,
+            #   e.g., `projects/{project}/instances/{instance}/clusters/-`.
+            # @param filter [String]
+            #   A filter expression that filters backups listed in the response.
+            #   The expression must specify the field name, a comparison operator,
+            #   and the value that you want to use for filtering. The value must be a
+            #   string, a number, or a boolean. The comparison operator must be
+            #   <, >, <=, >=, !=, =, or :. Colon ‘:’ represents a HAS operator which is
+            #   roughly synonymous with equality. Filter rules are case insensitive.
+            #
+            #   The fields eligible for filtering are:
+            #   * `name`
+            #     * `source_table`
+            #     * `state`
+            #     * `start_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+            #     * `end_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+            #     * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+            #     * `size_bytes`
+            #
+            #     To filter on multiple expressions, provide each separate expression within
+            #     parentheses. By default, each expression is an AND expression. However,
+            #     you can include AND, OR, and NOT expressions explicitly.
+            #
+            #   Some examples of using filters are:
+            #
+            #   * `name:"exact"` --> The backup's name is the string "exact".
+            #     * `name:howl` --> The backup's name contains the string "howl".
+            #     * `source_table:prod`
+            #       --> The source_table's name contains the string "prod".
+            #     * `state:CREATING` --> The backup is pending creation.
+            #     * `state:READY` --> The backup is fully created and ready for use.
+            #     * `(name:howl) AND (start_time < \"2018-03-28T14:50:00Z\")`
+            #       --> The backup name contains the string "howl" and start_time
+            #       of the backup is before 2018-03-28T14:50:00Z.
+            #     * `size_bytes > 10000000000` --> The backup's size is greater than 10GB
+            # @param order_by [String]
+            #   An expression for specifying the sort order of the results of the request.
+            #   The string value should specify one or more fields in
+            #   {Google::Bigtable::Admin::V2::Backup Backup}. The full syntax is described at
+            #   https://aip.dev/132#ordering.
+            #
+            #   Fields supported are:
+            #   * name
+            #     * source_table
+            #       * expire_time
+            #     * start_time
+            #       * end_time
+            #     * size_bytes
+            #       * state
+            #
+            #       For example, "start_time". The default sorting order is ascending.
+            #       To specify descending order for the field, a suffix " desc" should
+            #       be appended to the field name. For example, "start_time desc".
+            #       Redundant space characters in the syntax are insigificant.
+            #
+            #     If order_by is empty, results will be sorted by `start_time` in descending
+            #     order starting from the most recently created backup.
+            # @param page_size [Integer]
+            #   The maximum number of resources contained in the underlying API
+            #   response. If page streaming is performed per-resource, this
+            #   parameter does not affect the return value. If page streaming is
+            #   performed per-page, this determines the maximum number of
+            #   resources in a page.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Gax::PagedEnumerable<Google::Bigtable::Admin::V2::Backup>]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Gax::PagedEnumerable<Google::Bigtable::Admin::V2::Backup>]
+            #   An enumerable of Google::Bigtable::Admin::V2::Backup instances.
+            #   See Google::Gax::PagedEnumerable documentation for other
+            #   operations such as per-page iteration or access to the response
+            #   object.
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_parent = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+            #
+            #   # Iterate over all results.
+            #   bigtable_table_admin_client.list_backups(formatted_parent).each do |element|
+            #     # Process element.
+            #   end
+            #
+            #   # Or iterate over results one page at a time.
+            #   bigtable_table_admin_client.list_backups(formatted_parent).each_page do |page|
+            #     # Process each page at a time.
+            #     page.each do |element|
+            #       # Process element.
+            #     end
+            #   end
+
+            def list_backups \
+                parent,
+                filter: nil,
+                order_by: nil,
+                page_size: nil,
+                options: nil,
+                &block
+              req = {
+                parent: parent,
+                filter: filter,
+                order_by: order_by,
+                page_size: page_size
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::ListBackupsRequest)
+              @list_backups.call(req, options, &block)
+            end
+
+            # Updates a pending or completed Cloud Bigtable Backup.
+            #
+            # @param backup [Google::Bigtable::Admin::V2::Backup | Hash]
+            #   Required. The backup to update. `backup.name`, and the fields to be updated
+            #   as specified by `update_mask` are required. Other fields are ignored.
+            #   Update is only supported for the following fields:
+            #   * `backup.expire_time`.
+            #   A hash of the same form as `Google::Bigtable::Admin::V2::Backup`
+            #   can also be provided.
+            # @param update_mask [Google::Protobuf::FieldMask | Hash]
+            #   Required. A mask specifying which fields (e.g. `expire_time`) in the
+            #   Backup resource should be updated. This mask is relative to the Backup
+            #   resource, not to the request message. The field mask must always be
+            #   specified; this prevents any future fields from being erased accidentally
+            #   by clients that do not know about them.
+            #   A hash of the same form as `Google::Protobuf::FieldMask`
+            #   can also be provided.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result [Google::Bigtable::Admin::V2::Backup]
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @return [Google::Bigtable::Admin::V2::Backup]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #
+            #   # TODO: Initialize `backup`:
+            #   backup = {}
+            #
+            #   # TODO: Initialize `update_mask`:
+            #   update_mask = {}
+            #   response = bigtable_table_admin_client.update_backup(backup, update_mask)
+
+            def update_backup \
+                backup,
+                update_mask,
+                options: nil,
+                &block
+              req = {
+                backup: backup,
+                update_mask: update_mask
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::UpdateBackupRequest)
+              @update_backup.call(req, options, &block)
+            end
+
+            # Deletes a pending or completed Cloud Bigtable backup.
+            #
+            # @param name [String]
+            #   Required. Name of the backup to delete.
+            #   Values are of the form
+            #   `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @yield [result, operation] Access the result along with the RPC operation
+            # @yieldparam result []
+            # @yieldparam operation [GRPC::ActiveCall::Operation]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #   formatted_name = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient.backup_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[BACKUP]")
+            #   bigtable_table_admin_client.delete_backup(formatted_name)
+
+            def delete_backup \
+                name,
+                options: nil,
+                &block
+              req = {
+                name: name
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::DeleteBackupRequest)
+              @delete_backup.call(req, options, &block)
+              nil
+            end
+
+            # Create a new table by restoring from a completed backup. The new table
+            # must be in the same instance as the instance containing the backup. The
+            # returned table {Google::Longrunning::Operation long-running operation} can
+            # be used to track the progress of the operation, and to cancel it. The
+            # {Google::Longrunning::Operation#metadata metadata} field type is
+            # {Google::Bigtable::Admin::RestoreTableMetadata RestoreTableMetadata}. The
+            # {Google::Longrunning::Operation#response response} type is
+            # {Google::Bigtable::Admin::V2::Table Table}, if successful.
+            #
+            # @param parent [String]
+            #   Required. The name of the instance in which to create the restored
+            #   table. This instance must be the parent of the source backup. Values are
+            #   of the form `projects/<project>/instances/<instance>`.
+            # @param table_id [String]
+            #   Required. The id of the table to create and restore to. This
+            #   table must not already exist. The `table_id` appended to
+            #   `parent` forms the full table name of the form
+            #   `projects/<project>/instances/<instance>/tables/<table_id>`.
+            # @param backup [String]
+            #   Name of the backup from which to restore. Values are of the form
+            #   `projects/<project>/instances/<instance>/clusters/<cluster>/backups/<backup>`.
+            # @param options [Google::Gax::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout,
+            #   retries, etc.
+            # @return [Google::Gax::Operation]
+            # @raise [Google::Gax::GaxError] if the RPC is aborted.
+            # @example
+            #   require "google/cloud/bigtable/admin"
+            #
+            #   bigtable_table_admin_client = Google::Cloud::Bigtable::Admin::BigtableTableAdmin.new(version: :v2)
+            #
+            #   # TODO: Initialize `parent`:
+            #   parent = ''
+            #
+            #   # Register a callback during the method call.
+            #   operation = bigtable_table_admin_client.restore_table(parent) do |op|
+            #     raise op.results.message if op.error?
+            #     op_results = op.results
+            #     # Process the results.
+            #
+            #     metadata = op.metadata
+            #     # Process the metadata.
+            #   end
+            #
+            #   # Or use the return value to register a callback.
+            #   operation.on_done do |op|
+            #     raise op.results.message if op.error?
+            #     op_results = op.results
+            #     # Process the results.
+            #
+            #     metadata = op.metadata
+            #     # Process the metadata.
+            #   end
+            #
+            #   # Manually reload the operation.
+            #   operation.reload!
+            #
+            #   # Or block until the operation completes, triggering callbacks on
+            #   # completion.
+            #   operation.wait_until_done!
+
+            def restore_table \
+                parent,
+                table_id: nil,
+                backup: nil,
+                options: nil
+              req = {
+                parent: parent,
+                table_id: table_id,
+                backup: backup
+              }.delete_if { |_, v| v.nil? }
+              req = Google::Gax::to_proto(req, Google::Bigtable::Admin::V2::RestoreTableRequest)
+              operation = Google::Gax::Operation.new(
+                @restore_table.call(req, options),
+                @operations_client,
+                Google::Bigtable::Admin::V2::Table,
+                Google::Bigtable::Admin::V2::RestoreTableMetadata,
+                call_options: options
+              )
+              operation.on_done { |operation| yield(operation) } if block_given?
+              operation
+            end
           end
         end
       end