google-cloud-vm_migration-v1 1.0.2 → 1.2.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: 9831084c982b12b244fd42e4211fb3d1a17255938340da7ea86c0d9e134268c1
4
- data.tar.gz: 354564835da4b1df28832b557ea4741c4d8717343758fae7626042c8c678d4e7
3
+ metadata.gz: '03229bb7a7bf25ce95a6f8cf79de6def826866614a960667abcea7bb3e2b3d4e'
4
+ data.tar.gz: 3558f4f0013f26d45993284b7352f1bc84fcf73d84d00ff8166624ff339bb57f
5
5
  SHA512:
6
- metadata.gz: 38a582144bee6e3a0804ddbc7e89809650a1d975261cbe00ddd84ef4a97860e9d3f94c16659443cb747076196a0f897a0ea03d1dcc1d21e4217184f0738eb3aa
7
- data.tar.gz: 72c9938ab916743c9c8eeef4b619e813bb38b50ea6cc4d0806dad17a9324be6f75c71c252e93b41696727475428b36cca3fa0e6a1aa043547304ed9ece19690b
6
+ metadata.gz: 832401c0f065b8ba3fc882f4bef8f9d3bebd05cfd931d8a9f6e28c86e7f62d7800a8fdb487e99efb358c070dc894003c0d2aaeb4dc4ddf9a3e476a1e984decdc
7
+ data.tar.gz: 3083b07f58eba8d83ceef6f72ad15e2b71d658076302134646d7903bb6aa4d1febdc0ee62219710c865108b313a116c55566e3d4472083453d6db41d874af288
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/migrate/compute-engine/)
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/vm_migration/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::VMMigration::V1::VMMigration::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).
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module VMMigration
23
23
  module V1
24
- VERSION = "1.0.2"
24
+ VERSION = "1.2.0"
25
25
  end
26
26
  end
27
27
  end
@@ -174,14 +174,26 @@ module Google
174
174
  universe_domain: @config.universe_domain,
175
175
  channel_args: @config.channel_args,
176
176
  interceptors: @config.interceptors,
177
- channel_pool_config: @config.channel_pool
177
+ channel_pool_config: @config.channel_pool,
178
+ logger: @config.logger
178
179
  )
179
180
 
181
+ @vm_migration_stub.stub_logger&.info do |entry|
182
+ entry.set_system_name
183
+ entry.set_service
184
+ entry.message = "Created client for #{entry.service}"
185
+ entry.set_credentials_fields credentials
186
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
187
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
188
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
189
+ end
190
+
180
191
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
181
192
  config.credentials = credentials
182
193
  config.quota_project = @quota_project_id
183
194
  config.endpoint = @vm_migration_stub.endpoint
184
195
  config.universe_domain = @vm_migration_stub.universe_domain
196
+ config.logger = @vm_migration_stub.logger if config.respond_to? :logger=
185
197
  end
186
198
 
187
199
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -189,6 +201,7 @@ module Google
189
201
  config.quota_project = @quota_project_id
190
202
  config.endpoint = @vm_migration_stub.endpoint
191
203
  config.universe_domain = @vm_migration_stub.universe_domain
204
+ config.logger = @vm_migration_stub.logger if config.respond_to? :logger=
192
205
  end
193
206
  end
194
207
 
@@ -213,6 +226,15 @@ module Google
213
226
  #
214
227
  attr_reader :iam_policy_client
215
228
 
229
+ ##
230
+ # The logger used for request/response debug logging.
231
+ #
232
+ # @return [Logger]
233
+ #
234
+ def logger
235
+ @vm_migration_stub.logger
236
+ end
237
+
216
238
  # Service calls
217
239
 
218
240
  ##
@@ -315,7 +337,7 @@ module Google
315
337
  @vm_migration_stub.call_rpc :list_sources, request, options: options do |response, operation|
316
338
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_sources, request, response, operation, options
317
339
  yield response, operation if block_given?
318
- return response
340
+ throw :response, response
319
341
  end
320
342
  rescue ::GRPC::BadStatus => e
321
343
  raise ::Google::Cloud::Error.from_error(e)
@@ -401,7 +423,6 @@ module Google
401
423
 
402
424
  @vm_migration_stub.call_rpc :get_source, request, options: options do |response, operation|
403
425
  yield response, operation if block_given?
404
- return response
405
426
  end
406
427
  rescue ::GRPC::BadStatus => e
407
428
  raise ::Google::Cloud::Error.from_error(e)
@@ -513,7 +534,7 @@ module Google
513
534
  @vm_migration_stub.call_rpc :create_source, request, options: options do |response, operation|
514
535
  response = ::Gapic::Operation.new response, @operations_client, options: options
515
536
  yield response, operation if block_given?
516
- return response
537
+ throw :response, response
517
538
  end
518
539
  rescue ::GRPC::BadStatus => e
519
540
  raise ::Google::Cloud::Error.from_error(e)
@@ -627,7 +648,7 @@ module Google
627
648
  @vm_migration_stub.call_rpc :update_source, request, options: options do |response, operation|
628
649
  response = ::Gapic::Operation.new response, @operations_client, options: options
629
650
  yield response, operation if block_given?
630
- return response
651
+ throw :response, response
631
652
  end
632
653
  rescue ::GRPC::BadStatus => e
633
654
  raise ::Google::Cloud::Error.from_error(e)
@@ -735,7 +756,7 @@ module Google
735
756
  @vm_migration_stub.call_rpc :delete_source, request, options: options do |response, operation|
736
757
  response = ::Gapic::Operation.new response, @operations_client, options: options
737
758
  yield response, operation if block_given?
738
- return response
759
+ throw :response, response
739
760
  end
740
761
  rescue ::GRPC::BadStatus => e
741
762
  raise ::Google::Cloud::Error.from_error(e)
@@ -828,7 +849,6 @@ module Google
828
849
 
829
850
  @vm_migration_stub.call_rpc :fetch_inventory, request, options: options do |response, operation|
830
851
  yield response, operation if block_given?
831
- return response
832
852
  end
833
853
  rescue ::GRPC::BadStatus => e
834
854
  raise ::Google::Cloud::Error.from_error(e)
@@ -937,7 +957,7 @@ module Google
937
957
  @vm_migration_stub.call_rpc :list_utilization_reports, request, options: options do |response, operation|
938
958
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_utilization_reports, request, response, operation, options
939
959
  yield response, operation if block_given?
940
- return response
960
+ throw :response, response
941
961
  end
942
962
  rescue ::GRPC::BadStatus => e
943
963
  raise ::Google::Cloud::Error.from_error(e)
@@ -1026,7 +1046,6 @@ module Google
1026
1046
 
1027
1047
  @vm_migration_stub.call_rpc :get_utilization_report, request, options: options do |response, operation|
1028
1048
  yield response, operation if block_given?
1029
- return response
1030
1049
  end
1031
1050
  rescue ::GRPC::BadStatus => e
1032
1051
  raise ::Google::Cloud::Error.from_error(e)
@@ -1143,7 +1162,7 @@ module Google
1143
1162
  @vm_migration_stub.call_rpc :create_utilization_report, request, options: options do |response, operation|
1144
1163
  response = ::Gapic::Operation.new response, @operations_client, options: options
1145
1164
  yield response, operation if block_given?
1146
- return response
1165
+ throw :response, response
1147
1166
  end
1148
1167
  rescue ::GRPC::BadStatus => e
1149
1168
  raise ::Google::Cloud::Error.from_error(e)
@@ -1251,7 +1270,7 @@ module Google
1251
1270
  @vm_migration_stub.call_rpc :delete_utilization_report, request, options: options do |response, operation|
1252
1271
  response = ::Gapic::Operation.new response, @operations_client, options: options
1253
1272
  yield response, operation if block_given?
1254
- return response
1273
+ throw :response, response
1255
1274
  end
1256
1275
  rescue ::GRPC::BadStatus => e
1257
1276
  raise ::Google::Cloud::Error.from_error(e)
@@ -1358,7 +1377,7 @@ module Google
1358
1377
  @vm_migration_stub.call_rpc :list_datacenter_connectors, request, options: options do |response, operation|
1359
1378
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_datacenter_connectors, request, response, operation, options
1360
1379
  yield response, operation if block_given?
1361
- return response
1380
+ throw :response, response
1362
1381
  end
1363
1382
  rescue ::GRPC::BadStatus => e
1364
1383
  raise ::Google::Cloud::Error.from_error(e)
@@ -1444,7 +1463,6 @@ module Google
1444
1463
 
1445
1464
  @vm_migration_stub.call_rpc :get_datacenter_connector, request, options: options do |response, operation|
1446
1465
  yield response, operation if block_given?
1447
- return response
1448
1466
  end
1449
1467
  rescue ::GRPC::BadStatus => e
1450
1468
  raise ::Google::Cloud::Error.from_error(e)
@@ -1559,7 +1577,7 @@ module Google
1559
1577
  @vm_migration_stub.call_rpc :create_datacenter_connector, request, options: options do |response, operation|
1560
1578
  response = ::Gapic::Operation.new response, @operations_client, options: options
1561
1579
  yield response, operation if block_given?
1562
- return response
1580
+ throw :response, response
1563
1581
  end
1564
1582
  rescue ::GRPC::BadStatus => e
1565
1583
  raise ::Google::Cloud::Error.from_error(e)
@@ -1667,7 +1685,7 @@ module Google
1667
1685
  @vm_migration_stub.call_rpc :delete_datacenter_connector, request, options: options do |response, operation|
1668
1686
  response = ::Gapic::Operation.new response, @operations_client, options: options
1669
1687
  yield response, operation if block_given?
1670
- return response
1688
+ throw :response, response
1671
1689
  end
1672
1690
  rescue ::GRPC::BadStatus => e
1673
1691
  raise ::Google::Cloud::Error.from_error(e)
@@ -1776,7 +1794,7 @@ module Google
1776
1794
  @vm_migration_stub.call_rpc :upgrade_appliance, request, options: options do |response, operation|
1777
1795
  response = ::Gapic::Operation.new response, @operations_client, options: options
1778
1796
  yield response, operation if block_given?
1779
- return response
1797
+ throw :response, response
1780
1798
  end
1781
1799
  rescue ::GRPC::BadStatus => e
1782
1800
  raise ::Google::Cloud::Error.from_error(e)
@@ -1888,7 +1906,7 @@ module Google
1888
1906
  @vm_migration_stub.call_rpc :create_migrating_vm, request, options: options do |response, operation|
1889
1907
  response = ::Gapic::Operation.new response, @operations_client, options: options
1890
1908
  yield response, operation if block_given?
1891
- return response
1909
+ throw :response, response
1892
1910
  end
1893
1911
  rescue ::GRPC::BadStatus => e
1894
1912
  raise ::Google::Cloud::Error.from_error(e)
@@ -1996,7 +2014,7 @@ module Google
1996
2014
  @vm_migration_stub.call_rpc :list_migrating_vms, request, options: options do |response, operation|
1997
2015
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_migrating_vms, request, response, operation, options
1998
2016
  yield response, operation if block_given?
1999
- return response
2017
+ throw :response, response
2000
2018
  end
2001
2019
  rescue ::GRPC::BadStatus => e
2002
2020
  raise ::Google::Cloud::Error.from_error(e)
@@ -2084,7 +2102,6 @@ module Google
2084
2102
 
2085
2103
  @vm_migration_stub.call_rpc :get_migrating_vm, request, options: options do |response, operation|
2086
2104
  yield response, operation if block_given?
2087
- return response
2088
2105
  end
2089
2106
  rescue ::GRPC::BadStatus => e
2090
2107
  raise ::Google::Cloud::Error.from_error(e)
@@ -2198,7 +2215,7 @@ module Google
2198
2215
  @vm_migration_stub.call_rpc :update_migrating_vm, request, options: options do |response, operation|
2199
2216
  response = ::Gapic::Operation.new response, @operations_client, options: options
2200
2217
  yield response, operation if block_given?
2201
- return response
2218
+ throw :response, response
2202
2219
  end
2203
2220
  rescue ::GRPC::BadStatus => e
2204
2221
  raise ::Google::Cloud::Error.from_error(e)
@@ -2292,7 +2309,7 @@ module Google
2292
2309
  @vm_migration_stub.call_rpc :delete_migrating_vm, request, options: options do |response, operation|
2293
2310
  response = ::Gapic::Operation.new response, @operations_client, options: options
2294
2311
  yield response, operation if block_given?
2295
- return response
2312
+ throw :response, response
2296
2313
  end
2297
2314
  rescue ::GRPC::BadStatus => e
2298
2315
  raise ::Google::Cloud::Error.from_error(e)
@@ -2387,7 +2404,7 @@ module Google
2387
2404
  @vm_migration_stub.call_rpc :start_migration, request, options: options do |response, operation|
2388
2405
  response = ::Gapic::Operation.new response, @operations_client, options: options
2389
2406
  yield response, operation if block_given?
2390
- return response
2407
+ throw :response, response
2391
2408
  end
2392
2409
  rescue ::GRPC::BadStatus => e
2393
2410
  raise ::Google::Cloud::Error.from_error(e)
@@ -2484,7 +2501,7 @@ module Google
2484
2501
  @vm_migration_stub.call_rpc :resume_migration, request, options: options do |response, operation|
2485
2502
  response = ::Gapic::Operation.new response, @operations_client, options: options
2486
2503
  yield response, operation if block_given?
2487
- return response
2504
+ throw :response, response
2488
2505
  end
2489
2506
  rescue ::GRPC::BadStatus => e
2490
2507
  raise ::Google::Cloud::Error.from_error(e)
@@ -2580,7 +2597,7 @@ module Google
2580
2597
  @vm_migration_stub.call_rpc :pause_migration, request, options: options do |response, operation|
2581
2598
  response = ::Gapic::Operation.new response, @operations_client, options: options
2582
2599
  yield response, operation if block_given?
2583
- return response
2600
+ throw :response, response
2584
2601
  end
2585
2602
  rescue ::GRPC::BadStatus => e
2586
2603
  raise ::Google::Cloud::Error.from_error(e)
@@ -2675,7 +2692,7 @@ module Google
2675
2692
  @vm_migration_stub.call_rpc :finalize_migration, request, options: options do |response, operation|
2676
2693
  response = ::Gapic::Operation.new response, @operations_client, options: options
2677
2694
  yield response, operation if block_given?
2678
- return response
2695
+ throw :response, response
2679
2696
  end
2680
2697
  rescue ::GRPC::BadStatus => e
2681
2698
  raise ::Google::Cloud::Error.from_error(e)
@@ -2787,7 +2804,7 @@ module Google
2787
2804
  @vm_migration_stub.call_rpc :create_clone_job, request, options: options do |response, operation|
2788
2805
  response = ::Gapic::Operation.new response, @operations_client, options: options
2789
2806
  yield response, operation if block_given?
2790
- return response
2807
+ throw :response, response
2791
2808
  end
2792
2809
  rescue ::GRPC::BadStatus => e
2793
2810
  raise ::Google::Cloud::Error.from_error(e)
@@ -2881,7 +2898,7 @@ module Google
2881
2898
  @vm_migration_stub.call_rpc :cancel_clone_job, request, options: options do |response, operation|
2882
2899
  response = ::Gapic::Operation.new response, @operations_client, options: options
2883
2900
  yield response, operation if block_given?
2884
- return response
2901
+ throw :response, response
2885
2902
  end
2886
2903
  rescue ::GRPC::BadStatus => e
2887
2904
  raise ::Google::Cloud::Error.from_error(e)
@@ -2987,7 +3004,7 @@ module Google
2987
3004
  @vm_migration_stub.call_rpc :list_clone_jobs, request, options: options do |response, operation|
2988
3005
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_clone_jobs, request, response, operation, options
2989
3006
  yield response, operation if block_given?
2990
- return response
3007
+ throw :response, response
2991
3008
  end
2992
3009
  rescue ::GRPC::BadStatus => e
2993
3010
  raise ::Google::Cloud::Error.from_error(e)
@@ -3073,7 +3090,6 @@ module Google
3073
3090
 
3074
3091
  @vm_migration_stub.call_rpc :get_clone_job, request, options: options do |response, operation|
3075
3092
  yield response, operation if block_given?
3076
- return response
3077
3093
  end
3078
3094
  rescue ::GRPC::BadStatus => e
3079
3095
  raise ::Google::Cloud::Error.from_error(e)
@@ -3187,7 +3203,7 @@ module Google
3187
3203
  @vm_migration_stub.call_rpc :create_cutover_job, request, options: options do |response, operation|
3188
3204
  response = ::Gapic::Operation.new response, @operations_client, options: options
3189
3205
  yield response, operation if block_given?
3190
- return response
3206
+ throw :response, response
3191
3207
  end
3192
3208
  rescue ::GRPC::BadStatus => e
3193
3209
  raise ::Google::Cloud::Error.from_error(e)
@@ -3281,7 +3297,7 @@ module Google
3281
3297
  @vm_migration_stub.call_rpc :cancel_cutover_job, request, options: options do |response, operation|
3282
3298
  response = ::Gapic::Operation.new response, @operations_client, options: options
3283
3299
  yield response, operation if block_given?
3284
- return response
3300
+ throw :response, response
3285
3301
  end
3286
3302
  rescue ::GRPC::BadStatus => e
3287
3303
  raise ::Google::Cloud::Error.from_error(e)
@@ -3387,7 +3403,7 @@ module Google
3387
3403
  @vm_migration_stub.call_rpc :list_cutover_jobs, request, options: options do |response, operation|
3388
3404
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_cutover_jobs, request, response, operation, options
3389
3405
  yield response, operation if block_given?
3390
- return response
3406
+ throw :response, response
3391
3407
  end
3392
3408
  rescue ::GRPC::BadStatus => e
3393
3409
  raise ::Google::Cloud::Error.from_error(e)
@@ -3473,7 +3489,6 @@ module Google
3473
3489
 
3474
3490
  @vm_migration_stub.call_rpc :get_cutover_job, request, options: options do |response, operation|
3475
3491
  yield response, operation if block_given?
3476
- return response
3477
3492
  end
3478
3493
  rescue ::GRPC::BadStatus => e
3479
3494
  raise ::Google::Cloud::Error.from_error(e)
@@ -3579,7 +3594,7 @@ module Google
3579
3594
  @vm_migration_stub.call_rpc :list_groups, request, options: options do |response, operation|
3580
3595
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_groups, request, response, operation, options
3581
3596
  yield response, operation if block_given?
3582
- return response
3597
+ throw :response, response
3583
3598
  end
3584
3599
  rescue ::GRPC::BadStatus => e
3585
3600
  raise ::Google::Cloud::Error.from_error(e)
@@ -3665,7 +3680,6 @@ module Google
3665
3680
 
3666
3681
  @vm_migration_stub.call_rpc :get_group, request, options: options do |response, operation|
3667
3682
  yield response, operation if block_given?
3668
- return response
3669
3683
  end
3670
3684
  rescue ::GRPC::BadStatus => e
3671
3685
  raise ::Google::Cloud::Error.from_error(e)
@@ -3777,7 +3791,7 @@ module Google
3777
3791
  @vm_migration_stub.call_rpc :create_group, request, options: options do |response, operation|
3778
3792
  response = ::Gapic::Operation.new response, @operations_client, options: options
3779
3793
  yield response, operation if block_given?
3780
- return response
3794
+ throw :response, response
3781
3795
  end
3782
3796
  rescue ::GRPC::BadStatus => e
3783
3797
  raise ::Google::Cloud::Error.from_error(e)
@@ -3891,7 +3905,7 @@ module Google
3891
3905
  @vm_migration_stub.call_rpc :update_group, request, options: options do |response, operation|
3892
3906
  response = ::Gapic::Operation.new response, @operations_client, options: options
3893
3907
  yield response, operation if block_given?
3894
- return response
3908
+ throw :response, response
3895
3909
  end
3896
3910
  rescue ::GRPC::BadStatus => e
3897
3911
  raise ::Google::Cloud::Error.from_error(e)
@@ -3999,7 +4013,7 @@ module Google
3999
4013
  @vm_migration_stub.call_rpc :delete_group, request, options: options do |response, operation|
4000
4014
  response = ::Gapic::Operation.new response, @operations_client, options: options
4001
4015
  yield response, operation if block_given?
4002
- return response
4016
+ throw :response, response
4003
4017
  end
4004
4018
  rescue ::GRPC::BadStatus => e
4005
4019
  raise ::Google::Cloud::Error.from_error(e)
@@ -4095,7 +4109,7 @@ module Google
4095
4109
  @vm_migration_stub.call_rpc :add_group_migration, request, options: options do |response, operation|
4096
4110
  response = ::Gapic::Operation.new response, @operations_client, options: options
4097
4111
  yield response, operation if block_given?
4098
- return response
4112
+ throw :response, response
4099
4113
  end
4100
4114
  rescue ::GRPC::BadStatus => e
4101
4115
  raise ::Google::Cloud::Error.from_error(e)
@@ -4191,7 +4205,7 @@ module Google
4191
4205
  @vm_migration_stub.call_rpc :remove_group_migration, request, options: options do |response, operation|
4192
4206
  response = ::Gapic::Operation.new response, @operations_client, options: options
4193
4207
  yield response, operation if block_given?
4194
- return response
4208
+ throw :response, response
4195
4209
  end
4196
4210
  rescue ::GRPC::BadStatus => e
4197
4211
  raise ::Google::Cloud::Error.from_error(e)
@@ -4300,7 +4314,7 @@ module Google
4300
4314
  @vm_migration_stub.call_rpc :list_target_projects, request, options: options do |response, operation|
4301
4315
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_target_projects, request, response, operation, options
4302
4316
  yield response, operation if block_given?
4303
- return response
4317
+ throw :response, response
4304
4318
  end
4305
4319
  rescue ::GRPC::BadStatus => e
4306
4320
  raise ::Google::Cloud::Error.from_error(e)
@@ -4389,7 +4403,6 @@ module Google
4389
4403
 
4390
4404
  @vm_migration_stub.call_rpc :get_target_project, request, options: options do |response, operation|
4391
4405
  yield response, operation if block_given?
4392
- return response
4393
4406
  end
4394
4407
  rescue ::GRPC::BadStatus => e
4395
4408
  raise ::Google::Cloud::Error.from_error(e)
@@ -4504,7 +4517,7 @@ module Google
4504
4517
  @vm_migration_stub.call_rpc :create_target_project, request, options: options do |response, operation|
4505
4518
  response = ::Gapic::Operation.new response, @operations_client, options: options
4506
4519
  yield response, operation if block_given?
4507
- return response
4520
+ throw :response, response
4508
4521
  end
4509
4522
  rescue ::GRPC::BadStatus => e
4510
4523
  raise ::Google::Cloud::Error.from_error(e)
@@ -4621,7 +4634,7 @@ module Google
4621
4634
  @vm_migration_stub.call_rpc :update_target_project, request, options: options do |response, operation|
4622
4635
  response = ::Gapic::Operation.new response, @operations_client, options: options
4623
4636
  yield response, operation if block_given?
4624
- return response
4637
+ throw :response, response
4625
4638
  end
4626
4639
  rescue ::GRPC::BadStatus => e
4627
4640
  raise ::Google::Cloud::Error.from_error(e)
@@ -4732,7 +4745,7 @@ module Google
4732
4745
  @vm_migration_stub.call_rpc :delete_target_project, request, options: options do |response, operation|
4733
4746
  response = ::Gapic::Operation.new response, @operations_client, options: options
4734
4747
  yield response, operation if block_given?
4735
- return response
4748
+ throw :response, response
4736
4749
  end
4737
4750
  rescue ::GRPC::BadStatus => e
4738
4751
  raise ::Google::Cloud::Error.from_error(e)
@@ -4838,7 +4851,7 @@ module Google
4838
4851
  @vm_migration_stub.call_rpc :list_replication_cycles, request, options: options do |response, operation|
4839
4852
  response = ::Gapic::PagedEnumerable.new @vm_migration_stub, :list_replication_cycles, request, response, operation, options
4840
4853
  yield response, operation if block_given?
4841
- return response
4854
+ throw :response, response
4842
4855
  end
4843
4856
  rescue ::GRPC::BadStatus => e
4844
4857
  raise ::Google::Cloud::Error.from_error(e)
@@ -4924,7 +4937,6 @@ module Google
4924
4937
 
4925
4938
  @vm_migration_stub.call_rpc :get_replication_cycle, request, options: options do |response, operation|
4926
4939
  yield response, operation if block_given?
4927
- return response
4928
4940
  end
4929
4941
  rescue ::GRPC::BadStatus => e
4930
4942
  raise ::Google::Cloud::Error.from_error(e)
@@ -5013,6 +5025,11 @@ module Google
5013
5025
  # default endpoint URL. The default value of nil uses the environment
5014
5026
  # universe (usually the default "googleapis.com" universe).
5015
5027
  # @return [::String,nil]
5028
+ # @!attribute [rw] logger
5029
+ # A custom logger to use for request/response debug logging, or the value
5030
+ # `:default` (the default) to construct a default logger, or `nil` to
5031
+ # explicitly disable logging.
5032
+ # @return [::Logger,:default,nil]
5016
5033
  #
5017
5034
  class Configuration
5018
5035
  extend ::Gapic::Config
@@ -5037,6 +5054,7 @@ module Google
5037
5054
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
5038
5055
  config_attr :quota_project, nil, ::String, nil
5039
5056
  config_attr :universe_domain, nil, ::String, nil
5057
+ config_attr :logger, :default, ::Logger, nil, :default
5040
5058
 
5041
5059
  # @private
5042
5060
  def initialize parent_config = nil
@@ -213,7 +213,7 @@ module Google
213
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
214
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
215
215
  yield response, operation if block_given?
216
- return response
216
+ throw :response, response
217
217
  end
218
218
  rescue ::GRPC::BadStatus => e
219
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -309,7 +309,7 @@ module Google
309
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
310
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
311
311
  yield response, operation if block_given?
312
- return response
312
+ throw :response, response
313
313
  end
314
314
  rescue ::GRPC::BadStatus => e
315
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +398,6 @@ module Google
398
398
 
399
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
400
400
  yield response, operation if block_given?
401
- return response
402
401
  end
403
402
  rescue ::GRPC::BadStatus => e
404
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -494,7 +493,6 @@ module Google
494
493
 
495
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
496
495
  yield response, operation if block_given?
497
- return response
498
496
  end
499
497
  rescue ::GRPC::BadStatus => e
500
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -592,7 +590,7 @@ module Google
592
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
593
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
594
592
  yield response, operation if block_given?
595
- return response
593
+ throw :response, response
596
594
  end
597
595
  rescue ::GRPC::BadStatus => e
598
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -681,6 +679,11 @@ module Google
681
679
  # default endpoint URL. The default value of nil uses the environment
682
680
  # universe (usually the default "googleapis.com" universe).
683
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]
684
687
  #
685
688
  class Configuration
686
689
  extend ::Gapic::Config
@@ -705,6 +708,7 @@ module Google
705
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
706
709
  config_attr :quota_project, nil, ::String, nil
707
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
708
712
 
709
713
  # @private
710
714
  def initialize parent_config = nil