google-cloud-bigtable 1.0.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a043924866764ff0a48e0787f4cf3cda747470cbd81977734aac3ed8ff080cd8
-  data.tar.gz: ec6fdc94f142babade487a79415fba618ebcd3ec83a0ea8d3a8820dc6b3f4eea
+  metadata.gz: 22ba3e63a3716fdb413bafb9c74a72f8f86e356a5b8a3f3a2776522313d7efbd
+  data.tar.gz: 984879dec7e158489426f4f12c41b947e604c6164f0ebe26aa01dae7216ad6f5
 SHA512:
-  metadata.gz: f67a6084d021869cbbf8065a2d5bec0452ba92d2754832e33f041e06e19d6988037c922118d4a443db7ba741034519c274fd201cc09871ca4da92bbfbcd076bd
-  data.tar.gz: 4b1f0e5b94d521830fd7626b37d1be278d1f34b9e4cb8b95a14a7c9a8ddf17aa5c1697c9ef42f4b2fa31d1c90f8aec7c0103eacd12591a553440144f1414324b
+  metadata.gz: 7afc6e313ac4fda9ccd2d810d5b698d0790fbfbcbab2ddcdd748c8597b7d979c83e24de30d89a0cd201fe7e06afb3597961620c3efa68a6b205500e0c146ed6d
+  data.tar.gz: 05c513ddcd8aabf0f9f53100c863708e648384b9252c17e10a8e721446b579f2e6466f9d3d87bf7ce5fdc4fbca94e0cf0707f585b79bf77703a0c4b35da9cade

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Release History
 
+### 1.2.2 / 2020-05-28
+
+#### Documentation
+
+* Fix a few broken links
+
+### 1.2.1 / 2020-05-21
+
+#### Bug Fixes
+
+* Disable streaming RPC retries in lower-level client
+
+### 1.2.0 / 2020-03-11
+
+#### Features
+
+* Support separate project setting for quota/billing
+
+### 1.1.0 / 2020-02-10
+
+#### Features
+
+* Add Table-level IAM Policy support
+
+### 1.0.2 / 2020-01-23
+
+#### Documentation
+
+* Update copyright year
+* Update Status documentation
+
 ### 1.0.1 / 2020-01-15
 
 #### Documentation

data/TROUBLESHOOTING.md

@@ -24,14 +24,8 @@ improved, *please* create a new issue on GitHub so we can talk about it.
 
   - [New issue][gh-ruby]
 
-Or, you can ask questions on the [Google Cloud Platform Slack][slack-ruby]. You
-can use the "ruby" channel for general Ruby questions, or use the
-"google-cloud-ruby" channel if you have questions about this gem in particular.
-
 [so-ruby]: http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby+bigtable
 
-[gh-search-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues?q=label%3A%22api%3A+bigtable%22
-
-[gh-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues/new
+[gh-search-ruby]: https://github.com/googleapis/google-cloud-ruby/issues?q=label%3A%22api%3A+bigtable%22
 
-[slack-ruby]: https://gcp-slack.appspot.com/
+[gh-ruby]: https://github.com/googleapis/google-cloud-ruby/issues/new

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

@@ -5,6 +5,9 @@
 require 'google/protobuf'
 
 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/instance_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'

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

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/bigtable/admin/v2/bigtable_instance_admin.proto for package 'google.bigtable.admin.v2'
 # Original file comments:
-# Copyright 2018 Google LLC.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -43,9 +43,12 @@ module Google
             rpc :GetInstance, GetInstanceRequest, Instance
             # Lists information about instances in a project.
             rpc :ListInstances, ListInstancesRequest, ListInstancesResponse
-            # Updates an instance within a project.
+            # Updates an instance within a project. This method updates only the display
+            # name and type for an Instance. To update other Instance properties, such as
+            # labels, use PartialUpdateInstance.
             rpc :UpdateInstance, Instance, Instance
-            # Partially updates an instance within a project.
+            # Partially updates an instance within a project. This method can modify all
+            # fields of an Instance and is the preferred way to update an Instance.
             rpc :PartialUpdateInstance, PartialUpdateInstanceRequest, Google::Longrunning::Operation
             # Delete an instance from a project.
             rpc :DeleteInstance, DeleteInstanceRequest, Google::Protobuf::Empty

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

@@ -5,12 +5,17 @@
 require 'google/protobuf'
 
 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
@@ -108,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
@@ -135,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 2018 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,11 +108,39 @@ module Google
             # recommended for production use. It is not subject to any SLA or deprecation
             # policy.
             rpc :DeleteSnapshot, DeleteSnapshotRequest, Google::Protobuf::Empty
-            # Gets the access control policy for a table resource. Returns an empty
-            # policy if an table exists but does not have a policy set.
+            # 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.
             rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
-            # Sets the access control policy on a table resource. Replaces any existing
-            # policy.
+            # Sets the access control policy on a Table or Backup resource.
+            # Replaces any existing policy.
             rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
             # Returns permissions that the caller has on the specified table resource.
             rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse

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,8 @@
 
 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'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.bigtable.admin.v2.Instance" do

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

@@ -4,15 +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"
@@ -23,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
@@ -66,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
@@ -83,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.rb

@@ -1,4 +1,4 @@
-# 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.
@@ -22,10 +22,10 @@ module Google
       # rubocop:disable LineLength
 
       ##
-      # # Ruby Client for Cloud Bigtable Admin API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
+      # # Ruby Client for Cloud Bigtable Admin API
       #
       # [Cloud Bigtable Admin API][Product Documentation]:
-      #
+      # Administer your Cloud Bigtable tables and instances.
       # - [Product Documentation][]
       #
       # ## Quick Start
@@ -48,7 +48,7 @@ module Google
       # - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
       #   to see the full list of Cloud APIs that we cover.
       #
-      # [Product Documentation]: https://cloud.google.com/bigtable-admin
+      # [Product Documentation]: https://cloud.google.com/bigtable/docs/reference/admin/rpc
       #
       # ## Enabling Logging
       #

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

@@ -1,4 +1,4 @@
-# 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.
@@ -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
@@ -25,10 +26,10 @@ module Google
         # rubocop:disable LineLength
 
         ##
-        # # Ruby Client for Cloud Bigtable Admin API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
+        # # Ruby Client for Cloud Bigtable Admin API
         #
         # [Cloud Bigtable Admin API][Product Documentation]:
-        #
+        # Administer your Cloud Bigtable tables and instances.
         # - [Product Documentation][]
         #
         # ## Quick Start
@@ -51,7 +52,7 @@ module Google
         # - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
         #   to see the full list of Cloud APIs that we cover.
         #
-        # [Product Documentation]: https://cloud.google.com/bigtable-admin
+        # [Product Documentation]: https://cloud.google.com/bigtable/docs/reference/admin/rpc
         #
         # ## Enabling Logging
         #

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

@@ -1,4 +1,4 @@
-# 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.
@@ -262,6 +262,9 @@ module Google
               google_api_client.freeze
 
               headers = { :"x-goog-api-client" => google_api_client }
+              if credentials.respond_to?(:quota_project_id) && credentials.quota_project_id
+                headers[:"x-goog-user-project"] = credentials.quota_project_id
+              end
               headers.merge!(metadata) unless metadata.nil?
               client_config_file = Pathname.new(__dir__).join(
                 "bigtable_instance_admin_client_config.json"
@@ -453,23 +456,23 @@ module Google
             # Create an instance within a project.
             #
             # @param parent [String]
-            #   The unique name of the project in which to create the new instance.
-            #   Values are of the form `projects/<project>`.
+            #   Required. The unique name of the project in which to create the new instance.
+            #   Values are of the form `projects/{project}`.
             # @param instance_id [String]
-            #   The ID to be used when referring to the new instance within its project,
+            #   Required. The ID to be used when referring to the new instance within its project,
             #   e.g., just `myinstance` rather than
             #   `projects/myproject/instances/myinstance`.
             # @param instance [Google::Bigtable::Admin::V2::Instance | Hash]
-            #   The instance to create.
+            #   Required. The instance to create.
             #   Fields marked `OutputOnly` must be left blank.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::Instance`
             #   can also be provided.
             # @param clusters [Hash{String => Google::Bigtable::Admin::V2::Cluster | Hash}]
-            #   The clusters to be created within the instance, mapped by desired
+            #   Required. The clusters to be created within the instance, mapped by desired
             #   cluster ID, e.g., just `mycluster` rather than
             #   `projects/myproject/instances/myinstance/clusters/mycluster`.
             #   Fields marked `OutputOnly` must be left blank.
-            #   Currently, at most two clusters can be specified.
+            #   Currently, at most four clusters can be specified.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::Cluster`
             #   can also be provided.
             # @param options [Google::Gax::CallOptions]
@@ -546,8 +549,8 @@ module Google
             # Gets information about an instance.
             #
             # @param name [String]
-            #   The unique name of the requested instance. Values are of the form
-            #   `projects/<project>/instances/<instance>`.
+            #   Required. The unique name of the requested instance. Values are of the form
+            #   `projects/{project}/instances/{instance}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -577,8 +580,8 @@ module Google
             # Lists information about instances in a project.
             #
             # @param parent [String]
-            #   The unique name of the project for which a list of instances is requested.
-            #   Values are of the form `projects/<project>`.
+            #   Required. The unique name of the project for which a list of instances is requested.
+            #   Values are of the form `projects/{project}`.
             # @param page_token [String]
             #   DEPRECATED: This field is unused and ignored.
             # @param options [Google::Gax::CallOptions]
@@ -609,14 +612,15 @@ module Google
               @list_instances.call(req, options, &block)
             end
 
-            # Updates an instance within a project.
+            # Updates an instance within a project. This method updates only the display
+            # name and type for an Instance. To update other Instance properties, such as
+            # labels, use PartialUpdateInstance.
             #
             # @param name [String]
-            #   (`OutputOnly`)
             #   The unique name of the instance. Values are of the form
-            #   `projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
+            #   `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
             # @param display_name [String]
-            #   The descriptive name for this instance as it appears in UIs.
+            #   Required. The descriptive name for this instance as it appears in UIs.
             #   Can be changed at any time, but should be kept globally unique
             #   to avoid confusion.
             # @param type [Google::Bigtable::Admin::V2::Instance::Type]
@@ -679,14 +683,15 @@ module Google
               @update_instance.call(req, options, &block)
             end
 
-            # Partially updates an instance within a project.
+            # Partially updates an instance within a project. This method can modify all
+            # fields of an Instance and is the preferred way to update an Instance.
             #
             # @param instance [Google::Bigtable::Admin::V2::Instance | Hash]
-            #   The Instance which will (partially) replace the current value.
+            #   Required. The Instance which will (partially) replace the current value.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::Instance`
             #   can also be provided.
             # @param update_mask [Google::Protobuf::FieldMask | Hash]
-            #   The subset of Instance fields which should be replaced.
+            #   Required. The subset of Instance fields which should be replaced.
             #   Must be explicitly set.
             #   A hash of the same form as `Google::Protobuf::FieldMask`
             #   can also be provided.
@@ -756,8 +761,8 @@ module Google
             # Delete an instance from a project.
             #
             # @param name [String]
-            #   The unique name of the instance to be deleted.
-            #   Values are of the form `projects/<project>/instances/<instance>`.
+            #   Required. The unique name of the instance to be deleted.
+            #   Values are of the form `projects/{project}/instances/{instance}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -787,15 +792,15 @@ module Google
             # Creates a cluster within an instance.
             #
             # @param parent [String]
-            #   The unique name of the instance in which to create the new cluster.
+            #   Required. The unique name of the instance in which to create the new cluster.
             #   Values are of the form
-            #   `projects/<project>/instances/<instance>`.
+            #   `projects/{project}/instances/{instance}`.
             # @param cluster_id [String]
-            #   The ID to be used when referring to the new cluster within its instance,
+            #   Required. The ID to be used when referring to the new cluster within its instance,
             #   e.g., just `mycluster` rather than
             #   `projects/myproject/instances/myinstance/clusters/mycluster`.
             # @param cluster [Google::Bigtable::Admin::V2::Cluster | Hash]
-            #   The cluster to be created.
+            #   Required. The cluster to be created.
             #   Fields marked `OutputOnly` must be left blank.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::Cluster`
             #   can also be provided.
@@ -868,8 +873,8 @@ module Google
             # Gets information about a cluster.
             #
             # @param name [String]
-            #   The unique name of the requested cluster. Values are of the form
-            #   `projects/<project>/instances/<instance>/clusters/<cluster>`.
+            #   Required. The unique name of the requested cluster. Values are of the form
+            #   `projects/{project}/instances/{instance}/clusters/{cluster}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -899,9 +904,9 @@ module Google
             # Lists information about clusters in an instance.
             #
             # @param parent [String]
-            #   The unique name of the instance for which a list of clusters is requested.
-            #   Values are of the form `projects/<project>/instances/<instance>`.
-            #   Use `<instance> = '-'` to list Clusters for all Instances in a project,
+            #   Required. The unique name of the instance for which a list of clusters is requested.
+            #   Values are of the form `projects/{project}/instances/{instance}`.
+            #   Use `{instance} = '-'` to list Clusters for all Instances in a project,
             #   e.g., `projects/myproject/instances/-`.
             # @param page_token [String]
             #   DEPRECATED: This field is unused and ignored.
@@ -936,20 +941,18 @@ module Google
             # Updates a cluster within an instance.
             #
             # @param name [String]
-            #   (`OutputOnly`)
             #   The unique name of the cluster. Values are of the form
-            #   `projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*`.
+            #   `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
             # @param serve_nodes [Integer]
-            #   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
             #   performance, clients should be located as close as possible to this
             #   cluster. Currently only zones are supported, so values should be of the
-            #   form `projects/<project>/locations/<zone>`.
+            #   form `projects/{project}/locations/{zone}`.
             # @param state [Google::Bigtable::Admin::V2::Cluster::State]
-            #   (`OutputOnly`)
             #   The current state of the cluster.
             # @param default_storage_type [Google::Bigtable::Admin::V2::StorageType]
             #   (`CreationOnly`)
@@ -1025,8 +1028,8 @@ module Google
             # Deletes a cluster from an instance.
             #
             # @param name [String]
-            #   The unique name of the cluster to be deleted. Values are of the form
-            #   `projects/<project>/instances/<instance>/clusters/<cluster>`.
+            #   Required. The unique name of the cluster to be deleted. Values are of the form
+            #   `projects/{project}/instances/{instance}/clusters/{cluster}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -1056,15 +1059,15 @@ module Google
             # Creates an app profile within an instance.
             #
             # @param parent [String]
-            #   The unique name of the instance in which to create the new app profile.
+            #   Required. The unique name of the instance in which to create the new app profile.
             #   Values are of the form
-            #   `projects/<project>/instances/<instance>`.
+            #   `projects/{project}/instances/{instance}`.
             # @param app_profile_id [String]
-            #   The ID to be used when referring to the new app profile within its
+            #   Required. The ID to be used when referring to the new app profile within its
             #   instance, e.g., just `myprofile` rather than
             #   `projects/myproject/instances/myinstance/appProfiles/myprofile`.
             # @param app_profile [Google::Bigtable::Admin::V2::AppProfile | Hash]
-            #   The app profile to be created.
+            #   Required. The app profile to be created.
             #   Fields marked `OutputOnly` will be ignored.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::AppProfile`
             #   can also be provided.
@@ -1111,8 +1114,8 @@ module Google
             # Gets information about an app profile.
             #
             # @param name [String]
-            #   The unique name of the requested app profile. Values are of the form
-            #   `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+            #   Required. The unique name of the requested app profile. Values are of the form
+            #   `projects/{project}/instances/{instance}/appProfiles/{app_profile}`.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -1142,14 +1145,21 @@ module Google
             # Lists information about app profiles in an instance.
             #
             # @param parent [String]
-            #   The unique name of the instance for which a list of app profiles is
+            #   Required. The unique name of the instance for which a list of app profiles is
             #   requested. Values are of the form
-            #   `projects/<project>/instances/<instance>`.
-            #   Use `<instance> = '-'` to list AppProfiles for all Instances in a project,
+            #   `projects/{project}/instances/{instance}`.
+            #   Use `{instance} = '-'` to list AppProfiles for all Instances in a project,
             #   e.g., `projects/myproject/instances/-`.
             # @param page_size [Integer]
             #   Maximum number of results per page.
-            #   CURRENTLY UNIMPLEMENTED AND IGNORED.
+            #
+            #   A page_size of zero lets the server choose the number of items to return.
+            #   A page_size which is strictly positive will return at most that many items.
+            #   A negative page_size will cause an error.
+            #
+            #   Following the first request, subsequent paginated calls are not required
+            #   to pass a page_size. If a page_size is set in subsequent calls, it must
+            #   match the page_size given in the first request.
             # @param options [Google::Gax::CallOptions]
             #   Overrides the default settings for this call, e.g, timeout,
             #   retries, etc.
@@ -1197,11 +1207,11 @@ module Google
             # Updates an app profile within an instance.
             #
             # @param app_profile [Google::Bigtable::Admin::V2::AppProfile | Hash]
-            #   The app profile which will (partially) replace the current value.
+            #   Required. The app profile which will (partially) replace the current value.
             #   A hash of the same form as `Google::Bigtable::Admin::V2::AppProfile`
             #   can also be provided.
             # @param update_mask [Google::Protobuf::FieldMask | Hash]
-            #   The subset of app profile fields which should be replaced.
+            #   Required. The subset of app profile fields which should be replaced.
             #   If unset, all fields will be replaced.
             #   A hash of the same form as `Google::Protobuf::FieldMask`
             #   can also be provided.
@@ -1275,8 +1285,8 @@ module Google
             # Deletes an app profile from an instance.
             #
             # @param name [String]
-            #   The unique name of the app profile to be deleted. Values are of the form
-            #   `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+            #   Required. The unique name of the app profile to be deleted. Values are of the form
+            #   `projects/{project}/instances/{instance}/appProfiles/{app_profile}`.
             # @param ignore_warnings [true, false]
             #   If true, ignore safety checks when deleting the app profile.
             # @param options [Google::Gax::CallOptions]