google-cloud-dataplex-v1 1.1.0 → 1.3.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.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dataplex/v1/catalog_service/client.rb +52 -28
  4. data/lib/google/cloud/dataplex/v1/catalog_service/operations.rb +9 -5
  5. data/lib/google/cloud/dataplex/v1/catalog_service/rest/client.rb +47 -28
  6. data/lib/google/cloud/dataplex/v1/catalog_service/rest/operations.rb +40 -28
  7. data/lib/google/cloud/dataplex/v1/catalog_service/rest/service_stub.rb +222 -158
  8. data/lib/google/cloud/dataplex/v1/content_service/client.rb +30 -9
  9. data/lib/google/cloud/dataplex/v1/content_service/rest/client.rb +30 -9
  10. data/lib/google/cloud/dataplex/v1/content_service/rest/service_stub.rb +78 -50
  11. data/lib/google/cloud/dataplex/v1/data_scan_service/client.rb +40 -12
  12. data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb +9 -5
  13. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb +39 -12
  14. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb +40 -28
  15. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/service_stub.rb +86 -56
  16. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/client.rb +41 -16
  17. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/operations.rb +9 -5
  18. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/client.rb +38 -16
  19. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/operations.rb +40 -28
  20. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/service_stub.rb +134 -92
  21. data/lib/google/cloud/dataplex/v1/dataplex_service/client.rb +54 -34
  22. data/lib/google/cloud/dataplex/v1/dataplex_service/operations.rb +9 -5
  23. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/client.rb +52 -34
  24. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/operations.rb +40 -28
  25. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/service_stub.rb +278 -200
  26. data/lib/google/cloud/dataplex/v1/datascans_pb.rb +2 -1
  27. data/lib/google/cloud/dataplex/v1/metadata_service/client.rb +31 -10
  28. data/lib/google/cloud/dataplex/v1/metadata_service/rest/client.rb +31 -10
  29. data/lib/google/cloud/dataplex/v1/metadata_service/rest/service_stub.rb +86 -56
  30. data/lib/google/cloud/dataplex/v1/version.rb +1 -1
  31. data/proto_docs/google/api/client.rb +19 -0
  32. data/proto_docs/google/cloud/dataplex/v1/catalog.rb +10 -4
  33. data/proto_docs/google/cloud/dataplex/v1/datascans.rb +12 -6
  34. metadata +5 -8
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8199b32999dc9749b2eff414aa2f18ba50e84f121ad117b66b4de7d916d20611
4
- data.tar.gz: c717930fdcc0f434cb9f194f6f0485d9b86fa2ac42acb653410e2bb5c6605e90
3
+ metadata.gz: 820a8268e10f1193e2396817ac7dfed8e49d47bdd0f974903ea47503dc03ceed
4
+ data.tar.gz: 22e258cd85ab9f78ad19bda33b36981a8366489967dd7a4a8f52e49a7be0b1e4
5
5
  SHA512:
6
- metadata.gz: 8453db4104f819fb2b52b1f1b354686455fcfc111ba1f4ca702687e3d5625432d949f65a7bd755cd4c78c9fa28199865cb307af7972d0d7a76bf49a6ce6802bb
7
- data.tar.gz: 30e2446fbd0308d955c6a090bed0fd22b0dd8cb2b2ee0e6539dfde200071d6b2f4ca189cd3b534cb63a189b523e3a616fef6471d55a0dd6bc8b65df09e59bf01
6
+ metadata.gz: 6a8e595b2ce16afb663014617d2afb74cbd892a9386f93bd4cc64e9a1e2bf8909d1a98b05238ab106777f7b99d99790f862f7d0dd9e74e9f1bef536e9064dee0
7
+ data.tar.gz: 047edde70f8afeaa2fbcd15d0a8a7e5d6526e3fd2b50d21da35166349ceff5159d8c35e6fa86de7b445f29ab825037fa0614aa56c4460e91ac7e722388c8a0d8
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/dataplex/)
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/dataplex/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::Dataplex::V1::DataplexService::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).
@@ -247,14 +247,26 @@ module Google
247
247
  universe_domain: @config.universe_domain,
248
248
  channel_args: @config.channel_args,
249
249
  interceptors: @config.interceptors,
250
- channel_pool_config: @config.channel_pool
250
+ channel_pool_config: @config.channel_pool,
251
+ logger: @config.logger
251
252
  )
252
253
 
254
+ @catalog_service_stub.stub_logger&.info do |entry|
255
+ entry.set_system_name
256
+ entry.set_service
257
+ entry.message = "Created client for #{entry.service}"
258
+ entry.set_credentials_fields credentials
259
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
260
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
261
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
262
+ end
263
+
253
264
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
254
265
  config.credentials = credentials
255
266
  config.quota_project = @quota_project_id
256
267
  config.endpoint = @catalog_service_stub.endpoint
257
268
  config.universe_domain = @catalog_service_stub.universe_domain
269
+ config.logger = @catalog_service_stub.logger if config.respond_to? :logger=
258
270
  end
259
271
 
260
272
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -262,6 +274,7 @@ module Google
262
274
  config.quota_project = @quota_project_id
263
275
  config.endpoint = @catalog_service_stub.endpoint
264
276
  config.universe_domain = @catalog_service_stub.universe_domain
277
+ config.logger = @catalog_service_stub.logger if config.respond_to? :logger=
265
278
  end
266
279
  end
267
280
 
@@ -286,6 +299,15 @@ module Google
286
299
  #
287
300
  attr_reader :iam_policy_client
288
301
 
302
+ ##
303
+ # The logger used for request/response debug logging.
304
+ #
305
+ # @return [Logger]
306
+ #
307
+ def logger
308
+ @catalog_service_stub.logger
309
+ end
310
+
289
311
  # Service calls
290
312
 
291
313
  ##
@@ -385,7 +407,7 @@ module Google
385
407
  @catalog_service_stub.call_rpc :create_entry_type, request, options: options do |response, operation|
386
408
  response = ::Gapic::Operation.new response, @operations_client, options: options
387
409
  yield response, operation if block_given?
388
- return response
410
+ throw :response, response
389
411
  end
390
412
  rescue ::GRPC::BadStatus => e
391
413
  raise ::Google::Cloud::Error.from_error(e)
@@ -484,7 +506,7 @@ module Google
484
506
  @catalog_service_stub.call_rpc :update_entry_type, request, options: options do |response, operation|
485
507
  response = ::Gapic::Operation.new response, @operations_client, options: options
486
508
  yield response, operation if block_given?
487
- return response
509
+ throw :response, response
488
510
  end
489
511
  rescue ::GRPC::BadStatus => e
490
512
  raise ::Google::Cloud::Error.from_error(e)
@@ -582,7 +604,7 @@ module Google
582
604
  @catalog_service_stub.call_rpc :delete_entry_type, request, options: options do |response, operation|
583
605
  response = ::Gapic::Operation.new response, @operations_client, options: options
584
606
  yield response, operation if block_given?
585
- return response
607
+ throw :response, response
586
608
  end
587
609
  rescue ::GRPC::BadStatus => e
588
610
  raise ::Google::Cloud::Error.from_error(e)
@@ -697,7 +719,7 @@ module Google
697
719
  @catalog_service_stub.call_rpc :list_entry_types, request, options: options do |response, operation|
698
720
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :list_entry_types, request, response, operation, options
699
721
  yield response, operation if block_given?
700
- return response
722
+ throw :response, response
701
723
  end
702
724
  rescue ::GRPC::BadStatus => e
703
725
  raise ::Google::Cloud::Error.from_error(e)
@@ -784,7 +806,6 @@ module Google
784
806
 
785
807
  @catalog_service_stub.call_rpc :get_entry_type, request, options: options do |response, operation|
786
808
  yield response, operation if block_given?
787
- return response
788
809
  end
789
810
  rescue ::GRPC::BadStatus => e
790
811
  raise ::Google::Cloud::Error.from_error(e)
@@ -887,7 +908,7 @@ module Google
887
908
  @catalog_service_stub.call_rpc :create_aspect_type, request, options: options do |response, operation|
888
909
  response = ::Gapic::Operation.new response, @operations_client, options: options
889
910
  yield response, operation if block_given?
890
- return response
911
+ throw :response, response
891
912
  end
892
913
  rescue ::GRPC::BadStatus => e
893
914
  raise ::Google::Cloud::Error.from_error(e)
@@ -986,7 +1007,7 @@ module Google
986
1007
  @catalog_service_stub.call_rpc :update_aspect_type, request, options: options do |response, operation|
987
1008
  response = ::Gapic::Operation.new response, @operations_client, options: options
988
1009
  yield response, operation if block_given?
989
- return response
1010
+ throw :response, response
990
1011
  end
991
1012
  rescue ::GRPC::BadStatus => e
992
1013
  raise ::Google::Cloud::Error.from_error(e)
@@ -1085,7 +1106,7 @@ module Google
1085
1106
  @catalog_service_stub.call_rpc :delete_aspect_type, request, options: options do |response, operation|
1086
1107
  response = ::Gapic::Operation.new response, @operations_client, options: options
1087
1108
  yield response, operation if block_given?
1088
- return response
1109
+ throw :response, response
1089
1110
  end
1090
1111
  rescue ::GRPC::BadStatus => e
1091
1112
  raise ::Google::Cloud::Error.from_error(e)
@@ -1200,7 +1221,7 @@ module Google
1200
1221
  @catalog_service_stub.call_rpc :list_aspect_types, request, options: options do |response, operation|
1201
1222
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :list_aspect_types, request, response, operation, options
1202
1223
  yield response, operation if block_given?
1203
- return response
1224
+ throw :response, response
1204
1225
  end
1205
1226
  rescue ::GRPC::BadStatus => e
1206
1227
  raise ::Google::Cloud::Error.from_error(e)
@@ -1287,7 +1308,6 @@ module Google
1287
1308
 
1288
1309
  @catalog_service_stub.call_rpc :get_aspect_type, request, options: options do |response, operation|
1289
1310
  yield response, operation if block_given?
1290
- return response
1291
1311
  end
1292
1312
  rescue ::GRPC::BadStatus => e
1293
1313
  raise ::Google::Cloud::Error.from_error(e)
@@ -1390,7 +1410,7 @@ module Google
1390
1410
  @catalog_service_stub.call_rpc :create_entry_group, request, options: options do |response, operation|
1391
1411
  response = ::Gapic::Operation.new response, @operations_client, options: options
1392
1412
  yield response, operation if block_given?
1393
- return response
1413
+ throw :response, response
1394
1414
  end
1395
1415
  rescue ::GRPC::BadStatus => e
1396
1416
  raise ::Google::Cloud::Error.from_error(e)
@@ -1489,7 +1509,7 @@ module Google
1489
1509
  @catalog_service_stub.call_rpc :update_entry_group, request, options: options do |response, operation|
1490
1510
  response = ::Gapic::Operation.new response, @operations_client, options: options
1491
1511
  yield response, operation if block_given?
1492
- return response
1512
+ throw :response, response
1493
1513
  end
1494
1514
  rescue ::GRPC::BadStatus => e
1495
1515
  raise ::Google::Cloud::Error.from_error(e)
@@ -1588,7 +1608,7 @@ module Google
1588
1608
  @catalog_service_stub.call_rpc :delete_entry_group, request, options: options do |response, operation|
1589
1609
  response = ::Gapic::Operation.new response, @operations_client, options: options
1590
1610
  yield response, operation if block_given?
1591
- return response
1611
+ throw :response, response
1592
1612
  end
1593
1613
  rescue ::GRPC::BadStatus => e
1594
1614
  raise ::Google::Cloud::Error.from_error(e)
@@ -1695,7 +1715,7 @@ module Google
1695
1715
  @catalog_service_stub.call_rpc :list_entry_groups, request, options: options do |response, operation|
1696
1716
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :list_entry_groups, request, response, operation, options
1697
1717
  yield response, operation if block_given?
1698
- return response
1718
+ throw :response, response
1699
1719
  end
1700
1720
  rescue ::GRPC::BadStatus => e
1701
1721
  raise ::Google::Cloud::Error.from_error(e)
@@ -1782,7 +1802,6 @@ module Google
1782
1802
 
1783
1803
  @catalog_service_stub.call_rpc :get_entry_group, request, options: options do |response, operation|
1784
1804
  yield response, operation if block_given?
1785
- return response
1786
1805
  end
1787
1806
  rescue ::GRPC::BadStatus => e
1788
1807
  raise ::Google::Cloud::Error.from_error(e)
@@ -1892,7 +1911,6 @@ module Google
1892
1911
 
1893
1912
  @catalog_service_stub.call_rpc :create_entry, request, options: options do |response, operation|
1894
1913
  yield response, operation if block_given?
1895
- return response
1896
1914
  end
1897
1915
  rescue ::GRPC::BadStatus => e
1898
1916
  raise ::Google::Cloud::Error.from_error(e)
@@ -1941,7 +1959,7 @@ module Google
1941
1959
  # specified path. For example, to attach an aspect to a field that is
1942
1960
  # specified by the `schema` aspect, the path should have the format
1943
1961
  # `Schema.<field_name>`.
1944
- # * `<aspect_type_reference>*` - matches aspects of the given type for all
1962
+ # * `<aspect_type_reference>@*` - matches aspects of the given type for all
1945
1963
  # paths.
1946
1964
  # * `*@path` - matches aspects of all types on the given path.
1947
1965
  #
@@ -2010,7 +2028,6 @@ module Google
2010
2028
 
2011
2029
  @catalog_service_stub.call_rpc :update_entry, request, options: options do |response, operation|
2012
2030
  yield response, operation if block_given?
2013
- return response
2014
2031
  end
2015
2032
  rescue ::GRPC::BadStatus => e
2016
2033
  raise ::Google::Cloud::Error.from_error(e)
@@ -2097,7 +2114,6 @@ module Google
2097
2114
 
2098
2115
  @catalog_service_stub.call_rpc :delete_entry, request, options: options do |response, operation|
2099
2116
  yield response, operation if block_given?
2100
- return response
2101
2117
  end
2102
2118
  rescue ::GRPC::BadStatus => e
2103
2119
  raise ::Google::Cloud::Error.from_error(e)
@@ -2219,7 +2235,7 @@ module Google
2219
2235
  @catalog_service_stub.call_rpc :list_entries, request, options: options do |response, operation|
2220
2236
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :list_entries, request, response, operation, options
2221
2237
  yield response, operation if block_given?
2222
- return response
2238
+ throw :response, response
2223
2239
  end
2224
2240
  rescue ::GRPC::BadStatus => e
2225
2241
  raise ::Google::Cloud::Error.from_error(e)
@@ -2320,7 +2336,6 @@ module Google
2320
2336
 
2321
2337
  @catalog_service_stub.call_rpc :get_entry, request, options: options do |response, operation|
2322
2338
  yield response, operation if block_given?
2323
- return response
2324
2339
  end
2325
2340
  rescue ::GRPC::BadStatus => e
2326
2341
  raise ::Google::Cloud::Error.from_error(e)
@@ -2424,7 +2439,6 @@ module Google
2424
2439
 
2425
2440
  @catalog_service_stub.call_rpc :lookup_entry, request, options: options do |response, operation|
2426
2441
  yield response, operation if block_given?
2427
- return response
2428
2442
  end
2429
2443
  rescue ::GRPC::BadStatus => e
2430
2444
  raise ::Google::Cloud::Error.from_error(e)
@@ -2453,6 +2467,8 @@ module Google
2453
2467
  # following form: `projects/{project}/locations/{location}`.
2454
2468
  # @param query [::String]
2455
2469
  # Required. The query against which entries in scope should be matched.
2470
+ # The query syntax is defined in [Search syntax for Dataplex
2471
+ # Catalog](https://cloud.google.com/dataplex/docs/search-syntax).
2456
2472
  # @param page_size [::Integer]
2457
2473
  # Optional. Number of results in the search page. If <=0, then defaults
2458
2474
  # to 10. Max limit for page_size is 1000. Throws an invalid argument for
@@ -2462,6 +2478,10 @@ module Google
2462
2478
  # this to retrieve the subsequent page.
2463
2479
  # @param order_by [::String]
2464
2480
  # Optional. Specifies the ordering of results.
2481
+ # Supported values are:
2482
+ # * `relevance` (default)
2483
+ # * `last_modified_timestamp`
2484
+ # * `last_modified_timestamp asc`
2465
2485
  # @param scope [::String]
2466
2486
  # Optional. The scope under which the search should be operating. It must
2467
2487
  # either be `organizations/<org_id>` or `projects/<project_ref>`. If it is
@@ -2532,7 +2552,7 @@ module Google
2532
2552
  @catalog_service_stub.call_rpc :search_entries, request, options: options do |response, operation|
2533
2553
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :search_entries, request, response, operation, options
2534
2554
  yield response, operation if block_given?
2535
- return response
2555
+ throw :response, response
2536
2556
  end
2537
2557
  rescue ::GRPC::BadStatus => e
2538
2558
  raise ::Google::Cloud::Error.from_error(e)
@@ -2636,7 +2656,7 @@ module Google
2636
2656
  @catalog_service_stub.call_rpc :create_metadata_job, request, options: options do |response, operation|
2637
2657
  response = ::Gapic::Operation.new response, @operations_client, options: options
2638
2658
  yield response, operation if block_given?
2639
- return response
2659
+ throw :response, response
2640
2660
  end
2641
2661
  rescue ::GRPC::BadStatus => e
2642
2662
  raise ::Google::Cloud::Error.from_error(e)
@@ -2723,7 +2743,6 @@ module Google
2723
2743
 
2724
2744
  @catalog_service_stub.call_rpc :get_metadata_job, request, options: options do |response, operation|
2725
2745
  yield response, operation if block_given?
2726
- return response
2727
2746
  end
2728
2747
  rescue ::GRPC::BadStatus => e
2729
2748
  raise ::Google::Cloud::Error.from_error(e)
@@ -2837,7 +2856,7 @@ module Google
2837
2856
  @catalog_service_stub.call_rpc :list_metadata_jobs, request, options: options do |response, operation|
2838
2857
  response = ::Gapic::PagedEnumerable.new @catalog_service_stub, :list_metadata_jobs, request, response, operation, options
2839
2858
  yield response, operation if block_given?
2840
- return response
2859
+ throw :response, response
2841
2860
  end
2842
2861
  rescue ::GRPC::BadStatus => e
2843
2862
  raise ::Google::Cloud::Error.from_error(e)
@@ -2929,7 +2948,6 @@ module Google
2929
2948
 
2930
2949
  @catalog_service_stub.call_rpc :cancel_metadata_job, request, options: options do |response, operation|
2931
2950
  yield response, operation if block_given?
2932
- return response
2933
2951
  end
2934
2952
  rescue ::GRPC::BadStatus => e
2935
2953
  raise ::Google::Cloud::Error.from_error(e)
@@ -3018,6 +3036,11 @@ module Google
3018
3036
  # default endpoint URL. The default value of nil uses the environment
3019
3037
  # universe (usually the default "googleapis.com" universe).
3020
3038
  # @return [::String,nil]
3039
+ # @!attribute [rw] logger
3040
+ # A custom logger to use for request/response debug logging, or the value
3041
+ # `:default` (the default) to construct a default logger, or `nil` to
3042
+ # explicitly disable logging.
3043
+ # @return [::Logger,:default,nil]
3021
3044
  #
3022
3045
  class Configuration
3023
3046
  extend ::Gapic::Config
@@ -3042,6 +3065,7 @@ module Google
3042
3065
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3043
3066
  config_attr :quota_project, nil, ::String, nil
3044
3067
  config_attr :universe_domain, nil, ::String, nil
3068
+ config_attr :logger, :default, ::Logger, nil, :default
3045
3069
 
3046
3070
  # @private
3047
3071
  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