google-cloud-bigtable-admin-v2 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a3abbab8f6a6e56ea4cfb915519ec818dbf60e10e6c273a3a5621e4e580bf3c
-  data.tar.gz: 2189b855c266d5d438a0adb943bd925f792f08ee26b498d30611d0c1473d898c
+  metadata.gz: 5a36854ab75416bb8d7df4c625f9238b0bd3a9a127d10ae5921ba92bfe5cb642
+  data.tar.gz: f0407632dd39f28dfaf66c11171c449f8945a28abc96d7a2c5edd721ce303436
 SHA512:
-  metadata.gz: 590ce05de6889e1fe9f964d2f900721252ccb95cea4322a012a183f1a0dd76215ce3c9c1ac7e975b60b987b072ee34e358e3bc1d91239efaf22e2a1370207c5e
-  data.tar.gz: b67a31318f5909a087da70d85862ee0a694d401a8503f816ae5e90c960bc0cb2884ca17f547703fa3a8c9ece425f0f485cb5c8b5d1350543eac612d19bd4dca2
+  metadata.gz: 688686323173b62dbbe9ac1d7f1825207e0a51a9427107f59255f7697c84a4203ea30c53f91d3a45b54e4d0cc335fa26f31cc3a3490d7090de1afa0ea801f4c4
+  data.tar.gz: 46816272421278ad199192cc3ddb4c120fe55e281357aec3b335cd987c69741fa38c1e1ac3cdf601f25d76844f7473319e5af3a8f0b4226f00049c21fa8a89dc

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

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

@@ -74,6 +74,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :view, :enum, 2, "google.bigtable.admin.v2.Table.View"
     end
+    add_message "google.bigtable.admin.v2.UpdateTableRequest" do
+      optional :table, :message, 1, "google.bigtable.admin.v2.Table"
+      optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+    end
+    add_message "google.bigtable.admin.v2.UpdateTableMetadata" do
+      optional :name, :string, 1
+      optional :start_time, :message, 2, "google.protobuf.Timestamp"
+      optional :end_time, :message, 3, "google.protobuf.Timestamp"
+    end
     add_message "google.bigtable.admin.v2.DeleteTableRequest" do
       optional :name, :string, 1
     end
@@ -192,6 +201,8 @@ module Google
           ListTablesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ListTablesRequest").msgclass
           ListTablesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ListTablesResponse").msgclass
           GetTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.GetTableRequest").msgclass
+          UpdateTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UpdateTableRequest").msgclass
+          UpdateTableMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UpdateTableMetadata").msgclass
           DeleteTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.DeleteTableRequest").msgclass
           UndeleteTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UndeleteTableRequest").msgclass
           UndeleteTableMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UndeleteTableMetadata").msgclass

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

@@ -55,6 +55,8 @@ module Google
               rpc :ListTables, ::Google::Cloud::Bigtable::Admin::V2::ListTablesRequest, ::Google::Cloud::Bigtable::Admin::V2::ListTablesResponse
               # Gets metadata information about the specified table.
               rpc :GetTable, ::Google::Cloud::Bigtable::Admin::V2::GetTableRequest, ::Google::Cloud::Bigtable::Admin::V2::Table
+              # Updates a specified table.
+              rpc :UpdateTable, ::Google::Cloud::Bigtable::Admin::V2::UpdateTableRequest, ::Google::Longrunning::Operation
               # Permanently deletes a specified table and all of its data.
               rpc :DeleteTable, ::Google::Cloud::Bigtable::Admin::V2::DeleteTableRequest, ::Google::Protobuf::Empty
               # Restores a specified table which was accidentally deleted.

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

@@ -23,6 +23,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      optional :deletion_protection, :bool, 9
     end
     add_message "google.bigtable.admin.v2.Table.ClusterState" do
       optional :replication_state, :enum, 1, "google.bigtable.admin.v2.Table.ClusterState.ReplicationState"

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

@@ -650,6 +650,111 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Updates a specified table.
+              #
+              # @overload update_table(request, options = nil)
+              #   Pass arguments to `update_table` via a request object, either of type
+              #   {::Google::Cloud::Bigtable::Admin::V2::UpdateTableRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Bigtable::Admin::V2::UpdateTableRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @overload update_table(table: nil, update_mask: nil)
+              #   Pass arguments to `update_table` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param table [::Google::Cloud::Bigtable::Admin::V2::Table, ::Hash]
+              #     Required. The table to update.
+              #     The table's `name` field is used to identify the table to update.
+              #     Format:
+              #     `projects/{project}/instances/{instance}/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
+              #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+              #     Required. The list of fields to update.
+              #     A mask specifying which fields (e.g. `deletion_protection`) in the `table`
+              #     field should be updated. This mask is relative to the `table` field, not to
+              #     the request message. The wildcard (*) path is currently not supported.
+              #     Currently UpdateTable is only supported for the following field:
+              #      * `deletion_protection`
+              #     If `column_families` is set in `update_mask`, it will return an
+              #     UNIMPLEMENTED error.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Gapic::Operation]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/bigtable/admin/v2"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigtable::Admin::V2::UpdateTableRequest.new
+              #
+              #   # Call the update_table method.
+              #   result = client.update_table request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use this
+              #   # object to check the status of an operation, cancel it, or wait
+              #   # for results. Here is how to block until completion:
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "Error!"
+              #   end
+              #
+              def update_table request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Bigtable::Admin::V2::UpdateTableRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.update_table.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::Bigtable::Admin::V2::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {}
+                if request.table&.name
+                  header_params["table.name"] = request.table.name
+                end
+
+                request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                metadata[:"x-goog-request-params"] ||= request_params_header
+
+                options.apply_defaults timeout:      @config.rpcs.update_table.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.update_table.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @bigtable_table_admin_stub.call_rpc :update_table, request, options: options do |response, operation|
+                  response = ::Gapic::Operation.new response, @operations_client, options: options
+                  yield response, operation if block_given?
+                  return response
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Permanently deletes a specified table and all of its data.
               #
@@ -2696,6 +2801,11 @@ module Google
                   #
                   attr_reader :get_table
                   ##
+                  # RPC-specific configuration for `update_table`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :update_table
+                  ##
                   # RPC-specific configuration for `delete_table`
                   # @return [::Gapic::Config::Method]
                   #
@@ -2801,6 +2911,8 @@ module Google
                     @list_tables = ::Gapic::Config::Method.new list_tables_config
                     get_table_config = parent_rpcs.get_table if parent_rpcs.respond_to? :get_table
                     @get_table = ::Gapic::Config::Method.new get_table_config
+                    update_table_config = parent_rpcs.update_table if parent_rpcs.respond_to? :update_table
+                    @update_table = ::Gapic::Config::Method.new update_table_config
                     delete_table_config = parent_rpcs.delete_table if parent_rpcs.respond_to? :delete_table
                     @delete_table = ::Gapic::Config::Method.new delete_table_config
                     undelete_table_config = parent_rpcs.undelete_table if parent_rpcs.respond_to? :undelete_table

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

@@ -22,7 +22,7 @@ module Google
     module Bigtable
       module Admin
         module V2
-          VERSION = "0.14.0"
+          VERSION = "0.15.0"
         end
       end
     end

data/proto_docs/google/bigtable/admin/v2/bigtable_table_admin.rb

@@ -240,6 +240,45 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The request for
+          # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#update_table UpdateTable}.
+          # @!attribute [rw] table
+          #   @return [::Google::Cloud::Bigtable::Admin::V2::Table]
+          #     Required. The table to update.
+          #     The table's `name` field is used to identify the table to update.
+          #     Format:
+          #     `projects/{project}/instances/{instance}/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
+          # @!attribute [rw] update_mask
+          #   @return [::Google::Protobuf::FieldMask]
+          #     Required. The list of fields to update.
+          #     A mask specifying which fields (e.g. `deletion_protection`) in the `table`
+          #     field should be updated. This mask is relative to the `table` field, not to
+          #     the request message. The wildcard (*) path is currently not supported.
+          #     Currently UpdateTable is only supported for the following field:
+          #      * `deletion_protection`
+          #     If `column_families` is set in `update_mask`, it will return an
+          #     UNIMPLEMENTED error.
+          class UpdateTableRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Metadata type for the operation returned by
+          # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#update_table UpdateTable}.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The name of the table being updated.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time at which this operation started.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     If set, the time at which this operation finished or was canceled.
+          class UpdateTableMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Request message for
           # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#delete_table google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable}
           # @!attribute [rw] name

data/proto_docs/google/bigtable/admin/v2/table.rb

@@ -63,6 +63,14 @@ module Google
           #   @return [::Google::Cloud::Bigtable::Admin::V2::RestoreInfo]
           #     Output only. If this table was restored from another data source (e.g. a backup), this
           #     field will be populated with information about the restore.
+          # @!attribute [rw] deletion_protection
+          #   @return [::Boolean]
+          #     Set to true to make the table protected against data loss. i.e. deleting
+          #     the following resources through Admin APIs are prohibited:
+          #       - The table.
+          #       - The column families in the table.
+          #       - The instance containing the table.
+          #     Note one can still delete the data stored in the table through Data APIs.
           class Table
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigtable-admin-v2
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-28 00:00:00.000000000 Z
+date: 2022-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common