google-cloud-bigtable 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +6 -0
- data/lib/google/bigtable/admin/v2/bigtable_table_admin_pb.rb +64 -0
- data/lib/google/bigtable/admin/v2/bigtable_table_admin_services_pb.rb +28 -2
- data/lib/google/bigtable/admin/v2/common_pb.rb +6 -1
- data/lib/google/bigtable/admin/v2/instance_pb.rb +0 -1
- data/lib/google/bigtable/admin/v2/table_pb.rb +37 -1
- data/lib/google/cloud/bigtable/admin/v2.rb +1 -0
- data/lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client.rb +2 -2
- data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client.rb +502 -25
- data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json +30 -0
- data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_table_admin.rb +244 -24
- data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/instance.rb +2 -2
- data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/table.rb +108 -5
- data/lib/google/cloud/bigtable/v2/bigtable_client_config.json +7 -7
- data/lib/google/cloud/bigtable/version.rb +1 -1
- metadata +4 -4
@@ -126,6 +126,36 @@
|
|
126
126
|
"timeout_millis": 60000,
|
127
127
|
"retry_codes_name": "non_idempotent",
|
128
128
|
"retry_params_name": "non_idempotent_params"
|
129
|
+
},
|
130
|
+
"CreateBackup": {
|
131
|
+
"timeout_millis": 60000,
|
132
|
+
"retry_codes_name": "non_idempotent",
|
133
|
+
"retry_params_name": "non_idempotent_params"
|
134
|
+
},
|
135
|
+
"GetBackup": {
|
136
|
+
"timeout_millis": 60000,
|
137
|
+
"retry_codes_name": "idempotent",
|
138
|
+
"retry_params_name": "idempotent_params"
|
139
|
+
},
|
140
|
+
"ListBackups": {
|
141
|
+
"timeout_millis": 60000,
|
142
|
+
"retry_codes_name": "idempotent",
|
143
|
+
"retry_params_name": "idempotent_params"
|
144
|
+
},
|
145
|
+
"UpdateBackup": {
|
146
|
+
"timeout_millis": 60000,
|
147
|
+
"retry_codes_name": "non_idempotent",
|
148
|
+
"retry_params_name": "non_idempotent_params"
|
149
|
+
},
|
150
|
+
"DeleteBackup": {
|
151
|
+
"timeout_millis": 60000,
|
152
|
+
"retry_codes_name": "non_idempotent",
|
153
|
+
"retry_params_name": "non_idempotent_params"
|
154
|
+
},
|
155
|
+
"RestoreTable": {
|
156
|
+
"timeout_millis": 60000,
|
157
|
+
"retry_codes_name": "non_idempotent",
|
158
|
+
"retry_params_name": "non_idempotent_params"
|
129
159
|
}
|
130
160
|
}
|
131
161
|
}
|
data/lib/google/cloud/bigtable/admin/v2/doc/google/bigtable/admin/v2/bigtable_table_admin.rb
CHANGED
@@ -25,8 +25,8 @@ module Google
|
|
25
25
|
# Values are of the form `projects/{project}/instances/{instance}`.
|
26
26
|
# @!attribute [rw] table_id
|
27
27
|
# @return [String]
|
28
|
-
# Required. The name by which the new table should be referred to within the
|
29
|
-
# instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
|
28
|
+
# Required. The name by which the new table should be referred to within the
|
29
|
+
# parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
|
30
30
|
# Maximum 50 characters.
|
31
31
|
# @!attribute [rw] table
|
32
32
|
# @return [Google::Bigtable::Admin::V2::Table]
|
@@ -70,13 +70,13 @@ module Google
|
|
70
70
|
# Values are of the form `projects/{project}/instances/{instance}`.
|
71
71
|
# @!attribute [rw] table_id
|
72
72
|
# @return [String]
|
73
|
-
# Required. The name by which the new table should be referred to within the
|
74
|
-
# instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
|
73
|
+
# Required. The name by which the new table should be referred to within the
|
74
|
+
# parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`.
|
75
75
|
# @!attribute [rw] source_snapshot
|
76
76
|
# @return [String]
|
77
|
-
# Required. The unique name of the snapshot from which to restore the table.
|
78
|
-
# snapshot and the table must be in the same instance.
|
79
|
-
#
|
77
|
+
# Required. The unique name of the snapshot from which to restore the table.
|
78
|
+
# The snapshot and the table must be in the same instance. Values are of the
|
79
|
+
# form
|
80
80
|
# `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`.
|
81
81
|
class CreateTableFromSnapshotRequest; end
|
82
82
|
|
@@ -100,8 +100,8 @@ module Google
|
|
100
100
|
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::ListTables}
|
101
101
|
# @!attribute [rw] parent
|
102
102
|
# @return [String]
|
103
|
-
# Required. The unique name of the instance for which tables should be
|
104
|
-
# Values are of the form `projects/{project}/instances/{instance}`.
|
103
|
+
# Required. The unique name of the instance for which tables should be
|
104
|
+
# listed. Values are of the form `projects/{project}/instances/{instance}`.
|
105
105
|
# @!attribute [rw] view
|
106
106
|
# @return [Google::Bigtable::Admin::V2::Table::View]
|
107
107
|
# The view to be applied to the returned tables' fields.
|
@@ -165,10 +165,10 @@ module Google
|
|
165
165
|
# `projects/{project}/instances/{instance}/tables/{table}`.
|
166
166
|
# @!attribute [rw] modifications
|
167
167
|
# @return [Array<Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification>]
|
168
|
-
# Required. Modifications to be atomically applied to the specified table's
|
169
|
-
# Entries are applied in order, meaning that earlier modifications
|
170
|
-
# masked by later ones (in the case of repeated updates to the same
|
171
|
-
# for example).
|
168
|
+
# Required. Modifications to be atomically applied to the specified table's
|
169
|
+
# families. Entries are applied in order, meaning that earlier modifications
|
170
|
+
# can be masked by later ones (in the case of repeated updates to the same
|
171
|
+
# family, for example).
|
172
172
|
class ModifyColumnFamiliesRequest
|
173
173
|
# A create, update, or delete of a particular column family.
|
174
174
|
# @!attribute [rw] id
|
@@ -193,8 +193,8 @@ module Google
|
|
193
193
|
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::GenerateConsistencyToken}
|
194
194
|
# @!attribute [rw] name
|
195
195
|
# @return [String]
|
196
|
-
# Required. The unique name of the Table for which to create a consistency
|
197
|
-
# Values are of the form
|
196
|
+
# Required. The unique name of the Table for which to create a consistency
|
197
|
+
# token. Values are of the form
|
198
198
|
# `projects/{project}/instances/{instance}/tables/{table}`.
|
199
199
|
class GenerateConsistencyTokenRequest; end
|
200
200
|
|
@@ -209,8 +209,8 @@ module Google
|
|
209
209
|
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::CheckConsistency}
|
210
210
|
# @!attribute [rw] name
|
211
211
|
# @return [String]
|
212
|
-
# Required. The unique name of the Table for which to check replication
|
213
|
-
# Values are of the form
|
212
|
+
# Required. The unique name of the Table for which to check replication
|
213
|
+
# consistency. Values are of the form
|
214
214
|
# `projects/{project}/instances/{instance}/tables/{table}`.
|
215
215
|
# @!attribute [rw] consistency_token
|
216
216
|
# @return [String]
|
@@ -234,19 +234,19 @@ module Google
|
|
234
234
|
# for production use. It is not subject to any SLA or deprecation policy.
|
235
235
|
# @!attribute [rw] name
|
236
236
|
# @return [String]
|
237
|
-
# The unique name of the table to have the snapshot taken.
|
237
|
+
# Required. The unique name of the table to have the snapshot taken.
|
238
238
|
# Values are of the form
|
239
239
|
# `projects/{project}/instances/{instance}/tables/{table}`.
|
240
240
|
# @!attribute [rw] cluster
|
241
241
|
# @return [String]
|
242
|
-
# The name of the cluster where the snapshot will be created in.
|
242
|
+
# Required. The name of the cluster where the snapshot will be created in.
|
243
243
|
# Values are of the form
|
244
244
|
# `projects/{project}/instances/{instance}/clusters/{cluster}`.
|
245
245
|
# @!attribute [rw] snapshot_id
|
246
246
|
# @return [String]
|
247
|
-
# The ID by which the new snapshot should be referred to within the
|
248
|
-
# cluster, e.g., `mysnapshot` of the form:
|
249
|
-
# rather than
|
247
|
+
# Required. The ID by which the new snapshot should be referred to within the
|
248
|
+
# parent cluster, e.g., `mysnapshot` of the form:
|
249
|
+
# `[_a-zA-Z0-9][-_.a-zA-Z0-9]*` rather than
|
250
250
|
# `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/mysnapshot`.
|
251
251
|
# @!attribute [rw] ttl
|
252
252
|
# @return [Google::Protobuf::Duration]
|
@@ -282,8 +282,8 @@ module Google
|
|
282
282
|
# for production use. It is not subject to any SLA or deprecation policy.
|
283
283
|
# @!attribute [rw] parent
|
284
284
|
# @return [String]
|
285
|
-
# Required. The unique name of the cluster for which snapshots should be
|
286
|
-
# Values are of the form
|
285
|
+
# Required. The unique name of the cluster for which snapshots should be
|
286
|
+
# listed. Values are of the form
|
287
287
|
# `projects/{project}/instances/{instance}/clusters/{cluster}`.
|
288
288
|
# Use `{cluster} = '-'` to list snapshots for all clusters in an instance,
|
289
289
|
# e.g., `projects/{project}/instances/{instance}/clusters/-`.
|
@@ -361,6 +361,226 @@ module Google
|
|
361
361
|
# @return [Google::Protobuf::Timestamp]
|
362
362
|
# The time at which the operation failed or was completed successfully.
|
363
363
|
class CreateTableFromSnapshotMetadata; end
|
364
|
+
|
365
|
+
# The request for
|
366
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::CreateBackup CreateBackup}.
|
367
|
+
# @!attribute [rw] parent
|
368
|
+
# @return [String]
|
369
|
+
# Required. This must be one of the clusters in the instance in which this
|
370
|
+
# table is located. The backup will be stored in this cluster. Values are
|
371
|
+
# of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
|
372
|
+
# @!attribute [rw] backup_id
|
373
|
+
# @return [String]
|
374
|
+
# Required. The id of the backup to be created. The `backup_id` along with
|
375
|
+
# the parent `parent` are combined as \\{parent}/backups/\\{backup_id} to create
|
376
|
+
# the full backup name, of the form:
|
377
|
+
# `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup_id}`.
|
378
|
+
# This string must be between 1 and 50 characters in length and match the
|
379
|
+
# regex [_a-zA-Z0-9][-_.a-zA-Z0-9]*.
|
380
|
+
# @!attribute [rw] backup
|
381
|
+
# @return [Google::Bigtable::Admin::V2::Backup]
|
382
|
+
# Required. The backup to create.
|
383
|
+
class CreateBackupRequest; end
|
384
|
+
|
385
|
+
# Metadata type for the operation returned by
|
386
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::CreateBackup CreateBackup}.
|
387
|
+
# @!attribute [rw] name
|
388
|
+
# @return [String]
|
389
|
+
# The name of the backup being created.
|
390
|
+
# @!attribute [rw] source_table
|
391
|
+
# @return [String]
|
392
|
+
# The name of the table the backup is created from.
|
393
|
+
# @!attribute [rw] start_time
|
394
|
+
# @return [Google::Protobuf::Timestamp]
|
395
|
+
# The time at which this operation started.
|
396
|
+
# @!attribute [rw] end_time
|
397
|
+
# @return [Google::Protobuf::Timestamp]
|
398
|
+
# If set, the time at which this operation finished or was cancelled.
|
399
|
+
class CreateBackupMetadata; end
|
400
|
+
|
401
|
+
# The request for
|
402
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::GetBackup GetBackup}.
|
403
|
+
# @!attribute [rw] name
|
404
|
+
# @return [String]
|
405
|
+
# Required. Name of the backup.
|
406
|
+
# Values are of the form
|
407
|
+
# `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`.
|
408
|
+
class GetBackupRequest; end
|
409
|
+
|
410
|
+
# The request for
|
411
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::UpdateBackup UpdateBackup}.
|
412
|
+
# @!attribute [rw] backup
|
413
|
+
# @return [Google::Bigtable::Admin::V2::Backup]
|
414
|
+
# Required. The backup to update. `backup.name`, and the fields to be updated
|
415
|
+
# as specified by `update_mask` are required. Other fields are ignored.
|
416
|
+
# Update is only supported for the following fields:
|
417
|
+
# * `backup.expire_time`.
|
418
|
+
# @!attribute [rw] update_mask
|
419
|
+
# @return [Google::Protobuf::FieldMask]
|
420
|
+
# Required. A mask specifying which fields (e.g. `expire_time`) in the
|
421
|
+
# Backup resource should be updated. This mask is relative to the Backup
|
422
|
+
# resource, not to the request message. The field mask must always be
|
423
|
+
# specified; this prevents any future fields from being erased accidentally
|
424
|
+
# by clients that do not know about them.
|
425
|
+
class UpdateBackupRequest; end
|
426
|
+
|
427
|
+
# The request for
|
428
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::DeleteBackup DeleteBackup}.
|
429
|
+
# @!attribute [rw] name
|
430
|
+
# @return [String]
|
431
|
+
# Required. Name of the backup to delete.
|
432
|
+
# Values are of the form
|
433
|
+
# `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`.
|
434
|
+
class DeleteBackupRequest; end
|
435
|
+
|
436
|
+
# The request for
|
437
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::ListBackups ListBackups}.
|
438
|
+
# @!attribute [rw] parent
|
439
|
+
# @return [String]
|
440
|
+
# Required. The cluster to list backups from. Values are of the
|
441
|
+
# form `projects/{project}/instances/{instance}/clusters/{cluster}`.
|
442
|
+
# Use `{cluster} = '-'` to list backups for all clusters in an instance,
|
443
|
+
# e.g., `projects/{project}/instances/{instance}/clusters/-`.
|
444
|
+
# @!attribute [rw] filter
|
445
|
+
# @return [String]
|
446
|
+
# A filter expression that filters backups listed in the response.
|
447
|
+
# The expression must specify the field name, a comparison operator,
|
448
|
+
# and the value that you want to use for filtering. The value must be a
|
449
|
+
# string, a number, or a boolean. The comparison operator must be
|
450
|
+
# <, >, <=, >=, !=, =, or :. Colon ‘:’ represents a HAS operator which is
|
451
|
+
# roughly synonymous with equality. Filter rules are case insensitive.
|
452
|
+
#
|
453
|
+
# The fields eligible for filtering are:
|
454
|
+
# * `name`
|
455
|
+
# * `source_table`
|
456
|
+
# * `state`
|
457
|
+
# * `start_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
|
458
|
+
# * `end_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
|
459
|
+
# * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
|
460
|
+
# * `size_bytes`
|
461
|
+
#
|
462
|
+
# To filter on multiple expressions, provide each separate expression within
|
463
|
+
# parentheses. By default, each expression is an AND expression. However,
|
464
|
+
# you can include AND, OR, and NOT expressions explicitly.
|
465
|
+
#
|
466
|
+
# Some examples of using filters are:
|
467
|
+
#
|
468
|
+
# * `name:"exact"` --> The backup's name is the string "exact".
|
469
|
+
# * `name:howl` --> The backup's name contains the string "howl".
|
470
|
+
# * `source_table:prod`
|
471
|
+
# --> The source_table's name contains the string "prod".
|
472
|
+
# * `state:CREATING` --> The backup is pending creation.
|
473
|
+
# * `state:READY` --> The backup is fully created and ready for use.
|
474
|
+
# * `(name:howl) AND (start_time < \"2018-03-28T14:50:00Z\")`
|
475
|
+
# --> The backup name contains the string "howl" and start_time
|
476
|
+
# of the backup is before 2018-03-28T14:50:00Z.
|
477
|
+
# * `size_bytes > 10000000000` --> The backup's size is greater than 10GB
|
478
|
+
# @!attribute [rw] order_by
|
479
|
+
# @return [String]
|
480
|
+
# An expression for specifying the sort order of the results of the request.
|
481
|
+
# The string value should specify one or more fields in
|
482
|
+
# {Google::Bigtable::Admin::V2::Backup Backup}. The full syntax is described at
|
483
|
+
# https://aip.dev/132#ordering.
|
484
|
+
#
|
485
|
+
# Fields supported are:
|
486
|
+
# * name
|
487
|
+
# * source_table
|
488
|
+
# * expire_time
|
489
|
+
# * start_time
|
490
|
+
# * end_time
|
491
|
+
# * size_bytes
|
492
|
+
# * state
|
493
|
+
#
|
494
|
+
# For example, "start_time". The default sorting order is ascending.
|
495
|
+
# To specify descending order for the field, a suffix " desc" should
|
496
|
+
# be appended to the field name. For example, "start_time desc".
|
497
|
+
# Redundant space characters in the syntax are insigificant.
|
498
|
+
#
|
499
|
+
# If order_by is empty, results will be sorted by `start_time` in descending
|
500
|
+
# order starting from the most recently created backup.
|
501
|
+
# @!attribute [rw] page_size
|
502
|
+
# @return [Integer]
|
503
|
+
# Number of backups to be returned in the response. If 0 or
|
504
|
+
# less, defaults to the server's maximum allowed page size.
|
505
|
+
# @!attribute [rw] page_token
|
506
|
+
# @return [String]
|
507
|
+
# If non-empty, `page_token` should contain a
|
508
|
+
# {Google::Bigtable::Admin::V2::ListBackupsResponse#next_page_token next_page_token}
|
509
|
+
# from a previous
|
510
|
+
# {Google::Bigtable::Admin::V2::ListBackupsResponse ListBackupsResponse} to the
|
511
|
+
# same `parent` and with the same `filter`.
|
512
|
+
class ListBackupsRequest; end
|
513
|
+
|
514
|
+
# The response for
|
515
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::ListBackups ListBackups}.
|
516
|
+
# @!attribute [rw] backups
|
517
|
+
# @return [Array<Google::Bigtable::Admin::V2::Backup>]
|
518
|
+
# The list of matching backups.
|
519
|
+
# @!attribute [rw] next_page_token
|
520
|
+
# @return [String]
|
521
|
+
# `next_page_token` can be sent in a subsequent
|
522
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::ListBackups ListBackups} call
|
523
|
+
# to fetch more of the matching backups.
|
524
|
+
class ListBackupsResponse; end
|
525
|
+
|
526
|
+
# The request for
|
527
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::RestoreTable RestoreTable}.
|
528
|
+
# @!attribute [rw] parent
|
529
|
+
# @return [String]
|
530
|
+
# Required. The name of the instance in which to create the restored
|
531
|
+
# table. This instance must be the parent of the source backup. Values are
|
532
|
+
# of the form `projects/<project>/instances/<instance>`.
|
533
|
+
# @!attribute [rw] table_id
|
534
|
+
# @return [String]
|
535
|
+
# Required. The id of the table to create and restore to. This
|
536
|
+
# table must not already exist. The `table_id` appended to
|
537
|
+
# `parent` forms the full table name of the form
|
538
|
+
# `projects/<project>/instances/<instance>/tables/<table_id>`.
|
539
|
+
# @!attribute [rw] backup
|
540
|
+
# @return [String]
|
541
|
+
# Name of the backup from which to restore. Values are of the form
|
542
|
+
# `projects/<project>/instances/<instance>/clusters/<cluster>/backups/<backup>`.
|
543
|
+
class RestoreTableRequest; end
|
544
|
+
|
545
|
+
# Metadata type for the long-running operation returned by
|
546
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::RestoreTable RestoreTable}.
|
547
|
+
# @!attribute [rw] name
|
548
|
+
# @return [String]
|
549
|
+
# Name of the table being created and restored to.
|
550
|
+
# @!attribute [rw] source_type
|
551
|
+
# @return [Google::Bigtable::Admin::V2::RestoreSourceType]
|
552
|
+
# The type of the restore source.
|
553
|
+
# @!attribute [rw] backup_info
|
554
|
+
# @return [Google::Bigtable::Admin::V2::BackupInfo]
|
555
|
+
# @!attribute [rw] optimize_table_operation_name
|
556
|
+
# @return [String]
|
557
|
+
# If exists, the name of the long-running operation that will be used to
|
558
|
+
# track the post-restore optimization process to optimize the performance of
|
559
|
+
# the restored table. The metadata type of the long-running operation is
|
560
|
+
# \\{OptimizeRestoreTableMetadata}. The response type is
|
561
|
+
# {Google::Protobuf::Empty Empty}. This long-running operation may be
|
562
|
+
# automatically created by the system if applicable after the
|
563
|
+
# RestoreTable long-running operation completes successfully. This operation
|
564
|
+
# may not be created if the table is already optimized or the restore was
|
565
|
+
# not successful.
|
566
|
+
# @!attribute [rw] progress
|
567
|
+
# @return [Google::Bigtable::Admin::V2::OperationProgress]
|
568
|
+
# The progress of the
|
569
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::RestoreTable RestoreTable}
|
570
|
+
# operation.
|
571
|
+
class RestoreTableMetadata; end
|
572
|
+
|
573
|
+
# Metadata type for the long-running operation used to track the progress
|
574
|
+
# of optimizations performed on a newly restored table. This long-running
|
575
|
+
# operation is automatically created by the system after the successful
|
576
|
+
# completion of a table restore, and cannot be cancelled.
|
577
|
+
# @!attribute [rw] name
|
578
|
+
# @return [String]
|
579
|
+
# Name of the restored table being optimized.
|
580
|
+
# @!attribute [rw] progress
|
581
|
+
# @return [Google::Bigtable::Admin::V2::OperationProgress]
|
582
|
+
# The progress of the post-restore optimizations.
|
583
|
+
class OptimizeRestoredTableMetadata; end
|
364
584
|
end
|
365
585
|
end
|
366
586
|
end
|
@@ -106,8 +106,8 @@ module Google
|
|
106
106
|
# The current state of the cluster.
|
107
107
|
# @!attribute [rw] serve_nodes
|
108
108
|
# @return [Integer]
|
109
|
-
# Required. The number of nodes allocated to this cluster. More nodes enable
|
110
|
-
# throughput and more consistent performance.
|
109
|
+
# Required. The number of nodes allocated to this cluster. More nodes enable
|
110
|
+
# higher throughput and more consistent performance.
|
111
111
|
# @!attribute [rw] default_storage_type
|
112
112
|
# @return [Google::Bigtable::Admin::V2::StorageType]
|
113
113
|
# (`CreationOnly`)
|
@@ -17,6 +17,16 @@ module Google
|
|
17
17
|
module Bigtable
|
18
18
|
module Admin
|
19
19
|
module V2
|
20
|
+
# Information about a table restore.
|
21
|
+
# @!attribute [rw] source_type
|
22
|
+
# @return [Google::Bigtable::Admin::V2::RestoreSourceType]
|
23
|
+
# The type of the restore source.
|
24
|
+
# @!attribute [rw] backup_info
|
25
|
+
# @return [Google::Bigtable::Admin::V2::BackupInfo]
|
26
|
+
# Information about the backup used to restore the table. The backup
|
27
|
+
# may no longer exist.
|
28
|
+
class RestoreInfo; end
|
29
|
+
|
20
30
|
# A collection of user data indexed by row, column, and timestamp.
|
21
31
|
# Each table is served using the resources of its parent cluster.
|
22
32
|
# @!attribute [rw] name
|
@@ -43,6 +53,10 @@ module Google
|
|
43
53
|
# this table. Timestamps not matching the granularity will be rejected.
|
44
54
|
# If unspecified at creation time, the value will be set to `MILLIS`.
|
45
55
|
# Views: `SCHEMA_VIEW`, `FULL`.
|
56
|
+
# @!attribute [rw] restore_info
|
57
|
+
# @return [Google::Bigtable::Admin::V2::RestoreInfo]
|
58
|
+
# Output only. If this table was restored from another data source (e.g. a
|
59
|
+
# backup), this field will be populated with information about the restore.
|
46
60
|
class Table
|
47
61
|
# The state of a table's data in a particular cluster.
|
48
62
|
# @!attribute [rw] replication_state
|
@@ -71,6 +85,11 @@ module Google
|
|
71
85
|
# replication delay, reads may not immediately reflect the state of the
|
72
86
|
# table in other clusters.
|
73
87
|
READY = 4
|
88
|
+
|
89
|
+
# The table is fully created and ready for use after a restore, and is
|
90
|
+
# being optimized for performance. When optimizations are complete, the
|
91
|
+
# table will transition to `READY` state.
|
92
|
+
READY_OPTIMIZING = 5
|
74
93
|
end
|
75
94
|
end
|
76
95
|
|
@@ -162,16 +181,17 @@ module Google
|
|
162
181
|
# Output only. The source table at the time the snapshot was taken.
|
163
182
|
# @!attribute [rw] data_size_bytes
|
164
183
|
# @return [Integer]
|
165
|
-
# Output only. The size of the data in the source table at the time the
|
166
|
-
# taken. In some cases, this value may be computed
|
167
|
-
# background process and a placeholder of 0 will be used
|
184
|
+
# Output only. The size of the data in the source table at the time the
|
185
|
+
# snapshot was taken. In some cases, this value may be computed
|
186
|
+
# asynchronously via a background process and a placeholder of 0 will be used
|
187
|
+
# in the meantime.
|
168
188
|
# @!attribute [rw] create_time
|
169
189
|
# @return [Google::Protobuf::Timestamp]
|
170
190
|
# Output only. The time when the snapshot is created.
|
171
191
|
# @!attribute [rw] delete_time
|
172
192
|
# @return [Google::Protobuf::Timestamp]
|
173
|
-
# Output only. The time when the snapshot will be deleted. The maximum amount
|
174
|
-
# snapshot can stay active is 365 days. If 'ttl' is not specified,
|
193
|
+
# Output only. The time when the snapshot will be deleted. The maximum amount
|
194
|
+
# of time a snapshot can stay active is 365 days. If 'ttl' is not specified,
|
175
195
|
# the default maximum of 365 days will be used.
|
176
196
|
# @!attribute [rw] state
|
177
197
|
# @return [Google::Bigtable::Admin::V2::Snapshot::State]
|
@@ -194,6 +214,89 @@ module Google
|
|
194
214
|
CREATING = 2
|
195
215
|
end
|
196
216
|
end
|
217
|
+
|
218
|
+
# A backup of a Cloud Bigtable table.
|
219
|
+
# @!attribute [rw] name
|
220
|
+
# @return [String]
|
221
|
+
# Output only. A globally unique identifier for the backup which cannot be
|
222
|
+
# changed. Values are of the form
|
223
|
+
# `projects/{project}/instances/{instance}/clusters/{cluster}/
|
224
|
+
# backups/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
|
225
|
+
# The final segment of the name must be between 1 and 50 characters
|
226
|
+
# in length.
|
227
|
+
#
|
228
|
+
# The backup is stored in the cluster identified by the prefix of the backup
|
229
|
+
# name of the form
|
230
|
+
# `projects/{project}/instances/{instance}/clusters/{cluster}`.
|
231
|
+
# @!attribute [rw] source_table
|
232
|
+
# @return [String]
|
233
|
+
# Required. Immutable. Name of the table from which this backup was created.
|
234
|
+
# This needs to be in the same instance as the backup. Values are of the form
|
235
|
+
# `projects/{project}/instances/{instance}/tables/{source_table}`.
|
236
|
+
# @!attribute [rw] expire_time
|
237
|
+
# @return [Google::Protobuf::Timestamp]
|
238
|
+
# Required. The expiration time of the backup, with microseconds
|
239
|
+
# granularity that must be at least 6 hours and at most 30 days
|
240
|
+
# from the time the request is received. Once the `expire_time`
|
241
|
+
# has passed, Cloud Bigtable will delete the backup and free the
|
242
|
+
# resources used by the backup.
|
243
|
+
# @!attribute [rw] start_time
|
244
|
+
# @return [Google::Protobuf::Timestamp]
|
245
|
+
# Output only. `start_time` is the time that the backup was started
|
246
|
+
# (i.e. approximately the time the
|
247
|
+
# {Google::Bigtable::Admin::V2::BigtableTableAdmin::CreateBackup CreateBackup}
|
248
|
+
# request is received). The row data in this backup will be no older than
|
249
|
+
# this timestamp.
|
250
|
+
# @!attribute [rw] end_time
|
251
|
+
# @return [Google::Protobuf::Timestamp]
|
252
|
+
# Output only. `end_time` is the time that the backup was finished. The row
|
253
|
+
# data in the backup will be no newer than this timestamp.
|
254
|
+
# @!attribute [rw] size_bytes
|
255
|
+
# @return [Integer]
|
256
|
+
# Output only. Size of the backup in bytes.
|
257
|
+
# @!attribute [rw] state
|
258
|
+
# @return [Google::Bigtable::Admin::V2::Backup::State]
|
259
|
+
# Output only. The current state of the backup.
|
260
|
+
class Backup
|
261
|
+
# Indicates the current state of the backup.
|
262
|
+
module State
|
263
|
+
# Not specified.
|
264
|
+
STATE_UNSPECIFIED = 0
|
265
|
+
|
266
|
+
# The pending backup is still being created. Operations on the
|
267
|
+
# backup may fail with `FAILED_PRECONDITION` in this state.
|
268
|
+
CREATING = 1
|
269
|
+
|
270
|
+
# The backup is complete and ready for use.
|
271
|
+
READY = 2
|
272
|
+
end
|
273
|
+
end
|
274
|
+
|
275
|
+
# Information about a backup.
|
276
|
+
# @!attribute [rw] backup
|
277
|
+
# @return [String]
|
278
|
+
# Output only. Name of the backup.
|
279
|
+
# @!attribute [rw] start_time
|
280
|
+
# @return [Google::Protobuf::Timestamp]
|
281
|
+
# Output only. The time that the backup was started. Row data in the backup
|
282
|
+
# will be no older than this timestamp.
|
283
|
+
# @!attribute [rw] end_time
|
284
|
+
# @return [Google::Protobuf::Timestamp]
|
285
|
+
# Output only. This time that the backup was finished. Row data in the
|
286
|
+
# backup will be no newer than this timestamp.
|
287
|
+
# @!attribute [rw] source_table
|
288
|
+
# @return [String]
|
289
|
+
# Output only. Name of the table the backup was created from.
|
290
|
+
class BackupInfo; end
|
291
|
+
|
292
|
+
# Indicates the type of the restore source.
|
293
|
+
module RestoreSourceType
|
294
|
+
# No restore associated.
|
295
|
+
RESTORE_SOURCE_TYPE_UNSPECIFIED = 0
|
296
|
+
|
297
|
+
# A backup was used as the source of the restore.
|
298
|
+
BACKUP = 1
|
299
|
+
end
|
197
300
|
end
|
198
301
|
end
|
199
302
|
end
|