google-cloud-run-v2 0.18.0 → 0.20.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/run/v2/builds/client.rb +28 -2
  4. data/lib/google/cloud/run/v2/builds/rest/client.rb +28 -2
  5. data/lib/google/cloud/run/v2/builds/rest/service_stub.rb +22 -8
  6. data/lib/google/cloud/run/v2/executions/client.rb +31 -5
  7. data/lib/google/cloud/run/v2/executions/operations.rb +12 -15
  8. data/lib/google/cloud/run/v2/executions/rest/client.rb +31 -5
  9. data/lib/google/cloud/run/v2/executions/rest/operations.rb +52 -45
  10. data/lib/google/cloud/run/v2/executions/rest/service_stub.rb +46 -26
  11. data/lib/google/cloud/run/v2/jobs/client.rb +33 -10
  12. data/lib/google/cloud/run/v2/jobs/operations.rb +12 -15
  13. data/lib/google/cloud/run/v2/jobs/rest/client.rb +33 -10
  14. data/lib/google/cloud/run/v2/jobs/rest/operations.rb +52 -45
  15. data/lib/google/cloud/run/v2/jobs/rest/service_stub.rb +86 -56
  16. data/lib/google/cloud/run/v2/revisions/client.rb +30 -4
  17. data/lib/google/cloud/run/v2/revisions/operations.rb +12 -15
  18. data/lib/google/cloud/run/v2/revisions/rest/client.rb +30 -4
  19. data/lib/google/cloud/run/v2/revisions/rest/operations.rb +52 -45
  20. data/lib/google/cloud/run/v2/revisions/rest/service_stub.rb +38 -20
  21. data/lib/google/cloud/run/v2/services/client.rb +32 -9
  22. data/lib/google/cloud/run/v2/services/operations.rb +12 -15
  23. data/lib/google/cloud/run/v2/services/rest/client.rb +32 -9
  24. data/lib/google/cloud/run/v2/services/rest/operations.rb +52 -45
  25. data/lib/google/cloud/run/v2/services/rest/service_stub.rb +78 -50
  26. data/lib/google/cloud/run/v2/tasks/client.rb +29 -3
  27. data/lib/google/cloud/run/v2/tasks/rest/client.rb +29 -3
  28. data/lib/google/cloud/run/v2/tasks/rest/service_stub.rb +30 -14
  29. data/lib/google/cloud/run/v2/vendor_settings_pb.rb +1 -1
  30. data/lib/google/cloud/run/v2/version.rb +1 -1
  31. data/proto_docs/google/api/client.rb +19 -0
  32. data/proto_docs/google/cloud/run/v2/vendor_settings.rb +5 -0
  33. data/proto_docs/google/longrunning/operations.rb +19 -14
  34. metadata +5 -5
@@ -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)
@@ -562,7 +553,7 @@ module Google
562
553
  @operations_stub.wait_operation request, options do |result, operation|
563
554
  result = ::Gapic::Operation.new result, @operations_client, options: options
564
555
  yield result, operation if block_given?
565
- return result
556
+ throw :response, result
566
557
  end
567
558
  rescue ::Gapic::Rest::Error => e
568
559
  raise ::Google::Cloud::Error.from_error(e)
@@ -642,6 +633,11 @@ module Google
642
633
  # default endpoint URL. The default value of nil uses the environment
643
634
  # universe (usually the default "googleapis.com" universe).
644
635
  # @return [::String,nil]
636
+ # @!attribute [rw] logger
637
+ # A custom logger to use for request/response debug logging, or the value
638
+ # `:default` (the default) to construct a default logger, or `nil` to
639
+ # explicitly disable logging.
640
+ # @return [::Logger,:default,nil]
645
641
  #
646
642
  class Configuration
647
643
  extend ::Gapic::Config
@@ -663,6 +659,7 @@ module Google
663
659
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
664
660
  config_attr :quota_project, nil, ::String, nil
665
661
  config_attr :universe_domain, nil, ::String, nil
662
+ config_attr :logger, :default, ::Logger, nil, :default
666
663
 
667
664
  # @private
668
665
  def initialize parent_config = nil
@@ -789,16 +786,18 @@ module Google
789
786
 
790
787
  response = @client_stub.make_http_request(
791
788
  verb,
792
- uri: uri,
793
- body: body || "",
794
- params: query_string_params,
789
+ uri: uri,
790
+ body: body || "",
791
+ params: query_string_params,
792
+ method_name: "list_operations",
795
793
  options: options
796
794
  )
797
795
  operation = ::Gapic::Rest::TransportOperation.new response
798
796
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
799
-
800
- yield result, operation if block_given?
801
- result
797
+ catch :response do
798
+ yield result, operation if block_given?
799
+ result
800
+ end
802
801
  end
803
802
 
804
803
  ##
@@ -827,16 +826,18 @@ module Google
827
826
 
828
827
  response = @client_stub.make_http_request(
829
828
  verb,
830
- uri: uri,
831
- body: body || "",
832
- params: query_string_params,
829
+ uri: uri,
830
+ body: body || "",
831
+ params: query_string_params,
832
+ method_name: "get_operation",
833
833
  options: options
834
834
  )
835
835
  operation = ::Gapic::Rest::TransportOperation.new response
836
836
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
837
-
838
- yield result, operation if block_given?
839
- result
837
+ catch :response do
838
+ yield result, operation if block_given?
839
+ result
840
+ end
840
841
  end
841
842
 
842
843
  ##
@@ -865,16 +866,18 @@ module Google
865
866
 
866
867
  response = @client_stub.make_http_request(
867
868
  verb,
868
- uri: uri,
869
- body: body || "",
870
- params: query_string_params,
869
+ uri: uri,
870
+ body: body || "",
871
+ params: query_string_params,
872
+ method_name: "delete_operation",
871
873
  options: options
872
874
  )
873
875
  operation = ::Gapic::Rest::TransportOperation.new response
874
876
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
875
-
876
- yield result, operation if block_given?
877
- result
877
+ catch :response do
878
+ yield result, operation if block_given?
879
+ result
880
+ end
878
881
  end
879
882
 
880
883
  ##
@@ -903,16 +906,18 @@ module Google
903
906
 
904
907
  response = @client_stub.make_http_request(
905
908
  verb,
906
- uri: uri,
907
- body: body || "",
908
- params: query_string_params,
909
+ uri: uri,
910
+ body: body || "",
911
+ params: query_string_params,
912
+ method_name: "cancel_operation",
909
913
  options: options
910
914
  )
911
915
  operation = ::Gapic::Rest::TransportOperation.new response
912
916
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
913
-
914
- yield result, operation if block_given?
915
- result
917
+ catch :response do
918
+ yield result, operation if block_given?
919
+ result
920
+ end
916
921
  end
917
922
 
918
923
  ##
@@ -941,16 +946,18 @@ module Google
941
946
 
942
947
  response = @client_stub.make_http_request(
943
948
  verb,
944
- uri: uri,
945
- body: body || "",
946
- params: query_string_params,
949
+ uri: uri,
950
+ body: body || "",
951
+ params: query_string_params,
952
+ method_name: "wait_operation",
947
953
  options: options
948
954
  )
949
955
  operation = ::Gapic::Rest::TransportOperation.new response
950
956
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
951
-
952
- yield result, operation if block_given?
953
- result
957
+ catch :response do
958
+ yield result, operation if block_given?
959
+ result
960
+ end
954
961
  end
955
962
 
956
963
  ##
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the get_execution REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "get_execution",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Run::V2::Execution.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "list_executions",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Run::V2::ListExecutionsResponse.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "delete_execution",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "cancel_execution",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -165,14 +165,26 @@ module Google
165
165
  universe_domain: @config.universe_domain,
166
166
  channel_args: @config.channel_args,
167
167
  interceptors: @config.interceptors,
168
- channel_pool_config: @config.channel_pool
168
+ channel_pool_config: @config.channel_pool,
169
+ logger: @config.logger
169
170
  )
170
171
 
172
+ @jobs_stub.stub_logger&.info do |entry|
173
+ entry.set_system_name
174
+ entry.set_service
175
+ entry.message = "Created client for #{entry.service}"
176
+ entry.set_credentials_fields credentials
177
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
178
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
179
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
180
+ end
181
+
171
182
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
172
183
  config.credentials = credentials
173
184
  config.quota_project = @quota_project_id
174
185
  config.endpoint = @jobs_stub.endpoint
175
186
  config.universe_domain = @jobs_stub.universe_domain
187
+ config.logger = @jobs_stub.logger if config.respond_to? :logger=
176
188
  end
177
189
  end
178
190
 
@@ -190,6 +202,15 @@ module Google
190
202
  #
191
203
  attr_reader :location_client
192
204
 
205
+ ##
206
+ # The logger used for request/response debug logging.
207
+ #
208
+ # @return [Logger]
209
+ #
210
+ def logger
211
+ @jobs_stub.logger
212
+ end
213
+
193
214
  # Service calls
194
215
 
195
216
  ##
@@ -293,7 +314,7 @@ module Google
293
314
  @jobs_stub.call_rpc :create_job, request, options: options do |response, operation|
294
315
  response = ::Gapic::Operation.new response, @operations_client, options: options
295
316
  yield response, operation if block_given?
296
- return response
317
+ throw :response, response
297
318
  end
298
319
  rescue ::GRPC::BadStatus => e
299
320
  raise ::Google::Cloud::Error.from_error(e)
@@ -384,7 +405,6 @@ module Google
384
405
 
385
406
  @jobs_stub.call_rpc :get_job, request, options: options do |response, operation|
386
407
  yield response, operation if block_given?
387
- return response
388
408
  end
389
409
  rescue ::GRPC::BadStatus => e
390
410
  raise ::Google::Cloud::Error.from_error(e)
@@ -487,7 +507,7 @@ module Google
487
507
  @jobs_stub.call_rpc :list_jobs, request, options: options do |response, operation|
488
508
  response = ::Gapic::PagedEnumerable.new @jobs_stub, :list_jobs, request, response, operation, options
489
509
  yield response, operation if block_given?
490
- return response
510
+ throw :response, response
491
511
  end
492
512
  rescue ::GRPC::BadStatus => e
493
513
  raise ::Google::Cloud::Error.from_error(e)
@@ -591,7 +611,7 @@ module Google
591
611
  @jobs_stub.call_rpc :update_job, request, options: options do |response, operation|
592
612
  response = ::Gapic::Operation.new response, @operations_client, options: options
593
613
  yield response, operation if block_given?
594
- return response
614
+ throw :response, response
595
615
  end
596
616
  rescue ::GRPC::BadStatus => e
597
617
  raise ::Google::Cloud::Error.from_error(e)
@@ -696,7 +716,7 @@ module Google
696
716
  @jobs_stub.call_rpc :delete_job, request, options: options do |response, operation|
697
717
  response = ::Gapic::Operation.new response, @operations_client, options: options
698
718
  yield response, operation if block_given?
699
- return response
719
+ throw :response, response
700
720
  end
701
721
  rescue ::GRPC::BadStatus => e
702
722
  raise ::Google::Cloud::Error.from_error(e)
@@ -804,7 +824,7 @@ module Google
804
824
  @jobs_stub.call_rpc :run_job, request, options: options do |response, operation|
805
825
  response = ::Gapic::Operation.new response, @operations_client, options: options
806
826
  yield response, operation if block_given?
807
- return response
827
+ throw :response, response
808
828
  end
809
829
  rescue ::GRPC::BadStatus => e
810
830
  raise ::Google::Cloud::Error.from_error(e)
@@ -895,7 +915,6 @@ module Google
895
915
 
896
916
  @jobs_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
897
917
  yield response, operation if block_given?
898
- return response
899
918
  end
900
919
  rescue ::GRPC::BadStatus => e
901
920
  raise ::Google::Cloud::Error.from_error(e)
@@ -994,7 +1013,6 @@ module Google
994
1013
 
995
1014
  @jobs_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
996
1015
  yield response, operation if block_given?
997
- return response
998
1016
  end
999
1017
  rescue ::GRPC::BadStatus => e
1000
1018
  raise ::Google::Cloud::Error.from_error(e)
@@ -1088,7 +1106,6 @@ module Google
1088
1106
 
1089
1107
  @jobs_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
1090
1108
  yield response, operation if block_given?
1091
- return response
1092
1109
  end
1093
1110
  rescue ::GRPC::BadStatus => e
1094
1111
  raise ::Google::Cloud::Error.from_error(e)
@@ -1177,6 +1194,11 @@ module Google
1177
1194
  # default endpoint URL. The default value of nil uses the environment
1178
1195
  # universe (usually the default "googleapis.com" universe).
1179
1196
  # @return [::String,nil]
1197
+ # @!attribute [rw] logger
1198
+ # A custom logger to use for request/response debug logging, or the value
1199
+ # `:default` (the default) to construct a default logger, or `nil` to
1200
+ # explicitly disable logging.
1201
+ # @return [::Logger,:default,nil]
1180
1202
  #
1181
1203
  class Configuration
1182
1204
  extend ::Gapic::Config
@@ -1201,6 +1223,7 @@ module Google
1201
1223
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1202
1224
  config_attr :quota_project, nil, ::String, nil
1203
1225
  config_attr :universe_domain, nil, ::String, nil
1226
+ config_attr :logger, :default, ::Logger, nil, :default
1204
1227
 
1205
1228
  # @private
1206
1229
  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)
@@ -607,7 +598,7 @@ module Google
607
598
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
608
599
  response = ::Gapic::Operation.new response, @operations_client, options: options
609
600
  yield response, operation if block_given?
610
- return response
601
+ throw :response, response
611
602
  end
612
603
  rescue ::GRPC::BadStatus => e
613
604
  raise ::Google::Cloud::Error.from_error(e)
@@ -696,6 +687,11 @@ module Google
696
687
  # default endpoint URL. The default value of nil uses the environment
697
688
  # universe (usually the default "googleapis.com" universe).
698
689
  # @return [::String,nil]
690
+ # @!attribute [rw] logger
691
+ # A custom logger to use for request/response debug logging, or the value
692
+ # `:default` (the default) to construct a default logger, or `nil` to
693
+ # explicitly disable logging.
694
+ # @return [::Logger,:default,nil]
699
695
  #
700
696
  class Configuration
701
697
  extend ::Gapic::Config
@@ -720,6 +716,7 @@ module Google
720
716
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
721
717
  config_attr :quota_project, nil, ::String, nil
722
718
  config_attr :universe_domain, nil, ::String, nil
719
+ config_attr :logger, :default, ::Logger, nil, :default
723
720
 
724
721
  # @private
725
722
  def initialize parent_config = nil