google-cloud-gke_multi_cloud-v1 0.11.0 → 0.12.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cac8b32a44af8c0b227d8434d3068c2af5f56ed723387dcbd6d7a6ef8693a74b
4
- data.tar.gz: 7c4e678307265920ce85019d0993bd142c0f4b8b068c03d5a2f79c8ecc9656f9
3
+ metadata.gz: ba68b4c33ec67cc9d379afc10b3f988b09d98cdebee7227337b3a73d60fbb734
4
+ data.tar.gz: 8338b0fadfcfc9fbd54f8d9f74026a9a6d43e9eb961e0422349a00161278228c
5
5
  SHA512:
6
- metadata.gz: 43533a6a794f5a7f88e1139b0a7eb2a2d20ee56bd02b40964d638ac77eaf79092baf8a2d34d35da46d8a91215bc1f93ab4f8ec7fa46308312d5fec200dc20bd4
7
- data.tar.gz: 28c0cd27a3f9eff155f4f4ee50b25e79d1d5d0fa92526026b6135aa41eaa33fe11011377f164c4a2fcf88c3d4e0162c791a3bd42d77818835ba27f3dec3d0705
6
+ metadata.gz: b803eec20a12035b95de71135ebd1b679f9fc3d0e7b795f31a9a1597a1a79315a677a9f4d4b4cab1428f44df224e739b3246ebafc3b4225924382d7268d87db1
7
+ data.tar.gz: 2a08028f99dd7e914621468b04bfb8bd0b479ee7a3b4158156c27f608ced412ab8601c0a042dba8428d28e6097ef51859781cba7467b390deab6e1d4e10e46d7
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/anthos/clusters/docs/multi-cloud)
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/gke_multi_cloud/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::GkeMultiCloud::V1::AttachedClusters::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).
@@ -199,8 +199,19 @@ module Google
199
199
  universe_domain: @config.universe_domain,
200
200
  channel_args: @config.channel_args,
201
201
  interceptors: @config.interceptors,
202
- channel_pool_config: @config.channel_pool
202
+ channel_pool_config: @config.channel_pool,
203
+ logger: @config.logger
203
204
  )
205
+
206
+ @attached_clusters_stub.stub_logger&.info do |entry|
207
+ entry.set_system_name
208
+ entry.set_service
209
+ entry.message = "Created client for #{entry.service}"
210
+ entry.set_credentials_fields credentials
211
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
212
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
213
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
214
+ end
204
215
  end
205
216
 
206
217
  ##
@@ -210,6 +221,15 @@ module Google
210
221
  #
211
222
  attr_reader :operations_client
212
223
 
224
+ ##
225
+ # The logger used for request/response debug logging.
226
+ #
227
+ # @return [Logger]
228
+ #
229
+ def logger
230
+ @attached_clusters_stub.logger
231
+ end
232
+
213
233
  # Service calls
214
234
 
215
235
  ##
@@ -328,7 +348,7 @@ module Google
328
348
  @attached_clusters_stub.call_rpc :create_attached_cluster, request, options: options do |response, operation|
329
349
  response = ::Gapic::Operation.new response, @operations_client, options: options
330
350
  yield response, operation if block_given?
331
- return response
351
+ throw :response, response
332
352
  end
333
353
  rescue ::GRPC::BadStatus => e
334
354
  raise ::Google::Cloud::Error.from_error(e)
@@ -444,7 +464,7 @@ module Google
444
464
  @attached_clusters_stub.call_rpc :update_attached_cluster, request, options: options do |response, operation|
445
465
  response = ::Gapic::Operation.new response, @operations_client, options: options
446
466
  yield response, operation if block_given?
447
- return response
467
+ throw :response, response
448
468
  end
449
469
  rescue ::GRPC::BadStatus => e
450
470
  raise ::Google::Cloud::Error.from_error(e)
@@ -570,7 +590,7 @@ module Google
570
590
  @attached_clusters_stub.call_rpc :import_attached_cluster, request, options: options do |response, operation|
571
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
572
592
  yield response, operation if block_given?
573
- return response
593
+ throw :response, response
574
594
  end
575
595
  rescue ::GRPC::BadStatus => e
576
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -665,7 +685,6 @@ module Google
665
685
 
666
686
  @attached_clusters_stub.call_rpc :get_attached_cluster, request, options: options do |response, operation|
667
687
  yield response, operation if block_given?
668
- return response
669
688
  end
670
689
  rescue ::GRPC::BadStatus => e
671
690
  raise ::Google::Cloud::Error.from_error(e)
@@ -775,7 +794,7 @@ module Google
775
794
  @attached_clusters_stub.call_rpc :list_attached_clusters, request, options: options do |response, operation|
776
795
  response = ::Gapic::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, request, response, operation, options
777
796
  yield response, operation if block_given?
778
- return response
797
+ throw :response, response
779
798
  end
780
799
  rescue ::GRPC::BadStatus => e
781
800
  raise ::Google::Cloud::Error.from_error(e)
@@ -904,7 +923,7 @@ module Google
904
923
  @attached_clusters_stub.call_rpc :delete_attached_cluster, request, options: options do |response, operation|
905
924
  response = ::Gapic::Operation.new response, @operations_client, options: options
906
925
  yield response, operation if block_given?
907
- return response
926
+ throw :response, response
908
927
  end
909
928
  rescue ::GRPC::BadStatus => e
910
929
  raise ::Google::Cloud::Error.from_error(e)
@@ -999,7 +1018,6 @@ module Google
999
1018
 
1000
1019
  @attached_clusters_stub.call_rpc :get_attached_server_config, request, options: options do |response, operation|
1001
1020
  yield response, operation if block_given?
1002
- return response
1003
1021
  end
1004
1022
  rescue ::GRPC::BadStatus => e
1005
1023
  raise ::Google::Cloud::Error.from_error(e)
@@ -1116,7 +1134,6 @@ module Google
1116
1134
 
1117
1135
  @attached_clusters_stub.call_rpc :generate_attached_cluster_install_manifest, request, options: options do |response, operation|
1118
1136
  yield response, operation if block_given?
1119
- return response
1120
1137
  end
1121
1138
  rescue ::GRPC::BadStatus => e
1122
1139
  raise ::Google::Cloud::Error.from_error(e)
@@ -1218,7 +1235,6 @@ module Google
1218
1235
 
1219
1236
  @attached_clusters_stub.call_rpc :generate_attached_cluster_agent_token, request, options: options do |response, operation|
1220
1237
  yield response, operation if block_given?
1221
- return response
1222
1238
  end
1223
1239
  rescue ::GRPC::BadStatus => e
1224
1240
  raise ::Google::Cloud::Error.from_error(e)
@@ -1307,6 +1323,11 @@ module Google
1307
1323
  # default endpoint URL. The default value of nil uses the environment
1308
1324
  # universe (usually the default "googleapis.com" universe).
1309
1325
  # @return [::String,nil]
1326
+ # @!attribute [rw] logger
1327
+ # A custom logger to use for request/response debug logging, or the value
1328
+ # `:default` (the default) to construct a default logger, or `nil` to
1329
+ # explicitly disable logging.
1330
+ # @return [::Logger,:default,nil]
1310
1331
  #
1311
1332
  class Configuration
1312
1333
  extend ::Gapic::Config
@@ -1331,6 +1352,7 @@ module Google
1331
1352
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1332
1353
  config_attr :quota_project, nil, ::String, nil
1333
1354
  config_attr :universe_domain, nil, ::String, nil
1355
+ config_attr :logger, :default, ::Logger, nil, :default
1334
1356
 
1335
1357
  # @private
1336
1358
  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
@@ -192,8 +192,19 @@ module Google
192
192
  endpoint: @config.endpoint,
193
193
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
194
194
  universe_domain: @config.universe_domain,
195
- credentials: credentials
195
+ credentials: credentials,
196
+ logger: @config.logger
196
197
  )
198
+
199
+ @attached_clusters_stub.logger(stub: true)&.info do |entry|
200
+ entry.set_system_name
201
+ entry.set_service
202
+ entry.message = "Created client for #{entry.service}"
203
+ entry.set_credentials_fields credentials
204
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
205
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
206
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
207
+ end
197
208
  end
198
209
 
199
210
  ##
@@ -203,6 +214,15 @@ module Google
203
214
  #
204
215
  attr_reader :operations_client
205
216
 
217
+ ##
218
+ # The logger used for request/response debug logging.
219
+ #
220
+ # @return [Logger]
221
+ #
222
+ def logger
223
+ @attached_clusters_stub.logger
224
+ end
225
+
206
226
  # Service calls
207
227
 
208
228
  ##
@@ -314,7 +334,7 @@ module Google
314
334
  @attached_clusters_stub.create_attached_cluster request, options do |result, operation|
315
335
  result = ::Gapic::Operation.new result, @operations_client, options: options
316
336
  yield result, operation if block_given?
317
- return result
337
+ throw :response, result
318
338
  end
319
339
  rescue ::Gapic::Rest::Error => e
320
340
  raise ::Google::Cloud::Error.from_error(e)
@@ -423,7 +443,7 @@ module Google
423
443
  @attached_clusters_stub.update_attached_cluster request, options do |result, operation|
424
444
  result = ::Gapic::Operation.new result, @operations_client, options: options
425
445
  yield result, operation if block_given?
426
- return result
446
+ throw :response, result
427
447
  end
428
448
  rescue ::Gapic::Rest::Error => e
429
449
  raise ::Google::Cloud::Error.from_error(e)
@@ -542,7 +562,7 @@ module Google
542
562
  @attached_clusters_stub.import_attached_cluster request, options do |result, operation|
543
563
  result = ::Gapic::Operation.new result, @operations_client, options: options
544
564
  yield result, operation if block_given?
545
- return result
565
+ throw :response, result
546
566
  end
547
567
  rescue ::Gapic::Rest::Error => e
548
568
  raise ::Google::Cloud::Error.from_error(e)
@@ -630,7 +650,6 @@ module Google
630
650
 
631
651
  @attached_clusters_stub.get_attached_cluster request, options do |result, operation|
632
652
  yield result, operation if block_given?
633
- return result
634
653
  end
635
654
  rescue ::Gapic::Rest::Error => e
636
655
  raise ::Google::Cloud::Error.from_error(e)
@@ -733,7 +752,7 @@ module Google
733
752
  @attached_clusters_stub.list_attached_clusters request, options do |result, operation|
734
753
  result = ::Gapic::Rest::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, "attached_clusters", request, result, options
735
754
  yield result, operation if block_given?
736
- return result
755
+ throw :response, result
737
756
  end
738
757
  rescue ::Gapic::Rest::Error => e
739
758
  raise ::Google::Cloud::Error.from_error(e)
@@ -855,7 +874,7 @@ module Google
855
874
  @attached_clusters_stub.delete_attached_cluster request, options do |result, operation|
856
875
  result = ::Gapic::Operation.new result, @operations_client, options: options
857
876
  yield result, operation if block_given?
858
- return result
877
+ throw :response, result
859
878
  end
860
879
  rescue ::Gapic::Rest::Error => e
861
880
  raise ::Google::Cloud::Error.from_error(e)
@@ -943,7 +962,6 @@ module Google
943
962
 
944
963
  @attached_clusters_stub.get_attached_server_config request, options do |result, operation|
945
964
  yield result, operation if block_given?
946
- return result
947
965
  end
948
966
  rescue ::Gapic::Rest::Error => e
949
967
  raise ::Google::Cloud::Error.from_error(e)
@@ -1053,7 +1071,6 @@ module Google
1053
1071
 
1054
1072
  @attached_clusters_stub.generate_attached_cluster_install_manifest request, options do |result, operation|
1055
1073
  yield result, operation if block_given?
1056
- return result
1057
1074
  end
1058
1075
  rescue ::Gapic::Rest::Error => e
1059
1076
  raise ::Google::Cloud::Error.from_error(e)
@@ -1148,7 +1165,6 @@ module Google
1148
1165
 
1149
1166
  @attached_clusters_stub.generate_attached_cluster_agent_token request, options do |result, operation|
1150
1167
  yield result, operation if block_given?
1151
- return result
1152
1168
  end
1153
1169
  rescue ::Gapic::Rest::Error => e
1154
1170
  raise ::Google::Cloud::Error.from_error(e)
@@ -1228,6 +1244,11 @@ module Google
1228
1244
  # default endpoint URL. The default value of nil uses the environment
1229
1245
  # universe (usually the default "googleapis.com" universe).
1230
1246
  # @return [::String,nil]
1247
+ # @!attribute [rw] logger
1248
+ # A custom logger to use for request/response debug logging, or the value
1249
+ # `:default` (the default) to construct a default logger, or `nil` to
1250
+ # explicitly disable logging.
1251
+ # @return [::Logger,:default,nil]
1231
1252
  #
1232
1253
  class Configuration
1233
1254
  extend ::Gapic::Config
@@ -1249,6 +1270,7 @@ module Google
1249
1270
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1250
1271
  config_attr :quota_project, nil, ::String, nil
1251
1272
  config_attr :universe_domain, nil, ::String, nil
1273
+ config_attr :logger, :default, ::Logger, nil, :default
1252
1274
 
1253
1275
  # @private
1254
1276
  def initialize parent_config = nil
@@ -115,14 +115,6 @@ module Google
115
115
  # Lists operations that match the specified filter in the request. If the
116
116
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
117
117
  #
118
- # NOTE: the `name` binding allows API services to override the binding
119
- # to use different resource name schemes, such as `users/*/operations`. To
120
- # override the binding, API services can add a binding such as
121
- # `"/v1/{name=users/*}/operations"` to their service configuration.
122
- # For backwards compatibility, the default name includes the operations
123
- # collection id, however overriding users must ensure the name binding
124
- # is the parent resource, without the operations collection id.
125
- #
126
118
  # @overload list_operations(request, options = nil)
127
119
  # Pass arguments to `list_operations` via a request object, either of type
128
120
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -204,7 +196,7 @@ module Google
204
196
  @operations_stub.list_operations request, options do |result, operation|
205
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
206
198
  yield result, operation if block_given?
207
- return result
199
+ throw :response, result
208
200
  end
209
201
  rescue ::Gapic::Rest::Error => e
210
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -293,7 +285,7 @@ module Google
293
285
  @operations_stub.get_operation request, options do |result, operation|
294
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
295
287
  yield result, operation if block_given?
296
- return result
288
+ throw :response, result
297
289
  end
298
290
  rescue ::Gapic::Rest::Error => e
299
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -375,7 +367,6 @@ module Google
375
367
 
376
368
  @operations_stub.delete_operation request, options do |result, operation|
377
369
  yield result, operation if block_given?
378
- return result
379
370
  end
380
371
  rescue ::Gapic::Rest::Error => e
381
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -390,8 +381,9 @@ module Google
390
381
  # other methods to check whether the cancellation succeeded or whether the
391
382
  # operation completed despite cancellation. On successful cancellation,
392
383
  # the operation is not deleted; instead, it becomes an operation with
393
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
394
- # corresponding to `Code.CANCELLED`.
384
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
385
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
386
+ # `Code.CANCELLED`.
395
387
  #
396
388
  # @overload cancel_operation(request, options = nil)
397
389
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -463,7 +455,6 @@ module Google
463
455
 
464
456
  @operations_stub.cancel_operation request, options do |result, operation|
465
457
  yield result, operation if block_given?
466
- return result
467
458
  end
468
459
  rescue ::Gapic::Rest::Error => e
469
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -543,6 +534,11 @@ module Google
543
534
  # default endpoint URL. The default value of nil uses the environment
544
535
  # universe (usually the default "googleapis.com" universe).
545
536
  # @return [::String,nil]
537
+ # @!attribute [rw] logger
538
+ # A custom logger to use for request/response debug logging, or the value
539
+ # `:default` (the default) to construct a default logger, or `nil` to
540
+ # explicitly disable logging.
541
+ # @return [::Logger,:default,nil]
546
542
  #
547
543
  class Configuration
548
544
  extend ::Gapic::Config
@@ -564,6 +560,7 @@ module Google
564
560
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
565
561
  config_attr :quota_project, nil, ::String, nil
566
562
  config_attr :universe_domain, nil, ::String, nil
563
+ config_attr :logger, :default, ::Logger, nil, :default
567
564
 
568
565
  # @private
569
566
  def initialize parent_config = nil
@@ -683,16 +680,18 @@ module Google
683
680
 
684
681
  response = @client_stub.make_http_request(
685
682
  verb,
686
- uri: uri,
687
- body: body || "",
688
- params: query_string_params,
683
+ uri: uri,
684
+ body: body || "",
685
+ params: query_string_params,
686
+ method_name: "list_operations",
689
687
  options: options
690
688
  )
691
689
  operation = ::Gapic::Rest::TransportOperation.new response
692
690
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
693
-
694
- yield result, operation if block_given?
695
- result
691
+ catch :response do
692
+ yield result, operation if block_given?
693
+ result
694
+ end
696
695
  end
697
696
 
698
697
  ##
@@ -721,16 +720,18 @@ module Google
721
720
 
722
721
  response = @client_stub.make_http_request(
723
722
  verb,
724
- uri: uri,
725
- body: body || "",
726
- params: query_string_params,
723
+ uri: uri,
724
+ body: body || "",
725
+ params: query_string_params,
726
+ method_name: "get_operation",
727
727
  options: options
728
728
  )
729
729
  operation = ::Gapic::Rest::TransportOperation.new response
730
730
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
731
-
732
- yield result, operation if block_given?
733
- result
731
+ catch :response do
732
+ yield result, operation if block_given?
733
+ result
734
+ end
734
735
  end
735
736
 
736
737
  ##
@@ -759,16 +760,18 @@ module Google
759
760
 
760
761
  response = @client_stub.make_http_request(
761
762
  verb,
762
- uri: uri,
763
- body: body || "",
764
- params: query_string_params,
763
+ uri: uri,
764
+ body: body || "",
765
+ params: query_string_params,
766
+ method_name: "delete_operation",
765
767
  options: options
766
768
  )
767
769
  operation = ::Gapic::Rest::TransportOperation.new response
768
770
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
769
-
770
- yield result, operation if block_given?
771
- result
771
+ catch :response do
772
+ yield result, operation if block_given?
773
+ result
774
+ end
772
775
  end
773
776
 
774
777
  ##
@@ -797,16 +800,18 @@ module Google
797
800
 
798
801
  response = @client_stub.make_http_request(
799
802
  verb,
800
- uri: uri,
801
- body: body || "",
802
- params: query_string_params,
803
+ uri: uri,
804
+ body: body || "",
805
+ params: query_string_params,
806
+ method_name: "cancel_operation",
803
807
  options: options
804
808
  )
805
809
  operation = ::Gapic::Rest::TransportOperation.new response
806
810
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
807
-
808
- yield result, operation if block_given?
809
- result
811
+ catch :response do
812
+ yield result, operation if block_given?
813
+ result
814
+ end
810
815
  end
811
816
 
812
817
  ##