google-cloud-bigtable-admin-v2 0.10.0 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cc00e8dac52b4e098d39e16fe3235c363db3836a5f0baa36ec36c953c2897897
4
- data.tar.gz: d58b5a918e0285546727d221dfdbe4d95ac34f7c23b014ad3a5bdd537719a668
3
+ metadata.gz: 7d56d28882f06606b8aa40fa4455d886e555d1fbddecb36989a86a7686202242
4
+ data.tar.gz: 44e2a56ca140b69c02fee68c6c4fb1225b588052fdcea172b3428f3a41a21558
5
5
  SHA512:
6
- metadata.gz: d704e8ee018d9b7c622d1fc77a083d85ac923ee95b4ec4db327ea442cfc64d31fbe69dfbd1667f78a0bb2ec9dd723623ad54e3a60ada6add141150b28b304f93
7
- data.tar.gz: c53e4b6d5e435f45ea5ff6e3586356c34018d9066cd574052ff3013a681cf27eaca1a85be83922cb6196cea7b9896f56dded447085d2d4cd37651f502bd8f7cf
6
+ metadata.gz: 36e519e516e3266c085dfdf88e3f652d1debf2971bb41ac86db71c4dfa3e315c742cee31ecb77c13054da06c0dd7426e141bacdb2ab055c4a99d14a3ea704840
7
+ data.tar.gz: 38f3e5664b12b8d26caa2d203a17cd8e9527b12dbcc98b49b9c546b65fddcb126500f2f090106937ae73afdb381c1f622625dbc181c78d9a136cb0a338bc944b
data/README.md CHANGED
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -1,6 +1,8 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/admin/v2/bigtable_instance_admin.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/annotations_pb'
5
7
  require 'google/api/client_pb'
6
8
  require 'google/api/field_behavior_pb'
@@ -12,7 +14,6 @@ require 'google/longrunning/operations_pb'
12
14
  require 'google/protobuf/empty_pb'
13
15
  require 'google/protobuf/field_mask_pb'
14
16
  require 'google/protobuf/timestamp_pb'
15
- require 'google/protobuf'
16
17
 
17
18
  Google::Protobuf::DescriptorPool.generated_pool.build do
18
19
  add_file("google/bigtable/admin/v2/bigtable_instance_admin.proto", :syntax => :proto3) do
@@ -75,6 +76,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
75
76
  optional :original_request, :message, 1, "google.bigtable.admin.v2.CreateClusterRequest"
76
77
  optional :request_time, :message, 2, "google.protobuf.Timestamp"
77
78
  optional :finish_time, :message, 3, "google.protobuf.Timestamp"
79
+ map :tables, :string, :message, 4, "google.bigtable.admin.v2.CreateClusterMetadata.TableProgress"
80
+ end
81
+ add_message "google.bigtable.admin.v2.CreateClusterMetadata.TableProgress" do
82
+ optional :estimated_size_bytes, :int64, 2
83
+ optional :estimated_copied_bytes, :int64, 3
84
+ optional :state, :enum, 4, "google.bigtable.admin.v2.CreateClusterMetadata.TableProgress.State"
85
+ end
86
+ add_enum "google.bigtable.admin.v2.CreateClusterMetadata.TableProgress.State" do
87
+ value :STATE_UNSPECIFIED, 0
88
+ value :PENDING, 1
89
+ value :COPYING, 2
90
+ value :COMPLETED, 3
91
+ value :CANCELLED, 4
78
92
  end
79
93
  add_message "google.bigtable.admin.v2.UpdateClusterMetadata" do
80
94
  optional :original_request, :message, 1, "google.bigtable.admin.v2.Cluster"
@@ -153,6 +167,8 @@ module Google
153
167
  CreateInstanceMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateInstanceMetadata").msgclass
154
168
  UpdateInstanceMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UpdateInstanceMetadata").msgclass
155
169
  CreateClusterMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateClusterMetadata").msgclass
170
+ CreateClusterMetadata::TableProgress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateClusterMetadata.TableProgress").msgclass
171
+ CreateClusterMetadata::TableProgress::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.CreateClusterMetadata.TableProgress.State").enummodule
156
172
  UpdateClusterMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UpdateClusterMetadata").msgclass
157
173
  PartialUpdateClusterMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.PartialUpdateClusterMetadata").msgclass
158
174
  PartialUpdateClusterRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.PartialUpdateClusterRequest").msgclass
@@ -1,6 +1,8 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/admin/v2/bigtable_table_admin.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/annotations_pb'
5
7
  require 'google/api/client_pb'
6
8
  require 'google/api/field_behavior_pb'
@@ -14,7 +16,6 @@ require 'google/protobuf/duration_pb'
14
16
  require 'google/protobuf/empty_pb'
15
17
  require 'google/protobuf/field_mask_pb'
16
18
  require 'google/protobuf/timestamp_pb'
17
- require 'google/protobuf'
18
19
 
19
20
  Google::Protobuf::DescriptorPool.generated_pool.build do
20
21
  add_file("google/bigtable/admin/v2/bigtable_table_admin.proto", :syntax => :proto3) do
@@ -76,6 +77,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
76
77
  add_message "google.bigtable.admin.v2.DeleteTableRequest" do
77
78
  optional :name, :string, 1
78
79
  end
80
+ add_message "google.bigtable.admin.v2.UndeleteTableRequest" do
81
+ optional :name, :string, 1
82
+ end
83
+ add_message "google.bigtable.admin.v2.UndeleteTableMetadata" do
84
+ optional :name, :string, 1
85
+ optional :start_time, :message, 2, "google.protobuf.Timestamp"
86
+ optional :end_time, :message, 3, "google.protobuf.Timestamp"
87
+ end
79
88
  add_message "google.bigtable.admin.v2.ModifyColumnFamiliesRequest" do
80
89
  optional :name, :string, 1
81
90
  repeated :modifications, :message, 2, "google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification"
@@ -184,6 +193,8 @@ module Google
184
193
  ListTablesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ListTablesResponse").msgclass
185
194
  GetTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.GetTableRequest").msgclass
186
195
  DeleteTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.DeleteTableRequest").msgclass
196
+ UndeleteTableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UndeleteTableRequest").msgclass
197
+ UndeleteTableMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.UndeleteTableMetadata").msgclass
187
198
  ModifyColumnFamiliesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ModifyColumnFamiliesRequest").msgclass
188
199
  ModifyColumnFamiliesRequest::Modification = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification").msgclass
189
200
  GenerateConsistencyTokenRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.bigtable.admin.v2.GenerateConsistencyTokenRequest").msgclass
@@ -57,6 +57,8 @@ module Google
57
57
  rpc :GetTable, ::Google::Cloud::Bigtable::Admin::V2::GetTableRequest, ::Google::Cloud::Bigtable::Admin::V2::Table
58
58
  # Permanently deletes a specified table and all of its data.
59
59
  rpc :DeleteTable, ::Google::Cloud::Bigtable::Admin::V2::DeleteTableRequest, ::Google::Protobuf::Empty
60
+ # Restores a specified table which was accidentally deleted.
61
+ rpc :UndeleteTable, ::Google::Cloud::Bigtable::Admin::V2::UndeleteTableRequest, ::Google::Longrunning::Operation
60
62
  # Performs a series of column family modifications on the specified table.
61
63
  # Either all or none of the modifications will occur before this method
62
64
  # returns, but data requests received prior to that point may see a table
@@ -1,10 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/admin/v2/common.proto
3
3
 
4
- require 'google/protobuf/timestamp_pb'
5
- require 'google/api/annotations_pb'
6
4
  require 'google/protobuf'
7
5
 
6
+ require 'google/protobuf/timestamp_pb'
7
+
8
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
9
  add_file("google/bigtable/admin/v2/common.proto", :syntax => :proto3) do
10
10
  add_message "google.bigtable.admin.v2.OperationProgress" do
@@ -1,12 +1,12 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/admin/v2/instance.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/field_behavior_pb'
5
7
  require 'google/api/resource_pb'
6
8
  require 'google/bigtable/admin/v2/common_pb'
7
9
  require 'google/protobuf/timestamp_pb'
8
- require 'google/api/annotations_pb'
9
- require 'google/protobuf'
10
10
 
11
11
  Google::Protobuf::DescriptorPool.generated_pool.build do
12
12
  add_file("google/bigtable/admin/v2/instance.proto", :syntax => :proto3) do
@@ -30,6 +30,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
30
30
  end
31
31
  add_message "google.bigtable.admin.v2.AutoscalingTargets" do
32
32
  optional :cpu_utilization_percent, :int32, 2
33
+ optional :storage_utilization_gib_per_node, :int32, 3
33
34
  end
34
35
  add_message "google.bigtable.admin.v2.AutoscalingLimits" do
35
36
  optional :min_serve_nodes, :int32, 1
@@ -1,12 +1,13 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/bigtable/admin/v2/table.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/field_behavior_pb'
5
7
  require 'google/api/resource_pb'
6
8
  require 'google/protobuf/duration_pb'
7
9
  require 'google/protobuf/timestamp_pb'
8
10
  require 'google/rpc/status_pb'
9
- require 'google/protobuf'
10
11
 
11
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
12
13
  add_file("google/bigtable/admin/v2/table.proto", :syntax => :proto3) do
@@ -108,11 +108,6 @@ module Google
108
108
  initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [14, 4]
109
109
  }
110
110
 
111
- default_config.rpcs.partial_update_cluster.timeout = 60.0
112
- default_config.rpcs.partial_update_cluster.retry_policy = {
113
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [14, 4]
114
- }
115
-
116
111
  default_config.rpcs.delete_cluster.timeout = 60.0
117
112
 
118
113
  default_config.rpcs.create_app_profile.timeout = 60.0
@@ -546,11 +541,14 @@ module Google
546
541
  # @param options [::Gapic::CallOptions, ::Hash]
547
542
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
548
543
  #
549
- # @overload update_instance(display_name: nil, state: nil, type: nil, labels: nil)
544
+ # @overload update_instance(name: nil, display_name: nil, state: nil, type: nil, labels: nil)
550
545
  # Pass arguments to `update_instance` via keyword arguments. Note that at
551
546
  # least one keyword argument is required. To specify no parameters, or to keep all
552
547
  # the default parameter values, pass an empty Hash as a request object (see above).
553
548
  #
549
+ # @param name [::String]
550
+ # The unique name of the instance. Values are of the form
551
+ # `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
554
552
  # @param display_name [::String]
555
553
  # Required. The descriptive name for this instance as it appears in UIs.
556
554
  # Can be changed at any time, but should be kept globally unique
@@ -1121,14 +1119,16 @@ module Google
1121
1119
  # @param options [::Gapic::CallOptions, ::Hash]
1122
1120
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1123
1121
  #
1124
- # @overload update_cluster(location: nil, serve_nodes: nil, cluster_config: nil, default_storage_type: nil, encryption_config: nil)
1122
+ # @overload update_cluster(name: nil, location: nil, serve_nodes: nil, cluster_config: nil, default_storage_type: nil, encryption_config: nil)
1125
1123
  # Pass arguments to `update_cluster` via keyword arguments. Note that at
1126
1124
  # least one keyword argument is required. To specify no parameters, or to keep all
1127
1125
  # the default parameter values, pass an empty Hash as a request object (see above).
1128
1126
  #
1127
+ # @param name [::String]
1128
+ # The unique name of the cluster. Values are of the form
1129
+ # `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
1129
1130
  # @param location [::String]
1130
- # (`CreationOnly`)
1131
- # The location where this cluster's nodes and storage reside. For best
1131
+ # Immutable. The location where this cluster's nodes and storage reside. For best
1132
1132
  # performance, clients should be located as close as possible to this
1133
1133
  # cluster. Currently only zones are supported, so values should be of the
1134
1134
  # form `projects/{project}/locations/{zone}`.
@@ -1138,8 +1138,7 @@ module Google
1138
1138
  # @param cluster_config [::Google::Cloud::Bigtable::Admin::V2::Cluster::ClusterConfig, ::Hash]
1139
1139
  # Configuration for this cluster.
1140
1140
  # @param default_storage_type [::Google::Cloud::Bigtable::Admin::V2::StorageType]
1141
- # (`CreationOnly`)
1142
- # The type of storage used by this cluster to serve its
1141
+ # Immutable. The type of storage used by this cluster to serve its
1143
1142
  # parent instance's tables, unless explicitly overridden.
1144
1143
  # @param encryption_config [::Google::Cloud::Bigtable::Admin::V2::Cluster::EncryptionConfig, ::Hash]
1145
1144
  # Immutable. The encryption configuration for CMEK-protected clusters.
@@ -96,6 +96,9 @@ module Google
96
96
  channel_args: @config.channel_args,
97
97
  interceptors: @config.interceptors
98
98
  )
99
+
100
+ # Used by an LRO wrapper for some methods of this service
101
+ @operations_client = self
99
102
  end
100
103
 
101
104
  # Service calls
@@ -737,6 +737,101 @@ module Google
737
737
  raise ::Google::Cloud::Error.from_error(e)
738
738
  end
739
739
 
740
+ ##
741
+ # Restores a specified table which was accidentally deleted.
742
+ #
743
+ # @overload undelete_table(request, options = nil)
744
+ # Pass arguments to `undelete_table` via a request object, either of type
745
+ # {::Google::Cloud::Bigtable::Admin::V2::UndeleteTableRequest} or an equivalent Hash.
746
+ #
747
+ # @param request [::Google::Cloud::Bigtable::Admin::V2::UndeleteTableRequest, ::Hash]
748
+ # A request object representing the call parameters. Required. To specify no
749
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
750
+ # @param options [::Gapic::CallOptions, ::Hash]
751
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
752
+ #
753
+ # @overload undelete_table(name: nil)
754
+ # Pass arguments to `undelete_table` via keyword arguments. Note that at
755
+ # least one keyword argument is required. To specify no parameters, or to keep all
756
+ # the default parameter values, pass an empty Hash as a request object (see above).
757
+ #
758
+ # @param name [::String]
759
+ # Required. The unique name of the table to be restored.
760
+ # Values are of the form
761
+ # `projects/{project}/instances/{instance}/tables/{table}`.
762
+ #
763
+ # @yield [response, operation] Access the result along with the RPC operation
764
+ # @yieldparam response [::Gapic::Operation]
765
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
766
+ #
767
+ # @return [::Gapic::Operation]
768
+ #
769
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
770
+ #
771
+ # @example Basic example
772
+ # require "google/cloud/bigtable/admin/v2"
773
+ #
774
+ # # Create a client object. The client can be reused for multiple calls.
775
+ # client = Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client.new
776
+ #
777
+ # # Create a request. To set request fields, pass in keyword arguments.
778
+ # request = Google::Cloud::Bigtable::Admin::V2::UndeleteTableRequest.new
779
+ #
780
+ # # Call the undelete_table method.
781
+ # result = client.undelete_table request
782
+ #
783
+ # # The returned object is of type Gapic::Operation. You can use this
784
+ # # object to check the status of an operation, cancel it, or wait
785
+ # # for results. Here is how to block until completion:
786
+ # result.wait_until_done! timeout: 60
787
+ # if result.response?
788
+ # p result.response
789
+ # else
790
+ # puts "Error!"
791
+ # end
792
+ #
793
+ def undelete_table request, options = nil
794
+ raise ::ArgumentError, "request must be provided" if request.nil?
795
+
796
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Bigtable::Admin::V2::UndeleteTableRequest
797
+
798
+ # Converts hash and nil to an options object
799
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
800
+
801
+ # Customize the options with defaults
802
+ metadata = @config.rpcs.undelete_table.metadata.to_h
803
+
804
+ # Set x-goog-api-client and x-goog-user-project headers
805
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
806
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
807
+ gapic_version: ::Google::Cloud::Bigtable::Admin::V2::VERSION
808
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
809
+
810
+ header_params = {}
811
+ if request.name
812
+ header_params["name"] = request.name
813
+ end
814
+
815
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
816
+ metadata[:"x-goog-request-params"] ||= request_params_header
817
+
818
+ options.apply_defaults timeout: @config.rpcs.undelete_table.timeout,
819
+ metadata: metadata,
820
+ retry_policy: @config.rpcs.undelete_table.retry_policy
821
+
822
+ options.apply_defaults timeout: @config.timeout,
823
+ metadata: @config.metadata,
824
+ retry_policy: @config.retry_policy
825
+
826
+ @bigtable_table_admin_stub.call_rpc :undelete_table, request, options: options do |response, operation|
827
+ response = ::Gapic::Operation.new response, @operations_client, options: options
828
+ yield response, operation if block_given?
829
+ return response
830
+ end
831
+ rescue ::GRPC::BadStatus => e
832
+ raise ::Google::Cloud::Error.from_error(e)
833
+ end
834
+
740
835
  ##
741
836
  # Performs a series of column family modifications on the specified table.
742
837
  # Either all or none of the modifications will occur before this method
@@ -2606,6 +2701,11 @@ module Google
2606
2701
  #
2607
2702
  attr_reader :delete_table
2608
2703
  ##
2704
+ # RPC-specific configuration for `undelete_table`
2705
+ # @return [::Gapic::Config::Method]
2706
+ #
2707
+ attr_reader :undelete_table
2708
+ ##
2609
2709
  # RPC-specific configuration for `modify_column_families`
2610
2710
  # @return [::Gapic::Config::Method]
2611
2711
  #
@@ -2703,6 +2803,8 @@ module Google
2703
2803
  @get_table = ::Gapic::Config::Method.new get_table_config
2704
2804
  delete_table_config = parent_rpcs.delete_table if parent_rpcs.respond_to? :delete_table
2705
2805
  @delete_table = ::Gapic::Config::Method.new delete_table_config
2806
+ undelete_table_config = parent_rpcs.undelete_table if parent_rpcs.respond_to? :undelete_table
2807
+ @undelete_table = ::Gapic::Config::Method.new undelete_table_config
2706
2808
  modify_column_families_config = parent_rpcs.modify_column_families if parent_rpcs.respond_to? :modify_column_families
2707
2809
  @modify_column_families = ::Gapic::Config::Method.new modify_column_families_config
2708
2810
  drop_row_range_config = parent_rpcs.drop_row_range if parent_rpcs.respond_to? :drop_row_range
@@ -96,6 +96,9 @@ module Google
96
96
  channel_args: @config.channel_args,
97
97
  interceptors: @config.interceptors
98
98
  )
99
+
100
+ # Used by an LRO wrapper for some methods of this service
101
+ @operations_client = self
99
102
  end
100
103
 
101
104
  # Service calls
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigtable
23
23
  module Admin
24
24
  module V2
25
- VERSION = "0.10.0"
25
+ VERSION = "0.13.0"
26
26
  end
27
27
  end
28
28
  end
@@ -237,9 +237,62 @@ module Google
237
237
  # @!attribute [rw] finish_time
238
238
  # @return [::Google::Protobuf::Timestamp]
239
239
  # The time at which the operation failed or was completed successfully.
240
+ # @!attribute [rw] tables
241
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::CreateClusterMetadata::TableProgress}]
242
+ # Keys: the full `name` of each table that existed in the instance when
243
+ # CreateCluster was first called, i.e.
244
+ # `projects/<project>/instances/<instance>/tables/<table>`. Any table added
245
+ # to the instance by a later API call will be created in the new cluster by
246
+ # that API call, not this one.
247
+ #
248
+ # Values: information on how much of a table's data has been copied to the
249
+ # newly-created cluster so far.
240
250
  class CreateClusterMetadata
241
251
  include ::Google::Protobuf::MessageExts
242
252
  extend ::Google::Protobuf::MessageExts::ClassMethods
253
+
254
+ # Progress info for copying a table's data to the new cluster.
255
+ # @!attribute [rw] estimated_size_bytes
256
+ # @return [::Integer]
257
+ # Estimate of the size of the table to be copied.
258
+ # @!attribute [rw] estimated_copied_bytes
259
+ # @return [::Integer]
260
+ # Estimate of the number of bytes copied so far for this table.
261
+ # This will eventually reach 'estimated_size_bytes' unless the table copy
262
+ # is CANCELLED.
263
+ # @!attribute [rw] state
264
+ # @return [::Google::Cloud::Bigtable::Admin::V2::CreateClusterMetadata::TableProgress::State]
265
+ class TableProgress
266
+ include ::Google::Protobuf::MessageExts
267
+ extend ::Google::Protobuf::MessageExts::ClassMethods
268
+
269
+ module State
270
+ STATE_UNSPECIFIED = 0
271
+
272
+ # The table has not yet begun copying to the new cluster.
273
+ PENDING = 1
274
+
275
+ # The table is actively being copied to the new cluster.
276
+ COPYING = 2
277
+
278
+ # The table has been fully copied to the new cluster.
279
+ COMPLETED = 3
280
+
281
+ # The table was deleted before it finished copying to the new cluster.
282
+ # Note that tables deleted after completion will stay marked as
283
+ # COMPLETED, not CANCELLED.
284
+ CANCELLED = 4
285
+ end
286
+ end
287
+
288
+ # @!attribute [rw] key
289
+ # @return [::String]
290
+ # @!attribute [rw] value
291
+ # @return [::Google::Cloud::Bigtable::Admin::V2::CreateClusterMetadata::TableProgress]
292
+ class TablesEntry
293
+ include ::Google::Protobuf::MessageExts
294
+ extend ::Google::Protobuf::MessageExts::ClassMethods
295
+ end
243
296
  end
244
297
 
245
298
  # The metadata for the Operation returned by UpdateCluster.
@@ -252,6 +252,34 @@ module Google
252
252
  extend ::Google::Protobuf::MessageExts::ClassMethods
253
253
  end
254
254
 
255
+ # Request message for
256
+ # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#undelete_table google.bigtable.admin.v2.BigtableTableAdmin.UndeleteTable}
257
+ # @!attribute [rw] name
258
+ # @return [::String]
259
+ # Required. The unique name of the table to be restored.
260
+ # Values are of the form
261
+ # `projects/{project}/instances/{instance}/tables/{table}`.
262
+ class UndeleteTableRequest
263
+ include ::Google::Protobuf::MessageExts
264
+ extend ::Google::Protobuf::MessageExts::ClassMethods
265
+ end
266
+
267
+ # Metadata type for the operation returned by
268
+ # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#undelete_table google.bigtable.admin.v2.BigtableTableAdmin.UndeleteTable}.
269
+ # @!attribute [rw] name
270
+ # @return [::String]
271
+ # The name of the table being restored.
272
+ # @!attribute [rw] start_time
273
+ # @return [::Google::Protobuf::Timestamp]
274
+ # The time at which this operation started.
275
+ # @!attribute [rw] end_time
276
+ # @return [::Google::Protobuf::Timestamp]
277
+ # If set, the time at which this operation finished or was cancelled.
278
+ class UndeleteTableMetadata
279
+ include ::Google::Protobuf::MessageExts
280
+ extend ::Google::Protobuf::MessageExts::ClassMethods
281
+ end
282
+
255
283
  # Request message for
256
284
  # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#modify_column_families google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies}
257
285
  # @!attribute [rw] name
@@ -26,7 +26,7 @@ module Google
26
26
  # the resources that serve them.
27
27
  # All tables in an instance are served from all
28
28
  # {::Google::Cloud::Bigtable::Admin::V2::Cluster Clusters} in the instance.
29
- # @!attribute [r] name
29
+ # @!attribute [rw] name
30
30
  # @return [::String]
31
31
  # The unique name of the instance. Values are of the form
32
32
  # `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
@@ -98,13 +98,8 @@ module Google
98
98
  # on the cluster.
99
99
  PRODUCTION = 1
100
100
 
101
- # The instance is meant for development and testing purposes only; it has
102
- # no performance or uptime guarantees and is not covered by SLA.
103
- # After a development instance is created, it can be upgraded by
104
- # updating the instance to type `PRODUCTION`. An instance created
105
- # as a production instance cannot be changed to a development instance.
106
- # When creating a development instance, `serve_nodes` on the cluster must
107
- # not be set.
101
+ # DEPRECATED: Prefer PRODUCTION for all use cases, as it no longer enforces
102
+ # a higher minimum node count than DEVELOPMENT.
108
103
  DEVELOPMENT = 2
109
104
  end
110
105
  end
@@ -116,6 +111,14 @@ module Google
116
111
  # This number is on a scale from 0 (no utilization) to
117
112
  # 100 (total utilization), and is limited between 10 and 80, otherwise it
118
113
  # will return INVALID_ARGUMENT error.
114
+ # @!attribute [rw] storage_utilization_gib_per_node
115
+ # @return [::Integer]
116
+ # The storage utilization that the Autoscaler should be trying to achieve.
117
+ # This number is limited between 2560 (2.5TiB) and 5120 (5TiB) for a SSD
118
+ # cluster and between 8192 (8TiB) and 16384 (16TiB) for an HDD cluster;
119
+ # otherwise it will return INVALID_ARGUMENT error. If this value is set to 0,
120
+ # it will be treated as if it were set to the default value: 2560 for SSD,
121
+ # 8192 for HDD.
119
122
  class AutoscalingTargets
120
123
  include ::Google::Protobuf::MessageExts
121
124
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -136,20 +139,19 @@ module Google
136
139
  # A resizable group of nodes in a particular cloud location, capable
137
140
  # of serving all {::Google::Cloud::Bigtable::Admin::V2::Table Tables} in the parent
138
141
  # {::Google::Cloud::Bigtable::Admin::V2::Instance Instance}.
139
- # @!attribute [r] name
142
+ # @!attribute [rw] name
140
143
  # @return [::String]
141
144
  # The unique name of the cluster. Values are of the form
142
145
  # `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`.
143
146
  # @!attribute [rw] location
144
147
  # @return [::String]
145
- # (`CreationOnly`)
146
- # The location where this cluster's nodes and storage reside. For best
148
+ # Immutable. The location where this cluster's nodes and storage reside. For best
147
149
  # performance, clients should be located as close as possible to this
148
150
  # cluster. Currently only zones are supported, so values should be of the
149
151
  # form `projects/{project}/locations/{zone}`.
150
152
  # @!attribute [r] state
151
153
  # @return [::Google::Cloud::Bigtable::Admin::V2::Cluster::State]
152
- # The current state of the cluster.
154
+ # Output only. The current state of the cluster.
153
155
  # @!attribute [rw] serve_nodes
154
156
  # @return [::Integer]
155
157
  # The number of nodes allocated to this cluster. More nodes enable higher
@@ -159,8 +161,7 @@ module Google
159
161
  # Configuration for this cluster.
160
162
  # @!attribute [rw] default_storage_type
161
163
  # @return [::Google::Cloud::Bigtable::Admin::V2::StorageType]
162
- # (`CreationOnly`)
163
- # The type of storage used by this cluster to serve its
164
+ # Immutable. The type of storage used by this cluster to serve its
164
165
  # parent instance's tables, unless explicitly overridden.
165
166
  # @!attribute [rw] encryption_config
166
167
  # @return [::Google::Cloud::Bigtable::Admin::V2::Cluster::EncryptionConfig]
@@ -201,6 +202,9 @@ module Google
201
202
  # `cloudkms.cryptoKeyEncrypterDecrypter` role on the CMEK key.
202
203
  # 2) Only regional keys can be used and the region of the CMEK key must
203
204
  # match the region of the cluster.
205
+ # 3) All clusters within an instance must use the same CMEK key.
206
+ # Values are of the form
207
+ # `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}`
204
208
  class EncryptionConfig
205
209
  include ::Google::Protobuf::MessageExts
206
210
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -236,7 +240,6 @@ module Google
236
240
  # from a particular end user application.
237
241
  # @!attribute [rw] name
238
242
  # @return [::String]
239
- # (`OutputOnly`)
240
243
  # The unique name of the app profile. Values are of the form
241
244
  # `projects/{project}/instances/{instance}/appProfiles/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
242
245
  # @!attribute [rw] etag
@@ -251,7 +254,7 @@ module Google
251
254
  # details.
252
255
  # @!attribute [rw] description
253
256
  # @return [::String]
254
- # Optional long form description of the use case for this AppProfile.
257
+ # Long form description of the use case for this AppProfile.
255
258
  # @!attribute [rw] multi_cluster_routing_use_any
256
259
  # @return [::Google::Cloud::Bigtable::Admin::V2::AppProfile::MultiClusterRoutingUseAny]
257
260
  # Use a multi-cluster routing policy.
@@ -42,7 +42,7 @@ module Google
42
42
  # The unique name of the table. Values are of the form
43
43
  # `projects/{project}/instances/{instance}/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
44
44
  # Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `FULL`
45
- # @!attribute [rw] cluster_states
45
+ # @!attribute [r] cluster_states
46
46
  # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::Table::ClusterState}]
47
47
  # Output only. Map from cluster ID to per-cluster table state.
48
48
  # If it could not be determined whether or not the table has data in a
@@ -51,26 +51,24 @@ module Google
51
51
  # Views: `REPLICATION_VIEW`, `ENCRYPTION_VIEW`, `FULL`
52
52
  # @!attribute [rw] column_families
53
53
  # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Bigtable::Admin::V2::ColumnFamily}]
54
- # (`CreationOnly`)
55
54
  # The column families configured for this table, mapped by column family ID.
56
55
  # Views: `SCHEMA_VIEW`, `FULL`
57
56
  # @!attribute [rw] granularity
58
57
  # @return [::Google::Cloud::Bigtable::Admin::V2::Table::TimestampGranularity]
59
- # (`CreationOnly`)
60
- # The granularity (i.e. `MILLIS`) at which timestamps are stored in
61
- # this table. Timestamps not matching the granularity will be rejected.
58
+ # Immutable. The granularity (i.e. `MILLIS`) at which timestamps are stored in this
59
+ # table. Timestamps not matching the granularity will be rejected.
62
60
  # If unspecified at creation time, the value will be set to `MILLIS`.
63
61
  # Views: `SCHEMA_VIEW`, `FULL`.
64
- # @!attribute [rw] restore_info
62
+ # @!attribute [r] restore_info
65
63
  # @return [::Google::Cloud::Bigtable::Admin::V2::RestoreInfo]
66
- # Output only. If this table was restored from another data source (e.g. a
67
- # backup), this field will be populated with information about the restore.
64
+ # Output only. If this table was restored from another data source (e.g. a backup), this
65
+ # field will be populated with information about the restore.
68
66
  class Table
69
67
  include ::Google::Protobuf::MessageExts
70
68
  extend ::Google::Protobuf::MessageExts::ClassMethods
71
69
 
72
70
  # The state of a table's data in a particular cluster.
73
- # @!attribute [rw] replication_state
71
+ # @!attribute [r] replication_state
74
72
  # @return [::Google::Cloud::Bigtable::Admin::V2::Table::ClusterState::ReplicationState]
75
73
  # Output only. The state of replication for the table in this cluster.
76
74
  # @!attribute [r] encryption_info
@@ -158,7 +156,7 @@ module Google
158
156
  # state.
159
157
  REPLICATION_VIEW = 3
160
158
 
161
- # Only populates 'name' and fields related to the table's encryption state.
159
+ # Only populates `name` and fields related to the table's encryption state.
162
160
  ENCRYPTION_VIEW = 5
163
161
 
164
162
  # Populates all fields.
@@ -227,13 +225,12 @@ module Google
227
225
  # Output only. The type of encryption used to protect this resource.
228
226
  # @!attribute [r] encryption_status
229
227
  # @return [::Google::Rpc::Status]
230
- # Output only. The status of encrypt/decrypt calls on underlying data for
231
- # this resource. Regardless of status, the existing data is always encrypted
232
- # at rest.
228
+ # Output only. The status of encrypt/decrypt calls on underlying data for this resource.
229
+ # Regardless of status, the existing data is always encrypted at rest.
233
230
  # @!attribute [r] kms_key_version
234
231
  # @return [::String]
235
- # Output only. The version of the Cloud KMS key specified in the parent
236
- # cluster that is in use for the data underlying this table.
232
+ # Output only. The version of the Cloud KMS key specified in the parent cluster that is
233
+ # in use for the data underlying this table.
237
234
  class EncryptionInfo
238
235
  include ::Google::Protobuf::MessageExts
239
236
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -314,9 +311,9 @@ module Google
314
311
  end
315
312
 
316
313
  # A backup of a Cloud Bigtable table.
317
- # @!attribute [r] name
314
+ # @!attribute [rw] name
318
315
  # @return [::String]
319
- # Output only. A globally unique identifier for the backup which cannot be
316
+ # A globally unique identifier for the backup which cannot be
320
317
  # changed. Values are of the form
321
318
  # `projects/{project}/instances/{instance}/clusters/{cluster}/
322
319
  # backups/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
@@ -328,8 +325,8 @@ module Google
328
325
  # `projects/{project}/instances/{instance}/clusters/{cluster}`.
329
326
  # @!attribute [rw] source_table
330
327
  # @return [::String]
331
- # Required. Immutable. Name of the table from which this backup was created.
332
- # This needs to be in the same instance as the backup. Values are of the form
328
+ # Required. Immutable. Name of the table from which this backup was created. This needs
329
+ # to be in the same instance as the backup. Values are of the form
333
330
  # `projects/{project}/instances/{instance}/tables/{source_table}`.
334
331
  # @!attribute [rw] expire_time
335
332
  # @return [::Google::Protobuf::Timestamp]
@@ -342,9 +339,8 @@ module Google
342
339
  # @return [::Google::Protobuf::Timestamp]
343
340
  # Output only. `start_time` is the time that the backup was started
344
341
  # (i.e. approximately the time the
345
- # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#create_backup CreateBackup}
346
- # request is received). The row data in this backup will be no older than
347
- # this timestamp.
342
+ # {::Google::Cloud::Bigtable::Admin::V2::BigtableTableAdmin::Client#create_backup CreateBackup} request is received). The
343
+ # row data in this backup will be no older than this timestamp.
348
344
  # @!attribute [r] end_time
349
345
  # @return [::Google::Protobuf::Timestamp]
350
346
  # Output only. `end_time` is the time that the backup was finished. The row
@@ -44,7 +44,7 @@ module Google
44
44
  # foo = any.unpack(Foo.class);
45
45
  # }
46
46
  #
47
- # Example 3: Pack and unpack a message in Python.
47
+ # Example 3: Pack and unpack a message in Python.
48
48
  #
49
49
  # foo = Foo(...)
50
50
  # any = Any()
@@ -54,7 +54,7 @@ module Google
54
54
  # any.Unpack(foo)
55
55
  # ...
56
56
  #
57
- # Example 4: Pack and unpack a message in Go
57
+ # Example 4: Pack and unpack a message in Go
58
58
  #
59
59
  # foo := &pb.Foo{...}
60
60
  # any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
75
75
  #
76
76
  #
77
77
  # JSON
78
- # ====
78
+ #
79
79
  # The JSON representation of an `Any` value uses the regular
80
80
  # representation of the deserialized, embedded message, with an
81
81
  # additional field `@type` which contains the type URL. Example:
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigtable-admin-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.10.0
4
+ version: 0.13.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-04-20 00:00:00.000000000 Z
11
+ date: 2022-07-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.7'
19
+ version: '0.10'
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.7'
29
+ version: '0.10'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -64,28 +64,28 @@ dependencies:
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: 1.25.1
67
+ version: 1.26.1
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: 1.25.1
74
+ version: 1.26.1
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest
77
77
  requirement: !ruby/object:Gem::Requirement
78
78
  requirements:
79
79
  - - "~>"
80
80
  - !ruby/object:Gem::Version
81
- version: '5.14'
81
+ version: '5.16'
82
82
  type: :development
83
83
  prerelease: false
84
84
  version_requirements: !ruby/object:Gem::Requirement
85
85
  requirements:
86
86
  - - "~>"
87
87
  - !ruby/object:Gem::Version
88
- version: '5.14'
88
+ version: '5.16'
89
89
  - !ruby/object:Gem::Dependency
90
90
  name: minitest-focus
91
91
  requirement: !ruby/object:Gem::Requirement
@@ -120,14 +120,14 @@ dependencies:
120
120
  requirements:
121
121
  - - ">="
122
122
  - !ruby/object:Gem::Version
123
- version: '12.0'
123
+ version: '13.0'
124
124
  type: :development
125
125
  prerelease: false
126
126
  version_requirements: !ruby/object:Gem::Requirement
127
127
  requirements:
128
128
  - - ">="
129
129
  - !ruby/object:Gem::Version
130
- version: '12.0'
130
+ version: '13.0'
131
131
  - !ruby/object:Gem::Dependency
132
132
  name: redcarpet
133
133
  requirement: !ruby/object:Gem::Requirement
@@ -234,14 +234,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
234
234
  requirements:
235
235
  - - ">="
236
236
  - !ruby/object:Gem::Version
237
- version: '2.5'
237
+ version: '2.6'
238
238
  required_rubygems_version: !ruby/object:Gem::Requirement
239
239
  requirements:
240
240
  - - ">="
241
241
  - !ruby/object:Gem::Version
242
242
  version: '0'
243
243
  requirements: []
244
- rubygems_version: 3.3.5
244
+ rubygems_version: 3.3.14
245
245
  signing_key:
246
246
  specification_version: 4
247
247
  summary: API Client library for the Cloud Bigtable Admin V2 API