google-cloud-cloud_dms-v1 1.0.1 → 1.1.0

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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e2dcb5e1a88bd35d3aa45ea5d3fc1f4baee63181dfba6287c927eca135762832
4
- data.tar.gz: 801c5e61e10d69d0e4e4615fbdd12b26206579f409735c1e529509bbb828f7fe
3
+ metadata.gz: 3586167cd5b8d360a01b04e7590eff93c64349a6947be8da969d2a6cd9d9c071
4
+ data.tar.gz: 82efa6ddea4968679c24babb429a9771d3f08516fcf7a5b3e890b44ac4c6969b
5
5
  SHA512:
6
- metadata.gz: 48ef28a408761a35751deb50049ac802efa1480a2adfc86b07a098d89cc67efc0de1ff45b0bd80feec73dd845fb1e2009ee55bfcdc6963c628ef04a2e44d0351
7
- data.tar.gz: ec7f454d484f8e8756d310ecc25eb1326b56404adcff0d423809b6bec02ff5adaee928274cf97a83effcd5eab8befed2821d77f5697000aeacb9e522a1abb3c3
6
+ metadata.gz: 1f0fdb04e0d3ce29edc2aa3d5039bfe6ba27b9331123c45c67e03cd40798c46c14599d6328305346ab125c35aea6fa631705106a7abad3c679dedc9a61cbafdd
7
+ data.tar.gz: 37ea098b2fd8ecea666e7f2954e3ff771f75be6cddae340edcb96b38188ffb2affc530627a312cc4092c10a9b39149e41c76870e58336bf111484eea2a8aa538
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/database-migration/)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/cloud_dms/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::CloudDMS::V1::DataMigrationService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -243,14 +243,26 @@ module Google
243
243
  universe_domain: @config.universe_domain,
244
244
  channel_args: @config.channel_args,
245
245
  interceptors: @config.interceptors,
246
- channel_pool_config: @config.channel_pool
246
+ channel_pool_config: @config.channel_pool,
247
+ logger: @config.logger
247
248
  )
248
249
 
250
+ @data_migration_service_stub.stub_logger&.info do |entry|
251
+ entry.set_system_name
252
+ entry.set_service
253
+ entry.message = "Created client for #{entry.service}"
254
+ entry.set_credentials_fields credentials
255
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
256
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
257
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
258
+ end
259
+
249
260
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
250
261
  config.credentials = credentials
251
262
  config.quota_project = @quota_project_id
252
263
  config.endpoint = @data_migration_service_stub.endpoint
253
264
  config.universe_domain = @data_migration_service_stub.universe_domain
265
+ config.logger = @data_migration_service_stub.logger if config.respond_to? :logger=
254
266
  end
255
267
 
256
268
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -258,6 +270,7 @@ module Google
258
270
  config.quota_project = @quota_project_id
259
271
  config.endpoint = @data_migration_service_stub.endpoint
260
272
  config.universe_domain = @data_migration_service_stub.universe_domain
273
+ config.logger = @data_migration_service_stub.logger if config.respond_to? :logger=
261
274
  end
262
275
  end
263
276
 
@@ -282,6 +295,15 @@ module Google
282
295
  #
283
296
  attr_reader :iam_policy_client
284
297
 
298
+ ##
299
+ # The logger used for request/response debug logging.
300
+ #
301
+ # @return [Logger]
302
+ #
303
+ def logger
304
+ @data_migration_service_stub.logger
305
+ end
306
+
285
307
  # Service calls
286
308
 
287
309
  ##
@@ -393,7 +415,7 @@ module Google
393
415
  @data_migration_service_stub.call_rpc :list_migration_jobs, request, options: options do |response, operation|
394
416
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_migration_jobs, request, response, operation, options
395
417
  yield response, operation if block_given?
396
- return response
418
+ throw :response, response
397
419
  end
398
420
  rescue ::GRPC::BadStatus => e
399
421
  raise ::Google::Cloud::Error.from_error(e)
@@ -479,7 +501,6 @@ module Google
479
501
 
480
502
  @data_migration_service_stub.call_rpc :get_migration_job, request, options: options do |response, operation|
481
503
  yield response, operation if block_given?
482
- return response
483
504
  end
484
505
  rescue ::GRPC::BadStatus => e
485
506
  raise ::Google::Cloud::Error.from_error(e)
@@ -587,7 +608,7 @@ module Google
587
608
  @data_migration_service_stub.call_rpc :create_migration_job, request, options: options do |response, operation|
588
609
  response = ::Gapic::Operation.new response, @operations_client, options: options
589
610
  yield response, operation if block_given?
590
- return response
611
+ throw :response, response
591
612
  end
592
613
  rescue ::GRPC::BadStatus => e
593
614
  raise ::Google::Cloud::Error.from_error(e)
@@ -692,7 +713,7 @@ module Google
692
713
  @data_migration_service_stub.call_rpc :update_migration_job, request, options: options do |response, operation|
693
714
  response = ::Gapic::Operation.new response, @operations_client, options: options
694
715
  yield response, operation if block_given?
695
- return response
716
+ throw :response, response
696
717
  end
697
718
  rescue ::GRPC::BadStatus => e
698
719
  raise ::Google::Cloud::Error.from_error(e)
@@ -798,7 +819,7 @@ module Google
798
819
  @data_migration_service_stub.call_rpc :delete_migration_job, request, options: options do |response, operation|
799
820
  response = ::Gapic::Operation.new response, @operations_client, options: options
800
821
  yield response, operation if block_given?
801
- return response
822
+ throw :response, response
802
823
  end
803
824
  rescue ::GRPC::BadStatus => e
804
825
  raise ::Google::Cloud::Error.from_error(e)
@@ -895,7 +916,7 @@ module Google
895
916
  @data_migration_service_stub.call_rpc :start_migration_job, request, options: options do |response, operation|
896
917
  response = ::Gapic::Operation.new response, @operations_client, options: options
897
918
  yield response, operation if block_given?
898
- return response
919
+ throw :response, response
899
920
  end
900
921
  rescue ::GRPC::BadStatus => e
901
922
  raise ::Google::Cloud::Error.from_error(e)
@@ -989,7 +1010,7 @@ module Google
989
1010
  @data_migration_service_stub.call_rpc :stop_migration_job, request, options: options do |response, operation|
990
1011
  response = ::Gapic::Operation.new response, @operations_client, options: options
991
1012
  yield response, operation if block_given?
992
- return response
1013
+ throw :response, response
993
1014
  end
994
1015
  rescue ::GRPC::BadStatus => e
995
1016
  raise ::Google::Cloud::Error.from_error(e)
@@ -1084,7 +1105,7 @@ module Google
1084
1105
  @data_migration_service_stub.call_rpc :resume_migration_job, request, options: options do |response, operation|
1085
1106
  response = ::Gapic::Operation.new response, @operations_client, options: options
1086
1107
  yield response, operation if block_given?
1087
- return response
1108
+ throw :response, response
1088
1109
  end
1089
1110
  rescue ::GRPC::BadStatus => e
1090
1111
  raise ::Google::Cloud::Error.from_error(e)
@@ -1179,7 +1200,7 @@ module Google
1179
1200
  @data_migration_service_stub.call_rpc :promote_migration_job, request, options: options do |response, operation|
1180
1201
  response = ::Gapic::Operation.new response, @operations_client, options: options
1181
1202
  yield response, operation if block_given?
1182
- return response
1203
+ throw :response, response
1183
1204
  end
1184
1205
  rescue ::GRPC::BadStatus => e
1185
1206
  raise ::Google::Cloud::Error.from_error(e)
@@ -1280,7 +1301,7 @@ module Google
1280
1301
  @data_migration_service_stub.call_rpc :verify_migration_job, request, options: options do |response, operation|
1281
1302
  response = ::Gapic::Operation.new response, @operations_client, options: options
1282
1303
  yield response, operation if block_given?
1283
- return response
1304
+ throw :response, response
1284
1305
  end
1285
1306
  rescue ::GRPC::BadStatus => e
1286
1307
  raise ::Google::Cloud::Error.from_error(e)
@@ -1379,7 +1400,7 @@ module Google
1379
1400
  @data_migration_service_stub.call_rpc :restart_migration_job, request, options: options do |response, operation|
1380
1401
  response = ::Gapic::Operation.new response, @operations_client, options: options
1381
1402
  yield response, operation if block_given?
1382
- return response
1403
+ throw :response, response
1383
1404
  end
1384
1405
  rescue ::GRPC::BadStatus => e
1385
1406
  raise ::Google::Cloud::Error.from_error(e)
@@ -1474,7 +1495,6 @@ module Google
1474
1495
 
1475
1496
  @data_migration_service_stub.call_rpc :generate_ssh_script, request, options: options do |response, operation|
1476
1497
  yield response, operation if block_given?
1477
- return response
1478
1498
  end
1479
1499
  rescue ::GRPC::BadStatus => e
1480
1500
  raise ::Google::Cloud::Error.from_error(e)
@@ -1575,7 +1595,6 @@ module Google
1575
1595
 
1576
1596
  @data_migration_service_stub.call_rpc :generate_tcp_proxy_script, request, options: options do |response, operation|
1577
1597
  yield response, operation if block_given?
1578
- return response
1579
1598
  end
1580
1599
  rescue ::GRPC::BadStatus => e
1581
1600
  raise ::Google::Cloud::Error.from_error(e)
@@ -1690,7 +1709,7 @@ module Google
1690
1709
  @data_migration_service_stub.call_rpc :list_connection_profiles, request, options: options do |response, operation|
1691
1710
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_connection_profiles, request, response, operation, options
1692
1711
  yield response, operation if block_given?
1693
- return response
1712
+ throw :response, response
1694
1713
  end
1695
1714
  rescue ::GRPC::BadStatus => e
1696
1715
  raise ::Google::Cloud::Error.from_error(e)
@@ -1776,7 +1795,6 @@ module Google
1776
1795
 
1777
1796
  @data_migration_service_stub.call_rpc :get_connection_profile, request, options: options do |response, operation|
1778
1797
  yield response, operation if block_given?
1779
- return response
1780
1798
  end
1781
1799
  rescue ::GRPC::BadStatus => e
1782
1800
  raise ::Google::Cloud::Error.from_error(e)
@@ -1890,7 +1908,7 @@ module Google
1890
1908
  @data_migration_service_stub.call_rpc :create_connection_profile, request, options: options do |response, operation|
1891
1909
  response = ::Gapic::Operation.new response, @operations_client, options: options
1892
1910
  yield response, operation if block_given?
1893
- return response
1911
+ throw :response, response
1894
1912
  end
1895
1913
  rescue ::GRPC::BadStatus => e
1896
1914
  raise ::Google::Cloud::Error.from_error(e)
@@ -2003,7 +2021,7 @@ module Google
2003
2021
  @data_migration_service_stub.call_rpc :update_connection_profile, request, options: options do |response, operation|
2004
2022
  response = ::Gapic::Operation.new response, @operations_client, options: options
2005
2023
  yield response, operation if block_given?
2006
- return response
2024
+ throw :response, response
2007
2025
  end
2008
2026
  rescue ::GRPC::BadStatus => e
2009
2027
  raise ::Google::Cloud::Error.from_error(e)
@@ -2110,7 +2128,7 @@ module Google
2110
2128
  @data_migration_service_stub.call_rpc :delete_connection_profile, request, options: options do |response, operation|
2111
2129
  response = ::Gapic::Operation.new response, @operations_client, options: options
2112
2130
  yield response, operation if block_given?
2113
- return response
2131
+ throw :response, response
2114
2132
  end
2115
2133
  rescue ::GRPC::BadStatus => e
2116
2134
  raise ::Google::Cloud::Error.from_error(e)
@@ -2218,7 +2236,7 @@ module Google
2218
2236
  @data_migration_service_stub.call_rpc :create_private_connection, request, options: options do |response, operation|
2219
2237
  response = ::Gapic::Operation.new response, @operations_client, options: options
2220
2238
  yield response, operation if block_given?
2221
- return response
2239
+ throw :response, response
2222
2240
  end
2223
2241
  rescue ::GRPC::BadStatus => e
2224
2242
  raise ::Google::Cloud::Error.from_error(e)
@@ -2304,7 +2322,6 @@ module Google
2304
2322
 
2305
2323
  @data_migration_service_stub.call_rpc :get_private_connection, request, options: options do |response, operation|
2306
2324
  yield response, operation if block_given?
2307
- return response
2308
2325
  end
2309
2326
  rescue ::GRPC::BadStatus => e
2310
2327
  raise ::Google::Cloud::Error.from_error(e)
@@ -2415,7 +2432,7 @@ module Google
2415
2432
  @data_migration_service_stub.call_rpc :list_private_connections, request, options: options do |response, operation|
2416
2433
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_private_connections, request, response, operation, options
2417
2434
  yield response, operation if block_given?
2418
- return response
2435
+ throw :response, response
2419
2436
  end
2420
2437
  rescue ::GRPC::BadStatus => e
2421
2438
  raise ::Google::Cloud::Error.from_error(e)
@@ -2517,7 +2534,7 @@ module Google
2517
2534
  @data_migration_service_stub.call_rpc :delete_private_connection, request, options: options do |response, operation|
2518
2535
  response = ::Gapic::Operation.new response, @operations_client, options: options
2519
2536
  yield response, operation if block_given?
2520
- return response
2537
+ throw :response, response
2521
2538
  end
2522
2539
  rescue ::GRPC::BadStatus => e
2523
2540
  raise ::Google::Cloud::Error.from_error(e)
@@ -2603,7 +2620,6 @@ module Google
2603
2620
 
2604
2621
  @data_migration_service_stub.call_rpc :get_conversion_workspace, request, options: options do |response, operation|
2605
2622
  yield response, operation if block_given?
2606
- return response
2607
2623
  end
2608
2624
  rescue ::GRPC::BadStatus => e
2609
2625
  raise ::Google::Cloud::Error.from_error(e)
@@ -2713,7 +2729,7 @@ module Google
2713
2729
  @data_migration_service_stub.call_rpc :list_conversion_workspaces, request, options: options do |response, operation|
2714
2730
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_conversion_workspaces, request, response, operation, options
2715
2731
  yield response, operation if block_given?
2716
- return response
2732
+ throw :response, response
2717
2733
  end
2718
2734
  rescue ::GRPC::BadStatus => e
2719
2735
  raise ::Google::Cloud::Error.from_error(e)
@@ -2819,7 +2835,7 @@ module Google
2819
2835
  @data_migration_service_stub.call_rpc :create_conversion_workspace, request, options: options do |response, operation|
2820
2836
  response = ::Gapic::Operation.new response, @operations_client, options: options
2821
2837
  yield response, operation if block_given?
2822
- return response
2838
+ throw :response, response
2823
2839
  end
2824
2840
  rescue ::GRPC::BadStatus => e
2825
2841
  raise ::Google::Cloud::Error.from_error(e)
@@ -2924,7 +2940,7 @@ module Google
2924
2940
  @data_migration_service_stub.call_rpc :update_conversion_workspace, request, options: options do |response, operation|
2925
2941
  response = ::Gapic::Operation.new response, @operations_client, options: options
2926
2942
  yield response, operation if block_given?
2927
- return response
2943
+ throw :response, response
2928
2944
  end
2929
2945
  rescue ::GRPC::BadStatus => e
2930
2946
  raise ::Google::Cloud::Error.from_error(e)
@@ -3029,7 +3045,7 @@ module Google
3029
3045
  @data_migration_service_stub.call_rpc :delete_conversion_workspace, request, options: options do |response, operation|
3030
3046
  response = ::Gapic::Operation.new response, @operations_client, options: options
3031
3047
  yield response, operation if block_given?
3032
- return response
3048
+ throw :response, response
3033
3049
  end
3034
3050
  rescue ::GRPC::BadStatus => e
3035
3051
  raise ::Google::Cloud::Error.from_error(e)
@@ -3129,7 +3145,6 @@ module Google
3129
3145
 
3130
3146
  @data_migration_service_stub.call_rpc :create_mapping_rule, request, options: options do |response, operation|
3131
3147
  yield response, operation if block_given?
3132
- return response
3133
3148
  end
3134
3149
  rescue ::GRPC::BadStatus => e
3135
3150
  raise ::Google::Cloud::Error.from_error(e)
@@ -3223,7 +3238,6 @@ module Google
3223
3238
 
3224
3239
  @data_migration_service_stub.call_rpc :delete_mapping_rule, request, options: options do |response, operation|
3225
3240
  yield response, operation if block_given?
3226
- return response
3227
3241
  end
3228
3242
  rescue ::GRPC::BadStatus => e
3229
3243
  raise ::Google::Cloud::Error.from_error(e)
@@ -3325,7 +3339,7 @@ module Google
3325
3339
  @data_migration_service_stub.call_rpc :list_mapping_rules, request, options: options do |response, operation|
3326
3340
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_mapping_rules, request, response, operation, options
3327
3341
  yield response, operation if block_given?
3328
- return response
3342
+ throw :response, response
3329
3343
  end
3330
3344
  rescue ::GRPC::BadStatus => e
3331
3345
  raise ::Google::Cloud::Error.from_error(e)
@@ -3417,7 +3431,6 @@ module Google
3417
3431
 
3418
3432
  @data_migration_service_stub.call_rpc :get_mapping_rule, request, options: options do |response, operation|
3419
3433
  yield response, operation if block_given?
3420
- return response
3421
3434
  end
3422
3435
  rescue ::GRPC::BadStatus => e
3423
3436
  raise ::Google::Cloud::Error.from_error(e)
@@ -3522,7 +3535,7 @@ module Google
3522
3535
  @data_migration_service_stub.call_rpc :seed_conversion_workspace, request, options: options do |response, operation|
3523
3536
  response = ::Gapic::Operation.new response, @operations_client, options: options
3524
3537
  yield response, operation if block_given?
3525
- return response
3538
+ throw :response, response
3526
3539
  end
3527
3540
  rescue ::GRPC::BadStatus => e
3528
3541
  raise ::Google::Cloud::Error.from_error(e)
@@ -3626,7 +3639,7 @@ module Google
3626
3639
  @data_migration_service_stub.call_rpc :import_mapping_rules, request, options: options do |response, operation|
3627
3640
  response = ::Gapic::Operation.new response, @operations_client, options: options
3628
3641
  yield response, operation if block_given?
3629
- return response
3642
+ throw :response, response
3630
3643
  end
3631
3644
  rescue ::GRPC::BadStatus => e
3632
3645
  raise ::Google::Cloud::Error.from_error(e)
@@ -3731,7 +3744,7 @@ module Google
3731
3744
  @data_migration_service_stub.call_rpc :convert_conversion_workspace, request, options: options do |response, operation|
3732
3745
  response = ::Gapic::Operation.new response, @operations_client, options: options
3733
3746
  yield response, operation if block_given?
3734
- return response
3747
+ throw :response, response
3735
3748
  end
3736
3749
  rescue ::GRPC::BadStatus => e
3737
3750
  raise ::Google::Cloud::Error.from_error(e)
@@ -3827,7 +3840,7 @@ module Google
3827
3840
  @data_migration_service_stub.call_rpc :commit_conversion_workspace, request, options: options do |response, operation|
3828
3841
  response = ::Gapic::Operation.new response, @operations_client, options: options
3829
3842
  yield response, operation if block_given?
3830
- return response
3843
+ throw :response, response
3831
3844
  end
3832
3845
  rescue ::GRPC::BadStatus => e
3833
3846
  raise ::Google::Cloud::Error.from_error(e)
@@ -3921,7 +3934,7 @@ module Google
3921
3934
  @data_migration_service_stub.call_rpc :rollback_conversion_workspace, request, options: options do |response, operation|
3922
3935
  response = ::Gapic::Operation.new response, @operations_client, options: options
3923
3936
  yield response, operation if block_given?
3924
- return response
3937
+ throw :response, response
3925
3938
  end
3926
3939
  rescue ::GRPC::BadStatus => e
3927
3940
  raise ::Google::Cloud::Error.from_error(e)
@@ -4030,7 +4043,7 @@ module Google
4030
4043
  @data_migration_service_stub.call_rpc :apply_conversion_workspace, request, options: options do |response, operation|
4031
4044
  response = ::Gapic::Operation.new response, @operations_client, options: options
4032
4045
  yield response, operation if block_given?
4033
- return response
4046
+ throw :response, response
4034
4047
  end
4035
4048
  rescue ::GRPC::BadStatus => e
4036
4049
  raise ::Google::Cloud::Error.from_error(e)
@@ -4151,7 +4164,7 @@ module Google
4151
4164
  @data_migration_service_stub.call_rpc :describe_database_entities, request, options: options do |response, operation|
4152
4165
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :describe_database_entities, request, response, operation, options
4153
4166
  yield response, operation if block_given?
4154
- return response
4167
+ throw :response, response
4155
4168
  end
4156
4169
  rescue ::GRPC::BadStatus => e
4157
4170
  raise ::Google::Cloud::Error.from_error(e)
@@ -4254,7 +4267,6 @@ module Google
4254
4267
 
4255
4268
  @data_migration_service_stub.call_rpc :search_background_jobs, request, options: options do |response, operation|
4256
4269
  yield response, operation if block_given?
4257
- return response
4258
4270
  end
4259
4271
  rescue ::GRPC::BadStatus => e
4260
4272
  raise ::Google::Cloud::Error.from_error(e)
@@ -4345,7 +4357,6 @@ module Google
4345
4357
 
4346
4358
  @data_migration_service_stub.call_rpc :describe_conversion_workspace_revisions, request, options: options do |response, operation|
4347
4359
  yield response, operation if block_given?
4348
- return response
4349
4360
  end
4350
4361
  rescue ::GRPC::BadStatus => e
4351
4362
  raise ::Google::Cloud::Error.from_error(e)
@@ -4437,7 +4448,6 @@ module Google
4437
4448
 
4438
4449
  @data_migration_service_stub.call_rpc :fetch_static_ips, request, options: options do |response, operation|
4439
4450
  yield response, operation if block_given?
4440
- return response
4441
4451
  end
4442
4452
  rescue ::GRPC::BadStatus => e
4443
4453
  raise ::Google::Cloud::Error.from_error(e)
@@ -4526,6 +4536,11 @@ module Google
4526
4536
  # default endpoint URL. The default value of nil uses the environment
4527
4537
  # universe (usually the default "googleapis.com" universe).
4528
4538
  # @return [::String,nil]
4539
+ # @!attribute [rw] logger
4540
+ # A custom logger to use for request/response debug logging, or the value
4541
+ # `:default` (the default) to construct a default logger, or `nil` to
4542
+ # explicitly disable logging.
4543
+ # @return [::Logger,:default,nil]
4529
4544
  #
4530
4545
  class Configuration
4531
4546
  extend ::Gapic::Config
@@ -4550,6 +4565,7 @@ module Google
4550
4565
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
4551
4566
  config_attr :quota_project, nil, ::String, nil
4552
4567
  config_attr :universe_domain, nil, ::String, nil
4568
+ config_attr :logger, :default, ::Logger, nil, :default
4553
4569
 
4554
4570
  # @private
4555
4571
  def initialize parent_config = nil
@@ -124,14 +124,6 @@ module Google
124
124
  # Lists operations that match the specified filter in the request. If the
125
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
126
126
  #
127
- # NOTE: the `name` binding allows API services to override the binding
128
- # to use different resource name schemes, such as `users/*/operations`. To
129
- # override the binding, API services can add a binding such as
130
- # `"/v1/{name=users/*}/operations"` to their service configuration.
131
- # For backwards compatibility, the default name includes the operations
132
- # collection id, however overriding users must ensure the name binding
133
- # is the parent resource, without the operations collection id.
134
- #
135
127
  # @overload list_operations(request, options = nil)
136
128
  # Pass arguments to `list_operations` via a request object, either of type
137
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -221,7 +213,7 @@ module Google
221
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
222
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
223
215
  yield response, operation if block_given?
224
- return response
216
+ throw :response, response
225
217
  end
226
218
  rescue ::GRPC::BadStatus => e
227
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -317,7 +309,7 @@ module Google
317
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
318
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
319
311
  yield response, operation if block_given?
320
- return response
312
+ throw :response, response
321
313
  end
322
314
  rescue ::GRPC::BadStatus => e
323
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -406,7 +398,6 @@ module Google
406
398
 
407
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
408
400
  yield response, operation if block_given?
409
- return response
410
401
  end
411
402
  rescue ::GRPC::BadStatus => e
412
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -421,8 +412,9 @@ module Google
421
412
  # other methods to check whether the cancellation succeeded or whether the
422
413
  # operation completed despite cancellation. On successful cancellation,
423
414
  # the operation is not deleted; instead, it becomes an operation with
424
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
425
- # corresponding to `Code.CANCELLED`.
415
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
416
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
417
+ # `Code.CANCELLED`.
426
418
  #
427
419
  # @overload cancel_operation(request, options = nil)
428
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -501,7 +493,6 @@ module Google
501
493
 
502
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
503
495
  yield response, operation if block_given?
504
- return response
505
496
  end
506
497
  rescue ::GRPC::BadStatus => e
507
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -599,7 +590,7 @@ module Google
599
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
600
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
601
592
  yield response, operation if block_given?
602
- return response
593
+ throw :response, response
603
594
  end
604
595
  rescue ::GRPC::BadStatus => e
605
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -688,6 +679,11 @@ module Google
688
679
  # default endpoint URL. The default value of nil uses the environment
689
680
  # universe (usually the default "googleapis.com" universe).
690
681
  # @return [::String,nil]
682
+ # @!attribute [rw] logger
683
+ # A custom logger to use for request/response debug logging, or the value
684
+ # `:default` (the default) to construct a default logger, or `nil` to
685
+ # explicitly disable logging.
686
+ # @return [::Logger,:default,nil]
691
687
  #
692
688
  class Configuration
693
689
  extend ::Gapic::Config
@@ -712,6 +708,7 @@ module Google
712
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
709
  config_attr :quota_project, nil, ::String, nil
714
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
715
712
 
716
713
  # @private
717
714
  def initialize parent_config = nil
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module CloudDMS
23
23
  module V1
24
- VERSION = "1.0.1"
24
+ VERSION = "1.1.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -42,7 +42,7 @@ module Google
42
42
  # The error result of the operation in case of failure or cancellation.
43
43
  # @!attribute [rw] response
44
44
  # @return [::Google::Protobuf::Any]
45
- # The normal response of the operation in case of success. If the original
45
+ # The normal, successful response of the operation. If the original
46
46
  # method returns no data on success, such as `Delete`, the response is
47
47
  # `google.protobuf.Empty`. If the original method is standard
48
48
  # `Get`/`Create`/`Update`, the response should be the resource. For other
@@ -55,7 +55,8 @@ module Google
55
55
  extend ::Google::Protobuf::MessageExts::ClassMethods
56
56
  end
57
57
 
58
- # The request message for Operations.GetOperation.
58
+ # The request message for
59
+ # Operations.GetOperation.
59
60
  # @!attribute [rw] name
60
61
  # @return [::String]
61
62
  # The name of the operation resource.
@@ -64,7 +65,8 @@ module Google
64
65
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
66
  end
66
67
 
67
- # The request message for Operations.ListOperations.
68
+ # The request message for
69
+ # Operations.ListOperations.
68
70
  # @!attribute [rw] name
69
71
  # @return [::String]
70
72
  # The name of the operation's parent resource.
@@ -82,7 +84,8 @@ module Google
82
84
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
85
  end
84
86
 
85
- # The response message for Operations.ListOperations.
87
+ # The response message for
88
+ # Operations.ListOperations.
86
89
  # @!attribute [rw] operations
87
90
  # @return [::Array<::Google::Longrunning::Operation>]
88
91
  # A list of operations that matches the specified filter in the request.
@@ -94,7 +97,8 @@ module Google
94
97
  extend ::Google::Protobuf::MessageExts::ClassMethods
95
98
  end
96
99
 
97
- # The request message for Operations.CancelOperation.
100
+ # The request message for
101
+ # Operations.CancelOperation.
98
102
  # @!attribute [rw] name
99
103
  # @return [::String]
100
104
  # The name of the operation resource to be cancelled.
@@ -103,7 +107,8 @@ module Google
103
107
  extend ::Google::Protobuf::MessageExts::ClassMethods
104
108
  end
105
109
 
106
- # The request message for Operations.DeleteOperation.
110
+ # The request message for
111
+ # Operations.DeleteOperation.
107
112
  # @!attribute [rw] name
108
113
  # @return [::String]
109
114
  # The name of the operation resource to be deleted.
@@ -112,7 +117,8 @@ module Google
112
117
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
118
  end
114
119
 
115
- # The request message for Operations.WaitOperation.
120
+ # The request message for
121
+ # Operations.WaitOperation.
116
122
  # @!attribute [rw] name
117
123
  # @return [::String]
118
124
  # The name of the operation resource to wait on.
@@ -130,13 +136,12 @@ module Google
130
136
  #
131
137
  # Example:
132
138
  #
133
- # rpc LongRunningRecognize(LongRunningRecognizeRequest)
134
- # returns (google.longrunning.Operation) {
135
- # option (google.longrunning.operation_info) = {
136
- # response_type: "LongRunningRecognizeResponse"
137
- # metadata_type: "LongRunningRecognizeMetadata"
138
- # };
139
- # }
139
+ # rpc Export(ExportRequest) returns (google.longrunning.Operation) {
140
+ # option (google.longrunning.operation_info) = {
141
+ # response_type: "ExportResponse"
142
+ # metadata_type: "ExportMetadata"
143
+ # };
144
+ # }
140
145
  # @!attribute [rw] response_type
141
146
  # @return [::String]
142
147
  # Required. The message name of the primary return type for this
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-cloud_dms-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -148,7 +148,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
148
148
  - !ruby/object:Gem::Version
149
149
  version: '0'
150
150
  requirements: []
151
- rubygems_version: 3.5.6
151
+ rubygems_version: 3.5.23
152
152
  signing_key:
153
153
  specification_version: 4
154
154
  summary: Manage Cloud Database Migration Service resources on Google Cloud Platform.