google-cloud-gke_multi_cloud-v1 0.11.0 → 0.12.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.
@@ -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
@@ -229,8 +229,19 @@ module Google
229
229
  endpoint: @config.endpoint,
230
230
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
231
231
  universe_domain: @config.universe_domain,
232
- credentials: credentials
232
+ credentials: credentials,
233
+ logger: @config.logger
233
234
  )
235
+
236
+ @azure_clusters_stub.logger(stub: true)&.info do |entry|
237
+ entry.set_system_name
238
+ entry.set_service
239
+ entry.message = "Created client for #{entry.service}"
240
+ entry.set_credentials_fields credentials
241
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
242
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
243
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
244
+ end
234
245
  end
235
246
 
236
247
  ##
@@ -240,6 +251,15 @@ module Google
240
251
  #
241
252
  attr_reader :operations_client
242
253
 
254
+ ##
255
+ # The logger used for request/response debug logging.
256
+ #
257
+ # @return [Logger]
258
+ #
259
+ def logger
260
+ @azure_clusters_stub.logger
261
+ end
262
+
243
263
  # Service calls
244
264
 
245
265
  ##
@@ -354,7 +374,7 @@ module Google
354
374
  @azure_clusters_stub.create_azure_client request, options do |result, operation|
355
375
  result = ::Gapic::Operation.new result, @operations_client, options: options
356
376
  yield result, operation if block_given?
357
- return result
377
+ throw :response, result
358
378
  end
359
379
  rescue ::Gapic::Rest::Error => e
360
380
  raise ::Google::Cloud::Error.from_error(e)
@@ -443,7 +463,6 @@ module Google
443
463
 
444
464
  @azure_clusters_stub.get_azure_client request, options do |result, operation|
445
465
  yield result, operation if block_given?
446
- return result
447
466
  end
448
467
  rescue ::Gapic::Rest::Error => e
449
468
  raise ::Google::Cloud::Error.from_error(e)
@@ -546,7 +565,7 @@ module Google
546
565
  @azure_clusters_stub.list_azure_clients request, options do |result, operation|
547
566
  result = ::Gapic::Rest::PagedEnumerable.new @azure_clusters_stub, :list_azure_clients, "azure_clients", request, result, options
548
567
  yield result, operation if block_given?
549
- return result
568
+ throw :response, result
550
569
  end
551
570
  rescue ::Gapic::Rest::Error => e
552
571
  raise ::Google::Cloud::Error.from_error(e)
@@ -658,7 +677,7 @@ module Google
658
677
  @azure_clusters_stub.delete_azure_client request, options do |result, operation|
659
678
  result = ::Gapic::Operation.new result, @operations_client, options: options
660
679
  yield result, operation if block_given?
661
- return result
680
+ throw :response, result
662
681
  end
663
682
  rescue ::Gapic::Rest::Error => e
664
683
  raise ::Google::Cloud::Error.from_error(e)
@@ -772,7 +791,7 @@ module Google
772
791
  @azure_clusters_stub.create_azure_cluster request, options do |result, operation|
773
792
  result = ::Gapic::Operation.new result, @operations_client, options: options
774
793
  yield result, operation if block_given?
775
- return result
794
+ throw :response, result
776
795
  end
777
796
  rescue ::Gapic::Rest::Error => e
778
797
  raise ::Google::Cloud::Error.from_error(e)
@@ -884,7 +903,7 @@ module Google
884
903
  @azure_clusters_stub.update_azure_cluster request, options do |result, operation|
885
904
  result = ::Gapic::Operation.new result, @operations_client, options: options
886
905
  yield result, operation if block_given?
887
- return result
906
+ throw :response, result
888
907
  end
889
908
  rescue ::Gapic::Rest::Error => e
890
909
  raise ::Google::Cloud::Error.from_error(e)
@@ -972,7 +991,6 @@ module Google
972
991
 
973
992
  @azure_clusters_stub.get_azure_cluster request, options do |result, operation|
974
993
  yield result, operation if block_given?
975
- return result
976
994
  end
977
995
  rescue ::Gapic::Rest::Error => e
978
996
  raise ::Google::Cloud::Error.from_error(e)
@@ -1075,7 +1093,7 @@ module Google
1075
1093
  @azure_clusters_stub.list_azure_clusters request, options do |result, operation|
1076
1094
  result = ::Gapic::Rest::PagedEnumerable.new @azure_clusters_stub, :list_azure_clusters, "azure_clusters", request, result, options
1077
1095
  yield result, operation if block_given?
1078
- return result
1096
+ throw :response, result
1079
1097
  end
1080
1098
  rescue ::Gapic::Rest::Error => e
1081
1099
  raise ::Google::Cloud::Error.from_error(e)
@@ -1199,7 +1217,7 @@ module Google
1199
1217
  @azure_clusters_stub.delete_azure_cluster request, options do |result, operation|
1200
1218
  result = ::Gapic::Operation.new result, @operations_client, options: options
1201
1219
  yield result, operation if block_given?
1202
- return result
1220
+ throw :response, result
1203
1221
  end
1204
1222
  rescue ::Gapic::Rest::Error => e
1205
1223
  raise ::Google::Cloud::Error.from_error(e)
@@ -1296,7 +1314,6 @@ module Google
1296
1314
 
1297
1315
  @azure_clusters_stub.generate_azure_cluster_agent_token request, options do |result, operation|
1298
1316
  yield result, operation if block_given?
1299
- return result
1300
1317
  end
1301
1318
  rescue ::Gapic::Rest::Error => e
1302
1319
  raise ::Google::Cloud::Error.from_error(e)
@@ -1384,7 +1401,6 @@ module Google
1384
1401
 
1385
1402
  @azure_clusters_stub.generate_azure_access_token request, options do |result, operation|
1386
1403
  yield result, operation if block_given?
1387
- return result
1388
1404
  end
1389
1405
  rescue ::Gapic::Rest::Error => e
1390
1406
  raise ::Google::Cloud::Error.from_error(e)
@@ -1500,7 +1516,7 @@ module Google
1500
1516
  @azure_clusters_stub.create_azure_node_pool request, options do |result, operation|
1501
1517
  result = ::Gapic::Operation.new result, @operations_client, options: options
1502
1518
  yield result, operation if block_given?
1503
- return result
1519
+ throw :response, result
1504
1520
  end
1505
1521
  rescue ::Gapic::Rest::Error => e
1506
1522
  raise ::Google::Cloud::Error.from_error(e)
@@ -1602,7 +1618,7 @@ module Google
1602
1618
  @azure_clusters_stub.update_azure_node_pool request, options do |result, operation|
1603
1619
  result = ::Gapic::Operation.new result, @operations_client, options: options
1604
1620
  yield result, operation if block_given?
1605
- return result
1621
+ throw :response, result
1606
1622
  end
1607
1623
  rescue ::Gapic::Rest::Error => e
1608
1624
  raise ::Google::Cloud::Error.from_error(e)
@@ -1690,7 +1706,6 @@ module Google
1690
1706
 
1691
1707
  @azure_clusters_stub.get_azure_node_pool request, options do |result, operation|
1692
1708
  yield result, operation if block_given?
1693
- return result
1694
1709
  end
1695
1710
  rescue ::Gapic::Rest::Error => e
1696
1711
  raise ::Google::Cloud::Error.from_error(e)
@@ -1795,7 +1810,7 @@ module Google
1795
1810
  @azure_clusters_stub.list_azure_node_pools request, options do |result, operation|
1796
1811
  result = ::Gapic::Rest::PagedEnumerable.new @azure_clusters_stub, :list_azure_node_pools, "azure_node_pools", request, result, options
1797
1812
  yield result, operation if block_given?
1798
- return result
1813
+ throw :response, result
1799
1814
  end
1800
1815
  rescue ::Gapic::Rest::Error => e
1801
1816
  raise ::Google::Cloud::Error.from_error(e)
@@ -1918,7 +1933,7 @@ module Google
1918
1933
  @azure_clusters_stub.delete_azure_node_pool request, options do |result, operation|
1919
1934
  result = ::Gapic::Operation.new result, @operations_client, options: options
1920
1935
  yield result, operation if block_given?
1921
- return result
1936
+ throw :response, result
1922
1937
  end
1923
1938
  rescue ::Gapic::Rest::Error => e
1924
1939
  raise ::Google::Cloud::Error.from_error(e)
@@ -2003,7 +2018,6 @@ module Google
2003
2018
 
2004
2019
  @azure_clusters_stub.get_azure_open_id_config request, options do |result, operation|
2005
2020
  yield result, operation if block_given?
2006
- return result
2007
2021
  end
2008
2022
  rescue ::Gapic::Rest::Error => e
2009
2023
  raise ::Google::Cloud::Error.from_error(e)
@@ -2085,7 +2099,6 @@ module Google
2085
2099
 
2086
2100
  @azure_clusters_stub.get_azure_json_web_keys request, options do |result, operation|
2087
2101
  yield result, operation if block_given?
2088
- return result
2089
2102
  end
2090
2103
  rescue ::Gapic::Rest::Error => e
2091
2104
  raise ::Google::Cloud::Error.from_error(e)
@@ -2173,7 +2186,6 @@ module Google
2173
2186
 
2174
2187
  @azure_clusters_stub.get_azure_server_config request, options do |result, operation|
2175
2188
  yield result, operation if block_given?
2176
- return result
2177
2189
  end
2178
2190
  rescue ::Gapic::Rest::Error => e
2179
2191
  raise ::Google::Cloud::Error.from_error(e)
@@ -2253,6 +2265,11 @@ module Google
2253
2265
  # default endpoint URL. The default value of nil uses the environment
2254
2266
  # universe (usually the default "googleapis.com" universe).
2255
2267
  # @return [::String,nil]
2268
+ # @!attribute [rw] logger
2269
+ # A custom logger to use for request/response debug logging, or the value
2270
+ # `:default` (the default) to construct a default logger, or `nil` to
2271
+ # explicitly disable logging.
2272
+ # @return [::Logger,:default,nil]
2256
2273
  #
2257
2274
  class Configuration
2258
2275
  extend ::Gapic::Config
@@ -2274,6 +2291,7 @@ module Google
2274
2291
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2275
2292
  config_attr :quota_project, nil, ::String, nil
2276
2293
  config_attr :universe_domain, nil, ::String, nil
2294
+ config_attr :logger, :default, ::Logger, nil, :default
2277
2295
 
2278
2296
  # @private
2279
2297
  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
  ##