google-cloud-os_config-v1 1.0.1 → 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.
Files changed (20) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +31 -21
  3. data/lib/google/cloud/os_config/v1/os_config_service/client.rb +37 -13
  4. data/lib/google/cloud/os_config/v1/os_config_service/rest/client.rb +37 -13
  5. data/lib/google/cloud/os_config/v1/os_config_service/rest/service_stub.rb +110 -74
  6. data/lib/google/cloud/os_config/v1/os_config_zonal_service/client.rb +42 -13
  7. data/lib/google/cloud/os_config/v1/os_config_zonal_service/operations.rb +19 -15
  8. data/lib/google/cloud/os_config/v1/os_config_zonal_service/rest/client.rb +42 -13
  9. data/lib/google/cloud/os_config/v1/os_config_zonal_service/rest/operations.rb +50 -38
  10. data/lib/google/cloud/os_config/v1/os_config_zonal_service/rest/service_stub.rb +110 -74
  11. data/lib/google/cloud/os_config/v1/version.rb +1 -1
  12. data/proto_docs/google/api/client.rb +39 -0
  13. data/proto_docs/google/cloud/osconfig/v1/inventory.rb +22 -0
  14. data/proto_docs/google/cloud/osconfig/v1/os_policy.rb +44 -0
  15. data/proto_docs/google/cloud/osconfig/v1/osconfig_common.rb +4 -0
  16. data/proto_docs/google/cloud/osconfig/v1/patch_deployments.rb +12 -0
  17. data/proto_docs/google/cloud/osconfig/v1/patch_jobs.rb +4 -0
  18. data/proto_docs/google/longrunning/operations.rb +23 -14
  19. data/proto_docs/google/type/datetime.rb +4 -0
  20. metadata +6 -9
data/lib/google/cloud/os_config/v1/os_config_service/rest/service_stub.rb CHANGED
@@ -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 execute_patch_job 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: "execute_patch_job",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::OsConfig::V1::PatchJob.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: "get_patch_job",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::OsConfig::V1::PatchJob.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: "cancel_patch_job",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::OsConfig::V1::PatchJob.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: "list_patch_jobs",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::OsConfig::V1::ListPatchJobsResponse.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
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "list_patch_job_instance_details",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsResponse.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "create_patch_deployment",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::OsConfig::V1::PatchDeployment.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "get_patch_deployment",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Cloud::OsConfig::V1::PatchDeployment.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -353,16 +379,18 @@ module Google
353
379
 
354
380
  response = @client_stub.make_http_request(
355
381
  verb,
356
- uri: uri,
357
- body: body || "",
358
- params: query_string_params,
382
+ uri: uri,
383
+ body: body || "",
384
+ params: query_string_params,
385
+ method_name: "list_patch_deployments",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::OsConfig::V1::ListPatchDeploymentsResponse.decode_json response.body, ignore_unknown_fields: true
363
-
364
- yield result, operation if block_given?
365
- result
390
+ catch :response do
391
+ yield result, operation if block_given?
392
+ result
393
+ end
366
394
  end
367
395
 
368
396
  ##
@@ -391,16 +419,18 @@ module Google
391
419
 
392
420
  response = @client_stub.make_http_request(
393
421
  verb,
394
- uri: uri,
395
- body: body || "",
396
- params: query_string_params,
422
+ uri: uri,
423
+ body: body || "",
424
+ params: query_string_params,
425
+ method_name: "delete_patch_deployment",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
401
-
402
- yield result, operation if block_given?
403
- result
430
+ catch :response do
431
+ yield result, operation if block_given?
432
+ result
433
+ end
404
434
  end
405
435
 
406
436
  ##
@@ -429,16 +459,18 @@ module Google
429
459
 
430
460
  response = @client_stub.make_http_request(
431
461
  verb,
432
- uri: uri,
433
- body: body || "",
434
- params: query_string_params,
462
+ uri: uri,
463
+ body: body || "",
464
+ params: query_string_params,
465
+ method_name: "update_patch_deployment",
435
466
  options: options
436
467
  )
437
468
  operation = ::Gapic::Rest::TransportOperation.new response
438
469
  result = ::Google::Cloud::OsConfig::V1::PatchDeployment.decode_json response.body, ignore_unknown_fields: true
439
-
440
- yield result, operation if block_given?
441
- result
470
+ catch :response do
471
+ yield result, operation if block_given?
472
+ result
473
+ end
442
474
  end
443
475
 
444
476
  ##
@@ -467,16 +499,18 @@ module Google
467
499
 
468
500
  response = @client_stub.make_http_request(
469
501
  verb,
470
- uri: uri,
471
- body: body || "",
472
- params: query_string_params,
502
+ uri: uri,
503
+ body: body || "",
504
+ params: query_string_params,
505
+ method_name: "pause_patch_deployment",
473
506
  options: options
474
507
  )
475
508
  operation = ::Gapic::Rest::TransportOperation.new response
476
509
  result = ::Google::Cloud::OsConfig::V1::PatchDeployment.decode_json response.body, ignore_unknown_fields: true
477
-
478
- yield result, operation if block_given?
479
- result
510
+ catch :response do
511
+ yield result, operation if block_given?
512
+ result
513
+ end
480
514
  end
481
515
 
482
516
  ##
@@ -505,16 +539,18 @@ module Google
505
539
 
506
540
  response = @client_stub.make_http_request(
507
541
  verb,
508
- uri: uri,
509
- body: body || "",
510
- params: query_string_params,
542
+ uri: uri,
543
+ body: body || "",
544
+ params: query_string_params,
545
+ method_name: "resume_patch_deployment",
511
546
  options: options
512
547
  )
513
548
  operation = ::Gapic::Rest::TransportOperation.new response
514
549
  result = ::Google::Cloud::OsConfig::V1::PatchDeployment.decode_json response.body, ignore_unknown_fields: true
515
-
516
- yield result, operation if block_given?
517
- result
550
+ catch :response do
551
+ yield result, operation if block_given?
552
+ result
553
+ end
518
554
  end
519
555
 
520
556
  ##
data/lib/google/cloud/os_config/v1/os_config_zonal_service/client.rb CHANGED
@@ -172,8 +172,19 @@ module Google
172
172
  universe_domain: @config.universe_domain,
173
173
  channel_args: @config.channel_args,
174
174
  interceptors: @config.interceptors,
175
- channel_pool_config: @config.channel_pool
175
+ channel_pool_config: @config.channel_pool,
176
+ logger: @config.logger
176
177
  )
178
+
179
+ @os_config_zonal_service_stub.stub_logger&.info do |entry|
180
+ entry.set_system_name
181
+ entry.set_service
182
+ entry.message = "Created client for #{entry.service}"
183
+ entry.set_credentials_fields credentials
184
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
185
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
186
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
187
+ end
177
188
  end
178
189
 
179
190
  ##
@@ -183,6 +194,15 @@ module Google
183
194
  #
184
195
  attr_reader :operations_client
185
196
 
197
+ ##
198
+ # The logger used for request/response debug logging.
199
+ #
200
+ # @return [Logger]
201
+ #
202
+ def logger
203
+ @os_config_zonal_service_stub.logger
204
+ end
205
+
186
206
  # Service calls
187
207
 
188
208
  ##
@@ -293,7 +313,7 @@ module Google
293
313
  @os_config_zonal_service_stub.call_rpc :create_os_policy_assignment, request, options: options do |response, operation|
294
314
  response = ::Gapic::Operation.new response, @operations_client, options: options
295
315
  yield response, operation if block_given?
296
- return response
316
+ throw :response, response
297
317
  end
298
318
  rescue ::GRPC::BadStatus => e
299
319
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +418,7 @@ module Google
398
418
  @os_config_zonal_service_stub.call_rpc :update_os_policy_assignment, request, options: options do |response, operation|
399
419
  response = ::Gapic::Operation.new response, @operations_client, options: options
400
420
  yield response, operation if block_given?
401
- return response
421
+ throw :response, response
402
422
  end
403
423
  rescue ::GRPC::BadStatus => e
404
424
  raise ::Google::Cloud::Error.from_error(e)
@@ -491,7 +511,6 @@ module Google
491
511
 
492
512
  @os_config_zonal_service_stub.call_rpc :get_os_policy_assignment, request, options: options do |response, operation|
493
513
  yield response, operation if block_given?
494
- return response
495
514
  end
496
515
  rescue ::GRPC::BadStatus => e
497
516
  raise ::Google::Cloud::Error.from_error(e)
@@ -590,7 +609,7 @@ module Google
590
609
  @os_config_zonal_service_stub.call_rpc :list_os_policy_assignments, request, options: options do |response, operation|
591
610
  response = ::Gapic::PagedEnumerable.new @os_config_zonal_service_stub, :list_os_policy_assignments, request, response, operation, options
592
611
  yield response, operation if block_given?
593
- return response
612
+ throw :response, response
594
613
  end
595
614
  rescue ::GRPC::BadStatus => e
596
615
  raise ::Google::Cloud::Error.from_error(e)
@@ -687,7 +706,7 @@ module Google
687
706
  @os_config_zonal_service_stub.call_rpc :list_os_policy_assignment_revisions, request, options: options do |response, operation|
688
707
  response = ::Gapic::PagedEnumerable.new @os_config_zonal_service_stub, :list_os_policy_assignment_revisions, request, response, operation, options
689
708
  yield response, operation if block_given?
690
- return response
709
+ throw :response, response
691
710
  end
692
711
  rescue ::GRPC::BadStatus => e
693
712
  raise ::Google::Cloud::Error.from_error(e)
@@ -792,7 +811,7 @@ module Google
792
811
  @os_config_zonal_service_stub.call_rpc :delete_os_policy_assignment, request, options: options do |response, operation|
793
812
  response = ::Gapic::Operation.new response, @operations_client, options: options
794
813
  yield response, operation if block_given?
795
- return response
814
+ throw :response, response
796
815
  end
797
816
  rescue ::GRPC::BadStatus => e
798
817
  raise ::Google::Cloud::Error.from_error(e)
@@ -887,7 +906,6 @@ module Google
887
906
 
888
907
  @os_config_zonal_service_stub.call_rpc :get_os_policy_assignment_report, request, options: options do |response, operation|
889
908
  yield response, operation if block_given?
890
- return response
891
909
  end
892
910
  rescue ::GRPC::BadStatus => e
893
911
  raise ::Google::Cloud::Error.from_error(e)
@@ -1008,7 +1026,7 @@ module Google
1008
1026
  @os_config_zonal_service_stub.call_rpc :list_os_policy_assignment_reports, request, options: options do |response, operation|
1009
1027
  response = ::Gapic::PagedEnumerable.new @os_config_zonal_service_stub, :list_os_policy_assignment_reports, request, response, operation, options
1010
1028
  yield response, operation if block_given?
1011
- return response
1029
+ throw :response, response
1012
1030
  end
1013
1031
  rescue ::GRPC::BadStatus => e
1014
1032
  raise ::Google::Cloud::Error.from_error(e)
@@ -1105,7 +1123,6 @@ module Google
1105
1123
 
1106
1124
  @os_config_zonal_service_stub.call_rpc :get_inventory, request, options: options do |response, operation|
1107
1125
  yield response, operation if block_given?
1108
- return response
1109
1126
  end
1110
1127
  rescue ::GRPC::BadStatus => e
1111
1128
  raise ::Google::Cloud::Error.from_error(e)
@@ -1212,7 +1229,7 @@ module Google
1212
1229
  @os_config_zonal_service_stub.call_rpc :list_inventories, request, options: options do |response, operation|
1213
1230
  response = ::Gapic::PagedEnumerable.new @os_config_zonal_service_stub, :list_inventories, request, response, operation, options
1214
1231
  yield response, operation if block_given?
1215
- return response
1232
+ throw :response, response
1216
1233
  end
1217
1234
  rescue ::GRPC::BadStatus => e
1218
1235
  raise ::Google::Cloud::Error.from_error(e)
@@ -1306,7 +1323,6 @@ module Google
1306
1323
 
1307
1324
  @os_config_zonal_service_stub.call_rpc :get_vulnerability_report, request, options: options do |response, operation|
1308
1325
  yield response, operation if block_given?
1309
- return response
1310
1326
  end
1311
1327
  rescue ::GRPC::BadStatus => e
1312
1328
  raise ::Google::Cloud::Error.from_error(e)
@@ -1410,7 +1426,7 @@ module Google
1410
1426
  @os_config_zonal_service_stub.call_rpc :list_vulnerability_reports, request, options: options do |response, operation|
1411
1427
  response = ::Gapic::PagedEnumerable.new @os_config_zonal_service_stub, :list_vulnerability_reports, request, response, operation, options
1412
1428
  yield response, operation if block_given?
1413
- return response
1429
+ throw :response, response
1414
1430
  end
1415
1431
  rescue ::GRPC::BadStatus => e
1416
1432
  raise ::Google::Cloud::Error.from_error(e)
@@ -1460,6 +1476,13 @@ module Google
1460
1476
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1461
1477
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1462
1478
  # * (`nil`) indicating no credentials
1479
+ #
1480
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1481
+ # external source for authentication to Google Cloud, you must validate it before
1482
+ # providing it to a Google API client library. Providing an unvalidated credential
1483
+ # configuration to Google APIs can compromise the security of your systems and data.
1484
+ # For more information, refer to [Validate credential configurations from external
1485
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1463
1486
  # @return [::Object]
1464
1487
  # @!attribute [rw] scope
1465
1488
  # The OAuth scopes
@@ -1499,6 +1522,11 @@ module Google
1499
1522
  # default endpoint URL. The default value of nil uses the environment
1500
1523
  # universe (usually the default "googleapis.com" universe).
1501
1524
  # @return [::String,nil]
1525
+ # @!attribute [rw] logger
1526
+ # A custom logger to use for request/response debug logging, or the value
1527
+ # `:default` (the default) to construct a default logger, or `nil` to
1528
+ # explicitly disable logging.
1529
+ # @return [::Logger,:default,nil]
1502
1530
  #
1503
1531
  class Configuration
1504
1532
  extend ::Gapic::Config
@@ -1523,6 +1551,7 @@ module Google
1523
1551
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1524
1552
  config_attr :quota_project, nil, ::String, nil
1525
1553
  config_attr :universe_domain, nil, ::String, nil
1554
+ config_attr :logger, :default, ::Logger, nil, :default
1526
1555
 
1527
1556
  # @private
1528
1557
  def initialize parent_config = nil
data/lib/google/cloud/os_config/v1/os_config_zonal_service/operations.rb CHANGED
@@ -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)
@@ -649,6 +640,13 @@ module Google
649
640
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
650
641
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
651
642
  # * (`nil`) indicating no credentials
643
+ #
644
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
645
+ # external source for authentication to Google Cloud, you must validate it before
646
+ # providing it to a Google API client library. Providing an unvalidated credential
647
+ # configuration to Google APIs can compromise the security of your systems and data.
648
+ # For more information, refer to [Validate credential configurations from external
649
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
652
650
  # @return [::Object]
653
651
  # @!attribute [rw] scope
654
652
  # The OAuth scopes
@@ -688,6 +686,11 @@ module Google
688
686
  # default endpoint URL. The default value of nil uses the environment
689
687
  # universe (usually the default "googleapis.com" universe).
690
688
  # @return [::String,nil]
689
+ # @!attribute [rw] logger
690
+ # A custom logger to use for request/response debug logging, or the value
691
+ # `:default` (the default) to construct a default logger, or `nil` to
692
+ # explicitly disable logging.
693
+ # @return [::Logger,:default,nil]
691
694
  #
692
695
  class Configuration
693
696
  extend ::Gapic::Config
@@ -712,6 +715,7 @@ module Google
712
715
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
716
  config_attr :quota_project, nil, ::String, nil
714
717
  config_attr :universe_domain, nil, ::String, nil
718
+ config_attr :logger, :default, ::Logger, nil, :default
715
719
 
716
720
  # @private
717
721
  def initialize parent_config = nil