google-cloud-spanner-admin-database-v1 0.18.0 → 0.20.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (21) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/spanner/admin/database/v1/database_admin/client.rb +658 -90
  3. data/lib/google/cloud/spanner/admin/database/v1/database_admin/operations.rb +13 -5
  4. data/lib/google/cloud/spanner/admin/database/v1/database_admin/paths.rb +21 -0
  5. data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/client.rb +623 -90
  6. data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/operations.rb +11 -4
  7. data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/service_stub.rb +321 -0
  8. data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest.rb +1 -1
  9. data/lib/google/cloud/spanner/admin/database/v1/database_admin.rb +1 -1
  10. data/lib/google/cloud/spanner/admin/database/v1/version.rb +1 -1
  11. data/lib/google/spanner/admin/database/v1/backup_pb.rb +2 -1
  12. data/lib/google/spanner/admin/database/v1/backup_schedule_pb.rb +65 -0
  13. data/lib/google/spanner/admin/database/v1/common_pb.rb +1 -1
  14. data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb +2 -1
  15. data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb +31 -16
  16. data/proto_docs/google/api/client.rb +4 -0
  17. data/proto_docs/google/spanner/admin/database/v1/backup.rb +158 -69
  18. data/proto_docs/google/spanner/admin/database/v1/backup_schedule.rb +213 -0
  19. data/proto_docs/google/spanner/admin/database/v1/common.rb +23 -6
  20. data/proto_docs/google/spanner/admin/database/v1/spanner_database_admin.rb +91 -54
  21. metadata +4 -2
data/lib/google/cloud/spanner/admin/database/v1/database_admin/rest/client.rb CHANGED
@@ -36,10 +36,13 @@ module Google
36
36
  # The Cloud Spanner Database Admin API can be used to:
37
37
  # * create, drop, and list databases
38
38
  # * update the schema of pre-existing databases
39
- # * create, delete and list backups for a database
39
+ # * create, delete, copy and list backups for a database
40
40
  # * restore a database from an existing backup
41
41
  #
42
42
  class Client
43
+ # @private
44
+ API_VERSION = ""
45
+
43
46
  # @private
44
47
  DEFAULT_ENDPOINT_TEMPLATE = "spanner.$UNIVERSE_DOMAIN$"
45
48
 
@@ -159,6 +162,31 @@ module Google
159
162
  initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
160
163
  }
161
164
 
165
+ default_config.rpcs.create_backup_schedule.timeout = 3600.0
166
+ default_config.rpcs.create_backup_schedule.retry_policy = {
167
+ initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
168
+ }
169
+
170
+ default_config.rpcs.get_backup_schedule.timeout = 3600.0
171
+ default_config.rpcs.get_backup_schedule.retry_policy = {
172
+ initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
173
+ }
174
+
175
+ default_config.rpcs.update_backup_schedule.timeout = 3600.0
176
+ default_config.rpcs.update_backup_schedule.retry_policy = {
177
+ initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
178
+ }
179
+
180
+ default_config.rpcs.delete_backup_schedule.timeout = 3600.0
181
+ default_config.rpcs.delete_backup_schedule.retry_policy = {
182
+ initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
183
+ }
184
+
185
+ default_config.rpcs.list_backup_schedules.timeout = 3600.0
186
+ default_config.rpcs.list_backup_schedules.retry_policy = {
187
+ initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
188
+ }
189
+
162
190
  default_config
163
191
  end
164
192
  yield @configure if block_given?
@@ -283,8 +311,9 @@ module Google
283
311
  # defaults to the server's maximum allowed page size.
284
312
  # @param page_token [::String]
285
313
  # If non-empty, `page_token` should contain a
286
- # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token} from a
287
- # previous {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
314
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token}
315
+ # from a previous
316
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
288
317
  # @yield [result, operation] Access the result along with the TransportOperation object
289
318
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Database>]
290
319
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -323,12 +352,13 @@ module Google
323
352
  # Customize the options with defaults
324
353
  call_metadata = @config.rpcs.list_databases.metadata.to_h
325
354
 
326
- # Set x-goog-api-client and x-goog-user-project headers
355
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
327
356
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
328
357
  lib_name: @config.lib_name, lib_version: @config.lib_version,
329
358
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
330
359
  transports_version_send: [:rest]
331
360
 
361
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
332
362
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
333
363
 
334
364
  options.apply_defaults timeout: @config.rpcs.list_databases.timeout,
@@ -354,8 +384,8 @@ module Google
354
384
  # have a name of the format `<database_name>/operations/<operation_id>` and
355
385
  # can be used to track preparation of the database. The
356
386
  # {::Google::Longrunning::Operation#metadata metadata} field type is
357
- # {::Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}. The
358
- # {::Google::Longrunning::Operation#response response} field type is
387
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}.
388
+ # The {::Google::Longrunning::Operation#response response} field type is
359
389
  # {::Google::Cloud::Spanner::Admin::Database::V1::Database Database}, if successful.
360
390
  #
361
391
  # @overload create_database(request, options = nil)
@@ -388,8 +418,8 @@ module Google
388
418
  # statements execute atomically with the creation of the database:
389
419
  # if there is an error in any statement, the database is not created.
390
420
  # @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::EncryptionConfig, ::Hash]
391
- # Optional. The encryption configuration for the database. If this field is not
392
- # specified, Cloud Spanner will encrypt/decrypt all data at rest using
421
+ # Optional. The encryption configuration for the database. If this field is
422
+ # not specified, Cloud Spanner will encrypt/decrypt all data at rest using
393
423
  # Google default encryption.
394
424
  # @param database_dialect [::Google::Cloud::Spanner::Admin::Database::V1::DatabaseDialect]
395
425
  # Optional. The dialect of the Cloud Spanner Database.
@@ -450,12 +480,13 @@ module Google
450
480
  # Customize the options with defaults
451
481
  call_metadata = @config.rpcs.create_database.metadata.to_h
452
482
 
453
- # Set x-goog-api-client and x-goog-user-project headers
483
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
454
484
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
455
485
  lib_name: @config.lib_name, lib_version: @config.lib_version,
456
486
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
457
487
  transports_version_send: [:rest]
458
488
 
489
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
459
490
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
460
491
 
461
492
  options.apply_defaults timeout: @config.rpcs.create_database.timeout,
@@ -530,12 +561,13 @@ module Google
530
561
  # Customize the options with defaults
531
562
  call_metadata = @config.rpcs.get_database.metadata.to_h
532
563
 
533
- # Set x-goog-api-client and x-goog-user-project headers
564
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
534
565
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
535
566
  lib_name: @config.lib_name, lib_version: @config.lib_version,
536
567
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
537
568
  transports_version_send: [:rest]
538
569
 
570
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
539
571
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
540
572
 
541
573
  options.apply_defaults timeout: @config.rpcs.get_database.timeout,
@@ -655,12 +687,13 @@ module Google
655
687
  # Customize the options with defaults
656
688
  call_metadata = @config.rpcs.update_database.metadata.to_h
657
689
 
658
- # Set x-goog-api-client and x-goog-user-project headers
690
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
659
691
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
660
692
  lib_name: @config.lib_name, lib_version: @config.lib_version,
661
693
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
662
694
  transports_version_send: [:rest]
663
695
 
696
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
664
697
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
665
698
 
666
699
  options.apply_defaults timeout: @config.rpcs.update_database.timeout,
@@ -687,7 +720,8 @@ module Google
687
720
  # the format `<database_name>/operations/<operation_id>` and can be used to
688
721
  # track execution of the schema change(s). The
689
722
  # {::Google::Longrunning::Operation#metadata metadata} field type is
690
- # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}. The operation has no response.
723
+ # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.
724
+ # The operation has no response.
691
725
  #
692
726
  # @overload update_database_ddl(request, options = nil)
693
727
  # Pass arguments to `update_database_ddl` via a request object, either of type
@@ -716,18 +750,20 @@ module Google
716
750
  #
717
751
  # Specifying an explicit operation ID simplifies determining
718
752
  # whether the statements were executed in the event that the
719
- # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client#update_database_ddl UpdateDatabaseDdl} call is replayed,
720
- # or the return value is otherwise lost: the {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
721
- # `operation_id` fields can be combined to form the
753
+ # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client#update_database_ddl UpdateDatabaseDdl}
754
+ # call is replayed, or the return value is otherwise lost: the
755
+ # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database}
756
+ # and `operation_id` fields can be combined to form the
722
757
  # {::Google::Longrunning::Operation#name name} of the resulting
723
- # {::Google::Longrunning::Operation longrunning.Operation}: `<database>/operations/<operation_id>`.
758
+ # {::Google::Longrunning::Operation longrunning.Operation}:
759
+ # `<database>/operations/<operation_id>`.
724
760
  #
725
761
  # `operation_id` should be unique within the database, and must be
726
762
  # a valid identifier: `[a-z][a-z0-9_]*`. Note that
727
763
  # automatically-generated operation IDs always begin with an
728
764
  # underscore. If the named operation already exists,
729
- # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client#update_database_ddl UpdateDatabaseDdl} returns
730
- # `ALREADY_EXISTS`.
765
+ # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client#update_database_ddl UpdateDatabaseDdl}
766
+ # returns `ALREADY_EXISTS`.
731
767
  # @param proto_descriptors [::String]
732
768
  # Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements.
733
769
  # Contains a protobuf-serialized
@@ -784,12 +820,13 @@ module Google
784
820
  # Customize the options with defaults
785
821
  call_metadata = @config.rpcs.update_database_ddl.metadata.to_h
786
822
 
787
- # Set x-goog-api-client and x-goog-user-project headers
823
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
788
824
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
789
825
  lib_name: @config.lib_name, lib_version: @config.lib_version,
790
826
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
791
827
  transports_version_send: [:rest]
792
828
 
829
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
793
830
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
794
831
 
795
832
  options.apply_defaults timeout: @config.rpcs.update_database_ddl.timeout,
@@ -867,12 +904,13 @@ module Google
867
904
  # Customize the options with defaults
868
905
  call_metadata = @config.rpcs.drop_database.metadata.to_h
869
906
 
870
- # Set x-goog-api-client and x-goog-user-project headers
907
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
871
908
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
872
909
  lib_name: @config.lib_name, lib_version: @config.lib_version,
873
910
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
874
911
  transports_version_send: [:rest]
875
912
 
913
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
876
914
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
877
915
 
878
916
  options.apply_defaults timeout: @config.rpcs.drop_database.timeout,
@@ -949,12 +987,13 @@ module Google
949
987
  # Customize the options with defaults
950
988
  call_metadata = @config.rpcs.get_database_ddl.metadata.to_h
951
989
 
952
- # Set x-goog-api-client and x-goog-user-project headers
990
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
953
991
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
954
992
  lib_name: @config.lib_name, lib_version: @config.lib_version,
955
993
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
956
994
  transports_version_send: [:rest]
957
995
 
996
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
958
997
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
959
998
 
960
999
  options.apply_defaults timeout: @config.rpcs.get_database_ddl.timeout,
@@ -1045,12 +1084,13 @@ module Google
1045
1084
  # Customize the options with defaults
1046
1085
  call_metadata = @config.rpcs.set_iam_policy.metadata.to_h
1047
1086
 
1048
- # Set x-goog-api-client and x-goog-user-project headers
1087
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1049
1088
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1050
1089
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1051
1090
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1052
1091
  transports_version_send: [:rest]
1053
1092
 
1093
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1054
1094
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1055
1095
 
1056
1096
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
@@ -1134,12 +1174,13 @@ module Google
1134
1174
  # Customize the options with defaults
1135
1175
  call_metadata = @config.rpcs.get_iam_policy.metadata.to_h
1136
1176
 
1137
- # Set x-goog-api-client and x-goog-user-project headers
1177
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1138
1178
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1139
1179
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1140
1180
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1141
1181
  transports_version_send: [:rest]
1142
1182
 
1183
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1143
1184
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1144
1185
 
1145
1186
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
@@ -1227,12 +1268,13 @@ module Google
1227
1268
  # Customize the options with defaults
1228
1269
  call_metadata = @config.rpcs.test_iam_permissions.metadata.to_h
1229
1270
 
1230
- # Set x-goog-api-client and x-goog-user-project headers
1271
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1231
1272
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1232
1273
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1233
1274
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1234
1275
  transports_version_send: [:rest]
1235
1276
 
1277
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1236
1278
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1237
1279
 
1238
1280
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
@@ -1258,12 +1300,12 @@ module Google
1258
1300
  # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
1259
1301
  # and can be used to track creation of the backup. The
1260
1302
  # {::Google::Longrunning::Operation#metadata metadata} field type is
1261
- # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}. The
1262
- # {::Google::Longrunning::Operation#response response} field type is
1263
- # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful. Cancelling the returned operation will stop the
1264
- # creation and delete the backup.
1265
- # There can be only one pending backup creation per database. Backup creation
1266
- # of different databases can run concurrently.
1303
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
1304
+ # The {::Google::Longrunning::Operation#response response} field type is
1305
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful.
1306
+ # Cancelling the returned operation will stop the creation and delete the
1307
+ # backup. There can be only one pending backup creation per database. Backup
1308
+ # creation of different databases can run concurrently.
1267
1309
  #
1268
1310
  # @overload create_backup(request, options = nil)
1269
1311
  # Pass arguments to `create_backup` via a request object, either of type
@@ -1294,11 +1336,11 @@ module Google
1294
1336
  # @param backup [::Google::Cloud::Spanner::Admin::Database::V1::Backup, ::Hash]
1295
1337
  # Required. The backup to create.
1296
1338
  # @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupEncryptionConfig, ::Hash]
1297
- # Optional. The encryption configuration used to encrypt the backup. If this field is
1298
- # not specified, the backup will use the same
1299
- # encryption configuration as the database by default, namely
1300
- # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupEncryptionConfig#encryption_type encryption_type} =
1301
- # `USE_DATABASE_ENCRYPTION`.
1339
+ # Optional. The encryption configuration used to encrypt the backup. If this
1340
+ # field is not specified, the backup will use the same encryption
1341
+ # configuration as the database by default, namely
1342
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupEncryptionConfig#encryption_type encryption_type}
1343
+ # = `USE_DATABASE_ENCRYPTION`.
1302
1344
  # @yield [result, operation] Access the result along with the TransportOperation object
1303
1345
  # @yieldparam result [::Gapic::Operation]
1304
1346
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1340,12 +1382,13 @@ module Google
1340
1382
  # Customize the options with defaults
1341
1383
  call_metadata = @config.rpcs.create_backup.metadata.to_h
1342
1384
 
1343
- # Set x-goog-api-client and x-goog-user-project headers
1385
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1344
1386
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1345
1387
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1346
1388
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1347
1389
  transports_version_send: [:rest]
1348
1390
 
1391
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1349
1392
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1350
1393
 
1351
1394
  options.apply_defaults timeout: @config.rpcs.create_backup.timeout,
@@ -1375,9 +1418,10 @@ module Google
1375
1418
  # The {::Google::Longrunning::Operation#metadata metadata} field type is
1376
1419
  # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
1377
1420
  # The {::Google::Longrunning::Operation#response response} field type is
1378
- # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful. Cancelling the returned operation will stop the
1379
- # copying and delete the backup.
1380
- # Concurrent CopyBackup requests can run on the same source backup.
1421
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful.
1422
+ # Cancelling the returned operation will stop the copying and delete the
1423
+ # destination backup. Concurrent CopyBackup requests can run on the same
1424
+ # source backup.
1381
1425
  #
1382
1426
  # @overload copy_backup(request, options = nil)
1383
1427
  # Pass arguments to `copy_backup` via a request object, either of type
@@ -1395,8 +1439,8 @@ module Google
1395
1439
  # the default parameter values, pass an empty Hash as a request object (see above).
1396
1440
  #
1397
1441
  # @param parent [::String]
1398
- # Required. The name of the destination instance that will contain the backup copy.
1399
- # Values are of the form: `projects/<project>/instances/<instance>`.
1442
+ # Required. The name of the destination instance that will contain the backup
1443
+ # copy. Values are of the form: `projects/<project>/instances/<instance>`.
1400
1444
  # @param backup_id [::String]
1401
1445
  # Required. The id of the backup copy.
1402
1446
  # The `backup_id` appended to `parent` forms the full backup_uri of the form
@@ -1415,11 +1459,11 @@ module Google
1415
1459
  # passed, the backup is eligible to be automatically deleted by Cloud Spanner
1416
1460
  # to free the resources used by the backup.
1417
1461
  # @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig, ::Hash]
1418
- # Optional. The encryption configuration used to encrypt the backup. If this field is
1419
- # not specified, the backup will use the same
1420
- # encryption configuration as the source backup by default, namely
1421
- # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig#encryption_type encryption_type} =
1422
- # `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
1462
+ # Optional. The encryption configuration used to encrypt the backup. If this
1463
+ # field is not specified, the backup will use the same encryption
1464
+ # configuration as the source backup by default, namely
1465
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig#encryption_type encryption_type}
1466
+ # = `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
1423
1467
  # @yield [result, operation] Access the result along with the TransportOperation object
1424
1468
  # @yieldparam result [::Gapic::Operation]
1425
1469
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1461,12 +1505,13 @@ module Google
1461
1505
  # Customize the options with defaults
1462
1506
  call_metadata = @config.rpcs.copy_backup.metadata.to_h
1463
1507
 
1464
- # Set x-goog-api-client and x-goog-user-project headers
1508
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1465
1509
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1466
1510
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1467
1511
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1468
1512
  transports_version_send: [:rest]
1469
1513
 
1514
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1470
1515
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1471
1516
 
1472
1517
  options.apply_defaults timeout: @config.rpcs.copy_backup.timeout,
@@ -1487,7 +1532,8 @@ module Google
1487
1532
  end
1488
1533
 
1489
1534
  ##
1490
- # Gets metadata on a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1535
+ # Gets metadata on a pending or completed
1536
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1491
1537
  #
1492
1538
  # @overload get_backup(request, options = nil)
1493
1539
  # Pass arguments to `get_backup` via a request object, either of type
@@ -1542,12 +1588,13 @@ module Google
1542
1588
  # Customize the options with defaults
1543
1589
  call_metadata = @config.rpcs.get_backup.metadata.to_h
1544
1590
 
1545
- # Set x-goog-api-client and x-goog-user-project headers
1591
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1546
1592
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1547
1593
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1548
1594
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1549
1595
  transports_version_send: [:rest]
1550
1596
 
1597
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1551
1598
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1552
1599
 
1553
1600
  options.apply_defaults timeout: @config.rpcs.get_backup.timeout,
@@ -1567,7 +1614,8 @@ module Google
1567
1614
  end
1568
1615
 
1569
1616
  ##
1570
- # Updates a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1617
+ # Updates a pending or completed
1618
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1571
1619
  #
1572
1620
  # @overload update_backup(request, options = nil)
1573
1621
  # Pass arguments to `update_backup` via a request object, either of type
@@ -1629,12 +1677,13 @@ module Google
1629
1677
  # Customize the options with defaults
1630
1678
  call_metadata = @config.rpcs.update_backup.metadata.to_h
1631
1679
 
1632
- # Set x-goog-api-client and x-goog-user-project headers
1680
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1633
1681
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1634
1682
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1635
1683
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1636
1684
  transports_version_send: [:rest]
1637
1685
 
1686
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1638
1687
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1639
1688
 
1640
1689
  options.apply_defaults timeout: @config.rpcs.update_backup.timeout,
@@ -1654,7 +1703,8 @@ module Google
1654
1703
  end
1655
1704
 
1656
1705
  ##
1657
- # Deletes a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1706
+ # Deletes a pending or completed
1707
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
1658
1708
  #
1659
1709
  # @overload delete_backup(request, options = nil)
1660
1710
  # Pass arguments to `delete_backup` via a request object, either of type
@@ -1709,12 +1759,13 @@ module Google
1709
1759
  # Customize the options with defaults
1710
1760
  call_metadata = @config.rpcs.delete_backup.metadata.to_h
1711
1761
 
1712
- # Set x-goog-api-client and x-goog-user-project headers
1762
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1713
1763
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1714
1764
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1715
1765
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1716
1766
  transports_version_send: [:rest]
1717
1767
 
1768
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1718
1769
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1719
1770
 
1720
1771
  options.apply_defaults timeout: @config.rpcs.delete_backup.timeout,
@@ -1765,7 +1816,9 @@ module Google
1765
1816
  # must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
1766
1817
  # Colon `:` is the contains operator. Filter rules are not case sensitive.
1767
1818
  #
1768
- # The following fields in the {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup} are eligible for filtering:
1819
+ # The following fields in the
1820
+ # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup} are eligible for
1821
+ # filtering:
1769
1822
  #
1770
1823
  # * `name`
1771
1824
  # * `database`
@@ -1797,9 +1850,10 @@ module Google
1797
1850
  # less, defaults to the server's maximum allowed page size.
1798
1851
  # @param page_token [::String]
1799
1852
  # If non-empty, `page_token` should contain a
1800
- # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse#next_page_token next_page_token} from a
1801
- # previous {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse ListBackupsResponse} to the same `parent` and with the same
1802
- # `filter`.
1853
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse#next_page_token next_page_token}
1854
+ # from a previous
1855
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupsResponse ListBackupsResponse}
1856
+ # to the same `parent` and with the same `filter`.
1803
1857
  # @yield [result, operation] Access the result along with the TransportOperation object
1804
1858
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::Backup>]
1805
1859
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1838,12 +1892,13 @@ module Google
1838
1892
  # Customize the options with defaults
1839
1893
  call_metadata = @config.rpcs.list_backups.metadata.to_h
1840
1894
 
1841
- # Set x-goog-api-client and x-goog-user-project headers
1895
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1842
1896
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1843
1897
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1844
1898
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1845
1899
  transports_version_send: [:rest]
1846
1900
 
1901
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1847
1902
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1848
1903
 
1849
1904
  options.apply_defaults timeout: @config.rpcs.list_backups.timeout,
@@ -1912,12 +1967,12 @@ module Google
1912
1967
  # Name of the backup from which to restore. Values are of the form
1913
1968
  # `projects/<project>/instances/<instance>/backups/<backup>`.
1914
1969
  # @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseEncryptionConfig, ::Hash]
1915
- # Optional. An encryption configuration describing the encryption type and key
1916
- # resources in Cloud KMS used to encrypt/decrypt the database to restore to.
1917
- # If this field is not specified, the restored database will use
1918
- # the same encryption configuration as the backup by default, namely
1919
- # {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseEncryptionConfig#encryption_type encryption_type} =
1920
- # `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
1970
+ # Optional. An encryption configuration describing the encryption type and
1971
+ # key resources in Cloud KMS used to encrypt/decrypt the database to restore
1972
+ # to. If this field is not specified, the restored database will use the same
1973
+ # encryption configuration as the backup by default, namely
1974
+ # {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseEncryptionConfig#encryption_type encryption_type}
1975
+ # = `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
1921
1976
  # @yield [result, operation] Access the result along with the TransportOperation object
1922
1977
  # @yieldparam result [::Gapic::Operation]
1923
1978
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1959,12 +2014,13 @@ module Google
1959
2014
  # Customize the options with defaults
1960
2015
  call_metadata = @config.rpcs.restore_database.metadata.to_h
1961
2016
 
1962
- # Set x-goog-api-client and x-goog-user-project headers
2017
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1963
2018
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1964
2019
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1965
2020
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
1966
2021
  transports_version_send: [:rest]
1967
2022
 
2023
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1968
2024
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1969
2025
 
1970
2026
  options.apply_defaults timeout: @config.rpcs.restore_database.timeout,
@@ -2027,7 +2083,9 @@ module Google
2027
2083
  # * `name` - The name of the long-running operation
2028
2084
  # * `done` - False if the operation is in progress, else true.
2029
2085
  # * `metadata.@type` - the type of metadata. For example, the type string
2030
- # for {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata} is
2086
+ # for
2087
+ # {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}
2088
+ # is
2031
2089
  # `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
2032
2090
  # * `metadata.<field_name>` - any field in metadata.value.
2033
2091
  # `metadata.@type` must be specified first, if filtering on metadata
@@ -2049,7 +2107,8 @@ module Google
2049
2107
  # `(metadata.name:restored_howl) AND` \
2050
2108
  # `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
2051
2109
  # `(error:*)` - Return operations where:
2052
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
2110
+ # * The operation's metadata type is
2111
+ # {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
2053
2112
  # * The database is restored from a backup.
2054
2113
  # * The backup name contains "backup_howl".
2055
2114
  # * The restored database's name contains "restored_howl".
@@ -2061,8 +2120,9 @@ module Google
2061
2120
  # @param page_token [::String]
2062
2121
  # If non-empty, `page_token` should contain a
2063
2122
  # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse#next_page_token next_page_token}
2064
- # from a previous {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse ListDatabaseOperationsResponse} to the
2065
- # same `parent` and with the same `filter`.
2123
+ # from a previous
2124
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseOperationsResponse ListDatabaseOperationsResponse}
2125
+ # to the same `parent` and with the same `filter`.
2066
2126
  # @yield [result, operation] Access the result along with the TransportOperation object
2067
2127
  # @yieldparam result [::Gapic::Operation]
2068
2128
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2101,12 +2161,13 @@ module Google
2101
2161
  # Customize the options with defaults
2102
2162
  call_metadata = @config.rpcs.list_database_operations.metadata.to_h
2103
2163
 
2104
- # Set x-goog-api-client and x-goog-user-project headers
2164
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2105
2165
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2106
2166
  lib_name: @config.lib_name, lib_version: @config.lib_version,
2107
2167
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2108
2168
  transports_version_send: [:rest]
2109
2169
 
2170
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2110
2171
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2111
2172
 
2112
2173
  options.apply_defaults timeout: @config.rpcs.list_database_operations.timeout,
@@ -2171,7 +2232,9 @@ module Google
2171
2232
  # * `name` - The name of the long-running operation
2172
2233
  # * `done` - False if the operation is in progress, else true.
2173
2234
  # * `metadata.@type` - the type of metadata. For example, the type string
2174
- # for {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} is
2235
+ # for
2236
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}
2237
+ # is
2175
2238
  # `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
2176
2239
  # * `metadata.<field_name>` - any field in metadata.value.
2177
2240
  # `metadata.@type` must be specified first if filtering on metadata
@@ -2189,14 +2252,15 @@ module Google
2189
2252
  # * `done:true` - The operation is complete.
2190
2253
  # * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
2191
2254
  # `metadata.database:prod` - Returns operations where:
2192
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
2193
- # * The database the backup was taken from has a name containing the
2194
- # string "prod".
2255
+ # * The operation's metadata type is
2256
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
2257
+ # * The source database name of backup contains the string "prod".
2195
2258
  # * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
2196
2259
  # `(metadata.name:howl) AND` \
2197
2260
  # `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
2198
2261
  # `(error:*)` - Returns operations where:
2199
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
2262
+ # * The operation's metadata type is
2263
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
2200
2264
  # * The backup name contains the string "howl".
2201
2265
  # * The operation started before 2018-03-28T14:50:00Z.
2202
2266
  # * The operation resulted in an error.
@@ -2204,9 +2268,9 @@ module Google
2204
2268
  # `(metadata.source_backup:test) AND` \
2205
2269
  # `(metadata.progress.start_time < \"2022-01-18T14:50:00Z\") AND` \
2206
2270
  # `(error:*)` - Returns operations where:
2207
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
2208
- # * The source backup of the copied backup name contains the string
2209
- # "test".
2271
+ # * The operation's metadata type is
2272
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
2273
+ # * The source backup name contains the string "test".
2210
2274
  # * The operation started before 2022-01-18T14:50:00Z.
2211
2275
  # * The operation resulted in an error.
2212
2276
  # * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
@@ -2216,12 +2280,13 @@ module Google
2216
2280
  # `(metadata.source_backup:test_bkp)) AND` \
2217
2281
  # `(error:*)` - Returns operations where:
2218
2282
  # * The operation's metadata matches either of criteria:
2219
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} AND the
2220
- # database the backup was taken from has name containing string
2283
+ # * The operation's metadata type is
2284
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}
2285
+ # AND the source database name of the backup contains the string
2221
2286
  # "test_db"
2222
- # * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata} AND the
2223
- # backup the backup was copied from has name containing string
2224
- # "test_bkp"
2287
+ # * The operation's metadata type is
2288
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}
2289
+ # AND the source backup name contains the string "test_bkp"
2225
2290
  # * The operation resulted in an error.
2226
2291
  # @param page_size [::Integer]
2227
2292
  # Number of operations to be returned in the response. If 0 or
@@ -2229,8 +2294,9 @@ module Google
2229
2294
  # @param page_token [::String]
2230
2295
  # If non-empty, `page_token` should contain a
2231
2296
  # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse#next_page_token next_page_token}
2232
- # from a previous {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse ListBackupOperationsResponse} to the
2233
- # same `parent` and with the same `filter`.
2297
+ # from a previous
2298
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupOperationsResponse ListBackupOperationsResponse}
2299
+ # to the same `parent` and with the same `filter`.
2234
2300
  # @yield [result, operation] Access the result along with the TransportOperation object
2235
2301
  # @yieldparam result [::Gapic::Operation]
2236
2302
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2269,12 +2335,13 @@ module Google
2269
2335
  # Customize the options with defaults
2270
2336
  call_metadata = @config.rpcs.list_backup_operations.metadata.to_h
2271
2337
 
2272
- # Set x-goog-api-client and x-goog-user-project headers
2338
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2273
2339
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2274
2340
  lib_name: @config.lib_name, lib_version: @config.lib_version,
2275
2341
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2276
2342
  transports_version_send: [:rest]
2277
2343
 
2344
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2278
2345
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2279
2346
 
2280
2347
  options.apply_defaults timeout: @config.rpcs.list_backup_operations.timeout,
@@ -2315,14 +2382,15 @@ module Google
2315
2382
  # @param parent [::String]
2316
2383
  # Required. The database whose roles should be listed.
2317
2384
  # Values are of the form
2318
- # `projects/<project>/instances/<instance>/databases/<database>/databaseRoles`.
2385
+ # `projects/<project>/instances/<instance>/databases/<database>`.
2319
2386
  # @param page_size [::Integer]
2320
2387
  # Number of database roles to be returned in the response. If 0 or less,
2321
2388
  # defaults to the server's maximum allowed page size.
2322
2389
  # @param page_token [::String]
2323
2390
  # If non-empty, `page_token` should contain a
2324
- # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseRolesResponse#next_page_token next_page_token} from a
2325
- # previous {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseRolesResponse ListDatabaseRolesResponse}.
2391
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseRolesResponse#next_page_token next_page_token}
2392
+ # from a previous
2393
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListDatabaseRolesResponse ListDatabaseRolesResponse}.
2326
2394
  # @yield [result, operation] Access the result along with the TransportOperation object
2327
2395
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::DatabaseRole>]
2328
2396
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2361,12 +2429,13 @@ module Google
2361
2429
  # Customize the options with defaults
2362
2430
  call_metadata = @config.rpcs.list_database_roles.metadata.to_h
2363
2431
 
2364
- # Set x-goog-api-client and x-goog-user-project headers
2432
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2365
2433
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2366
2434
  lib_name: @config.lib_name, lib_version: @config.lib_version,
2367
2435
  gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2368
2436
  transports_version_send: [:rest]
2369
2437
 
2438
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2370
2439
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2371
2440
 
2372
2441
  options.apply_defaults timeout: @config.rpcs.list_database_roles.timeout,
@@ -2386,6 +2455,435 @@ module Google
2386
2455
  raise ::Google::Cloud::Error.from_error(e)
2387
2456
  end
2388
2457
 
2458
+ ##
2459
+ # Creates a new backup schedule.
2460
+ #
2461
+ # @overload create_backup_schedule(request, options = nil)
2462
+ # Pass arguments to `create_backup_schedule` via a request object, either of type
2463
+ # {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupScheduleRequest} or an equivalent Hash.
2464
+ #
2465
+ # @param request [::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupScheduleRequest, ::Hash]
2466
+ # A request object representing the call parameters. Required. To specify no
2467
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2468
+ # @param options [::Gapic::CallOptions, ::Hash]
2469
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2470
+ #
2471
+ # @overload create_backup_schedule(parent: nil, backup_schedule_id: nil, backup_schedule: nil)
2472
+ # Pass arguments to `create_backup_schedule` via keyword arguments. Note that at
2473
+ # least one keyword argument is required. To specify no parameters, or to keep all
2474
+ # the default parameter values, pass an empty Hash as a request object (see above).
2475
+ #
2476
+ # @param parent [::String]
2477
+ # Required. The name of the database that this backup schedule applies to.
2478
+ # @param backup_schedule_id [::String]
2479
+ # Required. The Id to use for the backup schedule. The `backup_schedule_id`
2480
+ # appended to `parent` forms the full backup schedule name of the form
2481
+ # `projects/<project>/instances/<instance>/databases/<database>/backupSchedules/<backup_schedule_id>`.
2482
+ # @param backup_schedule [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule, ::Hash]
2483
+ # Required. The backup schedule to create.
2484
+ # @yield [result, operation] Access the result along with the TransportOperation object
2485
+ # @yieldparam result [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2486
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2487
+ #
2488
+ # @return [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2489
+ #
2490
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2491
+ #
2492
+ # @example Basic example
2493
+ # require "google/cloud/spanner/admin/database/v1"
2494
+ #
2495
+ # # Create a client object. The client can be reused for multiple calls.
2496
+ # client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
2497
+ #
2498
+ # # Create a request. To set request fields, pass in keyword arguments.
2499
+ # request = Google::Cloud::Spanner::Admin::Database::V1::CreateBackupScheduleRequest.new
2500
+ #
2501
+ # # Call the create_backup_schedule method.
2502
+ # result = client.create_backup_schedule request
2503
+ #
2504
+ # # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule.
2505
+ # p result
2506
+ #
2507
+ def create_backup_schedule request, options = nil
2508
+ raise ::ArgumentError, "request must be provided" if request.nil?
2509
+
2510
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupScheduleRequest
2511
+
2512
+ # Converts hash and nil to an options object
2513
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2514
+
2515
+ # Customize the options with defaults
2516
+ call_metadata = @config.rpcs.create_backup_schedule.metadata.to_h
2517
+
2518
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2519
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2520
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2521
+ gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2522
+ transports_version_send: [:rest]
2523
+
2524
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2525
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2526
+
2527
+ options.apply_defaults timeout: @config.rpcs.create_backup_schedule.timeout,
2528
+ metadata: call_metadata,
2529
+ retry_policy: @config.rpcs.create_backup_schedule.retry_policy
2530
+
2531
+ options.apply_defaults timeout: @config.timeout,
2532
+ metadata: @config.metadata,
2533
+ retry_policy: @config.retry_policy
2534
+
2535
+ @database_admin_stub.create_backup_schedule request, options do |result, operation|
2536
+ yield result, operation if block_given?
2537
+ return result
2538
+ end
2539
+ rescue ::Gapic::Rest::Error => e
2540
+ raise ::Google::Cloud::Error.from_error(e)
2541
+ end
2542
+
2543
+ ##
2544
+ # Gets backup schedule for the input schedule name.
2545
+ #
2546
+ # @overload get_backup_schedule(request, options = nil)
2547
+ # Pass arguments to `get_backup_schedule` via a request object, either of type
2548
+ # {::Google::Cloud::Spanner::Admin::Database::V1::GetBackupScheduleRequest} or an equivalent Hash.
2549
+ #
2550
+ # @param request [::Google::Cloud::Spanner::Admin::Database::V1::GetBackupScheduleRequest, ::Hash]
2551
+ # A request object representing the call parameters. Required. To specify no
2552
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2553
+ # @param options [::Gapic::CallOptions, ::Hash]
2554
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2555
+ #
2556
+ # @overload get_backup_schedule(name: nil)
2557
+ # Pass arguments to `get_backup_schedule` via keyword arguments. Note that at
2558
+ # least one keyword argument is required. To specify no parameters, or to keep all
2559
+ # the default parameter values, pass an empty Hash as a request object (see above).
2560
+ #
2561
+ # @param name [::String]
2562
+ # Required. The name of the schedule to retrieve.
2563
+ # Values are of the form
2564
+ # `projects/<project>/instances/<instance>/databases/<database>/backupSchedules/<backup_schedule_id>`.
2565
+ # @yield [result, operation] Access the result along with the TransportOperation object
2566
+ # @yieldparam result [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2567
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2568
+ #
2569
+ # @return [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2570
+ #
2571
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2572
+ #
2573
+ # @example Basic example
2574
+ # require "google/cloud/spanner/admin/database/v1"
2575
+ #
2576
+ # # Create a client object. The client can be reused for multiple calls.
2577
+ # client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
2578
+ #
2579
+ # # Create a request. To set request fields, pass in keyword arguments.
2580
+ # request = Google::Cloud::Spanner::Admin::Database::V1::GetBackupScheduleRequest.new
2581
+ #
2582
+ # # Call the get_backup_schedule method.
2583
+ # result = client.get_backup_schedule request
2584
+ #
2585
+ # # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule.
2586
+ # p result
2587
+ #
2588
+ def get_backup_schedule request, options = nil
2589
+ raise ::ArgumentError, "request must be provided" if request.nil?
2590
+
2591
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::GetBackupScheduleRequest
2592
+
2593
+ # Converts hash and nil to an options object
2594
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2595
+
2596
+ # Customize the options with defaults
2597
+ call_metadata = @config.rpcs.get_backup_schedule.metadata.to_h
2598
+
2599
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2600
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2601
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2602
+ gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2603
+ transports_version_send: [:rest]
2604
+
2605
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2606
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2607
+
2608
+ options.apply_defaults timeout: @config.rpcs.get_backup_schedule.timeout,
2609
+ metadata: call_metadata,
2610
+ retry_policy: @config.rpcs.get_backup_schedule.retry_policy
2611
+
2612
+ options.apply_defaults timeout: @config.timeout,
2613
+ metadata: @config.metadata,
2614
+ retry_policy: @config.retry_policy
2615
+
2616
+ @database_admin_stub.get_backup_schedule request, options do |result, operation|
2617
+ yield result, operation if block_given?
2618
+ return result
2619
+ end
2620
+ rescue ::Gapic::Rest::Error => e
2621
+ raise ::Google::Cloud::Error.from_error(e)
2622
+ end
2623
+
2624
+ ##
2625
+ # Updates a backup schedule.
2626
+ #
2627
+ # @overload update_backup_schedule(request, options = nil)
2628
+ # Pass arguments to `update_backup_schedule` via a request object, either of type
2629
+ # {::Google::Cloud::Spanner::Admin::Database::V1::UpdateBackupScheduleRequest} or an equivalent Hash.
2630
+ #
2631
+ # @param request [::Google::Cloud::Spanner::Admin::Database::V1::UpdateBackupScheduleRequest, ::Hash]
2632
+ # A request object representing the call parameters. Required. To specify no
2633
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2634
+ # @param options [::Gapic::CallOptions, ::Hash]
2635
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2636
+ #
2637
+ # @overload update_backup_schedule(backup_schedule: nil, update_mask: nil)
2638
+ # Pass arguments to `update_backup_schedule` via keyword arguments. Note that at
2639
+ # least one keyword argument is required. To specify no parameters, or to keep all
2640
+ # the default parameter values, pass an empty Hash as a request object (see above).
2641
+ #
2642
+ # @param backup_schedule [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule, ::Hash]
2643
+ # Required. The backup schedule to update. `backup_schedule.name`, and the
2644
+ # fields to be updated as specified by `update_mask` are required. Other
2645
+ # fields are ignored.
2646
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2647
+ # Required. A mask specifying which fields in the BackupSchedule resource
2648
+ # should be updated. This mask is relative to the BackupSchedule resource,
2649
+ # not to the request message. The field mask must always be
2650
+ # specified; this prevents any future fields from being erased
2651
+ # accidentally.
2652
+ # @yield [result, operation] Access the result along with the TransportOperation object
2653
+ # @yieldparam result [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2654
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2655
+ #
2656
+ # @return [::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule]
2657
+ #
2658
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2659
+ #
2660
+ # @example Basic example
2661
+ # require "google/cloud/spanner/admin/database/v1"
2662
+ #
2663
+ # # Create a client object. The client can be reused for multiple calls.
2664
+ # client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
2665
+ #
2666
+ # # Create a request. To set request fields, pass in keyword arguments.
2667
+ # request = Google::Cloud::Spanner::Admin::Database::V1::UpdateBackupScheduleRequest.new
2668
+ #
2669
+ # # Call the update_backup_schedule method.
2670
+ # result = client.update_backup_schedule request
2671
+ #
2672
+ # # The returned object is of type Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule.
2673
+ # p result
2674
+ #
2675
+ def update_backup_schedule request, options = nil
2676
+ raise ::ArgumentError, "request must be provided" if request.nil?
2677
+
2678
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::UpdateBackupScheduleRequest
2679
+
2680
+ # Converts hash and nil to an options object
2681
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2682
+
2683
+ # Customize the options with defaults
2684
+ call_metadata = @config.rpcs.update_backup_schedule.metadata.to_h
2685
+
2686
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2687
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2688
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2689
+ gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2690
+ transports_version_send: [:rest]
2691
+
2692
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2693
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2694
+
2695
+ options.apply_defaults timeout: @config.rpcs.update_backup_schedule.timeout,
2696
+ metadata: call_metadata,
2697
+ retry_policy: @config.rpcs.update_backup_schedule.retry_policy
2698
+
2699
+ options.apply_defaults timeout: @config.timeout,
2700
+ metadata: @config.metadata,
2701
+ retry_policy: @config.retry_policy
2702
+
2703
+ @database_admin_stub.update_backup_schedule request, options do |result, operation|
2704
+ yield result, operation if block_given?
2705
+ return result
2706
+ end
2707
+ rescue ::Gapic::Rest::Error => e
2708
+ raise ::Google::Cloud::Error.from_error(e)
2709
+ end
2710
+
2711
+ ##
2712
+ # Deletes a backup schedule.
2713
+ #
2714
+ # @overload delete_backup_schedule(request, options = nil)
2715
+ # Pass arguments to `delete_backup_schedule` via a request object, either of type
2716
+ # {::Google::Cloud::Spanner::Admin::Database::V1::DeleteBackupScheduleRequest} or an equivalent Hash.
2717
+ #
2718
+ # @param request [::Google::Cloud::Spanner::Admin::Database::V1::DeleteBackupScheduleRequest, ::Hash]
2719
+ # A request object representing the call parameters. Required. To specify no
2720
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2721
+ # @param options [::Gapic::CallOptions, ::Hash]
2722
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2723
+ #
2724
+ # @overload delete_backup_schedule(name: nil)
2725
+ # Pass arguments to `delete_backup_schedule` via keyword arguments. Note that at
2726
+ # least one keyword argument is required. To specify no parameters, or to keep all
2727
+ # the default parameter values, pass an empty Hash as a request object (see above).
2728
+ #
2729
+ # @param name [::String]
2730
+ # Required. The name of the schedule to delete.
2731
+ # Values are of the form
2732
+ # `projects/<project>/instances/<instance>/databases/<database>/backupSchedules/<backup_schedule_id>`.
2733
+ # @yield [result, operation] Access the result along with the TransportOperation object
2734
+ # @yieldparam result [::Google::Protobuf::Empty]
2735
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2736
+ #
2737
+ # @return [::Google::Protobuf::Empty]
2738
+ #
2739
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2740
+ #
2741
+ # @example Basic example
2742
+ # require "google/cloud/spanner/admin/database/v1"
2743
+ #
2744
+ # # Create a client object. The client can be reused for multiple calls.
2745
+ # client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
2746
+ #
2747
+ # # Create a request. To set request fields, pass in keyword arguments.
2748
+ # request = Google::Cloud::Spanner::Admin::Database::V1::DeleteBackupScheduleRequest.new
2749
+ #
2750
+ # # Call the delete_backup_schedule method.
2751
+ # result = client.delete_backup_schedule request
2752
+ #
2753
+ # # The returned object is of type Google::Protobuf::Empty.
2754
+ # p result
2755
+ #
2756
+ def delete_backup_schedule request, options = nil
2757
+ raise ::ArgumentError, "request must be provided" if request.nil?
2758
+
2759
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::DeleteBackupScheduleRequest
2760
+
2761
+ # Converts hash and nil to an options object
2762
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2763
+
2764
+ # Customize the options with defaults
2765
+ call_metadata = @config.rpcs.delete_backup_schedule.metadata.to_h
2766
+
2767
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2768
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2769
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2770
+ gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2771
+ transports_version_send: [:rest]
2772
+
2773
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2774
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2775
+
2776
+ options.apply_defaults timeout: @config.rpcs.delete_backup_schedule.timeout,
2777
+ metadata: call_metadata,
2778
+ retry_policy: @config.rpcs.delete_backup_schedule.retry_policy
2779
+
2780
+ options.apply_defaults timeout: @config.timeout,
2781
+ metadata: @config.metadata,
2782
+ retry_policy: @config.retry_policy
2783
+
2784
+ @database_admin_stub.delete_backup_schedule request, options do |result, operation|
2785
+ yield result, operation if block_given?
2786
+ return result
2787
+ end
2788
+ rescue ::Gapic::Rest::Error => e
2789
+ raise ::Google::Cloud::Error.from_error(e)
2790
+ end
2791
+
2792
+ ##
2793
+ # Lists all the backup schedules for the database.
2794
+ #
2795
+ # @overload list_backup_schedules(request, options = nil)
2796
+ # Pass arguments to `list_backup_schedules` via a request object, either of type
2797
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesRequest} or an equivalent Hash.
2798
+ #
2799
+ # @param request [::Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesRequest, ::Hash]
2800
+ # A request object representing the call parameters. Required. To specify no
2801
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2802
+ # @param options [::Gapic::CallOptions, ::Hash]
2803
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2804
+ #
2805
+ # @overload list_backup_schedules(parent: nil, page_size: nil, page_token: nil)
2806
+ # Pass arguments to `list_backup_schedules` via keyword arguments. Note that at
2807
+ # least one keyword argument is required. To specify no parameters, or to keep all
2808
+ # the default parameter values, pass an empty Hash as a request object (see above).
2809
+ #
2810
+ # @param parent [::String]
2811
+ # Required. Database is the parent resource whose backup schedules should be
2812
+ # listed. Values are of the form
2813
+ # projects/<project>/instances/<instance>/databases/<database>
2814
+ # @param page_size [::Integer]
2815
+ # Optional. Number of backup schedules to be returned in the response. If 0
2816
+ # or less, defaults to the server's maximum allowed page size.
2817
+ # @param page_token [::String]
2818
+ # Optional. If non-empty, `page_token` should contain a
2819
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesResponse#next_page_token next_page_token}
2820
+ # from a previous
2821
+ # {::Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesResponse ListBackupSchedulesResponse}
2822
+ # to the same `parent`.
2823
+ # @yield [result, operation] Access the result along with the TransportOperation object
2824
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule>]
2825
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2826
+ #
2827
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule>]
2828
+ #
2829
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2830
+ #
2831
+ # @example Basic example
2832
+ # require "google/cloud/spanner/admin/database/v1"
2833
+ #
2834
+ # # Create a client object. The client can be reused for multiple calls.
2835
+ # client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Rest::Client.new
2836
+ #
2837
+ # # Create a request. To set request fields, pass in keyword arguments.
2838
+ # request = Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesRequest.new
2839
+ #
2840
+ # # Call the list_backup_schedules method.
2841
+ # result = client.list_backup_schedules request
2842
+ #
2843
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2844
+ # # over elements, and API calls will be issued to fetch pages as needed.
2845
+ # result.each do |item|
2846
+ # # Each element is of type ::Google::Cloud::Spanner::Admin::Database::V1::BackupSchedule.
2847
+ # p item
2848
+ # end
2849
+ #
2850
+ def list_backup_schedules request, options = nil
2851
+ raise ::ArgumentError, "request must be provided" if request.nil?
2852
+
2853
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::ListBackupSchedulesRequest
2854
+
2855
+ # Converts hash and nil to an options object
2856
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2857
+
2858
+ # Customize the options with defaults
2859
+ call_metadata = @config.rpcs.list_backup_schedules.metadata.to_h
2860
+
2861
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2862
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2863
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2864
+ gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION,
2865
+ transports_version_send: [:rest]
2866
+
2867
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2868
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2869
+
2870
+ options.apply_defaults timeout: @config.rpcs.list_backup_schedules.timeout,
2871
+ metadata: call_metadata,
2872
+ retry_policy: @config.rpcs.list_backup_schedules.retry_policy
2873
+
2874
+ options.apply_defaults timeout: @config.timeout,
2875
+ metadata: @config.metadata,
2876
+ retry_policy: @config.retry_policy
2877
+
2878
+ @database_admin_stub.list_backup_schedules request, options do |result, operation|
2879
+ result = ::Gapic::Rest::PagedEnumerable.new @database_admin_stub, :list_backup_schedules, "backup_schedules", request, result, options
2880
+ yield result, operation if block_given?
2881
+ return result
2882
+ end
2883
+ rescue ::Gapic::Rest::Error => e
2884
+ raise ::Google::Cloud::Error.from_error(e)
2885
+ end
2886
+
2389
2887
  ##
2390
2888
  # Configuration class for the DatabaseAdmin REST API.
2391
2889
  #
@@ -2619,6 +3117,31 @@ module Google
2619
3117
  # @return [::Gapic::Config::Method]
2620
3118
  #
2621
3119
  attr_reader :list_database_roles
3120
+ ##
3121
+ # RPC-specific configuration for `create_backup_schedule`
3122
+ # @return [::Gapic::Config::Method]
3123
+ #
3124
+ attr_reader :create_backup_schedule
3125
+ ##
3126
+ # RPC-specific configuration for `get_backup_schedule`
3127
+ # @return [::Gapic::Config::Method]
3128
+ #
3129
+ attr_reader :get_backup_schedule
3130
+ ##
3131
+ # RPC-specific configuration for `update_backup_schedule`
3132
+ # @return [::Gapic::Config::Method]
3133
+ #
3134
+ attr_reader :update_backup_schedule
3135
+ ##
3136
+ # RPC-specific configuration for `delete_backup_schedule`
3137
+ # @return [::Gapic::Config::Method]
3138
+ #
3139
+ attr_reader :delete_backup_schedule
3140
+ ##
3141
+ # RPC-specific configuration for `list_backup_schedules`
3142
+ # @return [::Gapic::Config::Method]
3143
+ #
3144
+ attr_reader :list_backup_schedules
2622
3145
 
2623
3146
  # @private
2624
3147
  def initialize parent_rpcs = nil
@@ -2662,6 +3185,16 @@ module Google
2662
3185
  @list_backup_operations = ::Gapic::Config::Method.new list_backup_operations_config
2663
3186
  list_database_roles_config = parent_rpcs.list_database_roles if parent_rpcs.respond_to? :list_database_roles
2664
3187
  @list_database_roles = ::Gapic::Config::Method.new list_database_roles_config
3188
+ create_backup_schedule_config = parent_rpcs.create_backup_schedule if parent_rpcs.respond_to? :create_backup_schedule
3189
+ @create_backup_schedule = ::Gapic::Config::Method.new create_backup_schedule_config
3190
+ get_backup_schedule_config = parent_rpcs.get_backup_schedule if parent_rpcs.respond_to? :get_backup_schedule
3191
+ @get_backup_schedule = ::Gapic::Config::Method.new get_backup_schedule_config
3192
+ update_backup_schedule_config = parent_rpcs.update_backup_schedule if parent_rpcs.respond_to? :update_backup_schedule
3193
+ @update_backup_schedule = ::Gapic::Config::Method.new update_backup_schedule_config
3194
+ delete_backup_schedule_config = parent_rpcs.delete_backup_schedule if parent_rpcs.respond_to? :delete_backup_schedule
3195
+ @delete_backup_schedule = ::Gapic::Config::Method.new delete_backup_schedule_config
3196
+ list_backup_schedules_config = parent_rpcs.list_backup_schedules if parent_rpcs.respond_to? :list_backup_schedules
3197
+ @list_backup_schedules = ::Gapic::Config::Method.new list_backup_schedules_config
2665
3198
 
2666
3199
  yield self if block_given?
2667
3200
  end