google-cloud-gke_multi_cloud-v1 0.11.0 → 0.13.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 (26) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/client.rb +33 -10
  4. data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/operations.rb +12 -15
  5. data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/client.rb +33 -10
  6. data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/operations.rb +43 -38
  7. data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/service_stub.rb +86 -56
  8. data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/client.rb +36 -17
  9. data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/operations.rb +12 -15
  10. data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/client.rb +36 -17
  11. data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/operations.rb +43 -38
  12. data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/service_stub.rb +142 -98
  13. data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/client.rb +38 -20
  14. data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/operations.rb +12 -15
  15. data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/client.rb +38 -20
  16. data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/operations.rb +43 -38
  17. data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/service_stub.rb +166 -116
  18. data/lib/google/cloud/gke_multi_cloud/v1/version.rb +1 -1
  19. data/lib/google/cloud/gkemulticloud/v1/attached_resources_pb.rb +1 -1
  20. data/lib/google/cloud/gkemulticloud/v1/common_resources_pb.rb +2 -1
  21. data/proto_docs/google/api/client.rb +39 -0
  22. data/proto_docs/google/cloud/gkemulticloud/v1/attached_resources.rb +27 -0
  23. data/proto_docs/google/cloud/gkemulticloud/v1/attached_service.rb +1 -0
  24. data/proto_docs/google/cloud/gkemulticloud/v1/common_resources.rb +20 -3
  25. data/proto_docs/google/longrunning/operations.rb +19 -14
  26. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cac8b32a44af8c0b227d8434d3068c2af5f56ed723387dcbd6d7a6ef8693a74b
4
- data.tar.gz: 7c4e678307265920ce85019d0993bd142c0f4b8b068c03d5a2f79c8ecc9656f9
3
+ metadata.gz: bf1897bae5458260e6a2ed53ccd4b3ff884dc7110995f10b8bf6c3000b8f08f8
4
+ data.tar.gz: de27e6d1d1719579c8b2efefb52fa6c216e9c69b00708ec00ca41b97ce43ae62
5
5
  SHA512:
6
- metadata.gz: 43533a6a794f5a7f88e1139b0a7eb2a2d20ee56bd02b40964d638ac77eaf79092baf8a2d34d35da46d8a91215bc1f93ab4f8ec7fa46308312d5fec200dc20bd4
7
- data.tar.gz: 28c0cd27a3f9eff155f4f4ee50b25e79d1d5d0fa92526026b6135aa41eaa33fe11011377f164c4a2fcf88c3d4e0162c791a3bd42d77818835ba27f3dec3d0705
6
+ metadata.gz: 7541b69ca94ab1edd8c3379b402c065ee7e38d10138e394532280fc88d6714c9ba087ce6283d0b8a70fb532ddf4d5756765c85c6d010b5b187230ae287bc6e4e
7
+ data.tar.gz: c00a8ff6da73ef97774e87d5b2b4e2d1bda4d797710cd5873db508b1495ac890256bc5df661113b046cd5dbb1840015d6fbdae27248c026a4127700b7378593c
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)
@@ -376,6 +396,7 @@ module Google
376
396
  # * `proxy_config.kubernetes_secret.name`.
377
397
  # * `proxy_config.kubernetes_secret.namespace`.
378
398
  # * `security_posture_config.vulnerability_mode`
399
+ # * `monitoring_config.cloud_monitoring_config.enabled`
379
400
  #
380
401
  # @yield [response, operation] Access the result along with the RPC operation
381
402
  # @yieldparam response [::Gapic::Operation]
@@ -444,7 +465,7 @@ module Google
444
465
  @attached_clusters_stub.call_rpc :update_attached_cluster, request, options: options do |response, operation|
445
466
  response = ::Gapic::Operation.new response, @operations_client, options: options
446
467
  yield response, operation if block_given?
447
- return response
468
+ throw :response, response
448
469
  end
449
470
  rescue ::GRPC::BadStatus => e
450
471
  raise ::Google::Cloud::Error.from_error(e)
@@ -570,7 +591,7 @@ module Google
570
591
  @attached_clusters_stub.call_rpc :import_attached_cluster, request, options: options do |response, operation|
571
592
  response = ::Gapic::Operation.new response, @operations_client, options: options
572
593
  yield response, operation if block_given?
573
- return response
594
+ throw :response, response
574
595
  end
575
596
  rescue ::GRPC::BadStatus => e
576
597
  raise ::Google::Cloud::Error.from_error(e)
@@ -665,7 +686,6 @@ module Google
665
686
 
666
687
  @attached_clusters_stub.call_rpc :get_attached_cluster, request, options: options do |response, operation|
667
688
  yield response, operation if block_given?
668
- return response
669
689
  end
670
690
  rescue ::GRPC::BadStatus => e
671
691
  raise ::Google::Cloud::Error.from_error(e)
@@ -775,7 +795,7 @@ module Google
775
795
  @attached_clusters_stub.call_rpc :list_attached_clusters, request, options: options do |response, operation|
776
796
  response = ::Gapic::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, request, response, operation, options
777
797
  yield response, operation if block_given?
778
- return response
798
+ throw :response, response
779
799
  end
780
800
  rescue ::GRPC::BadStatus => e
781
801
  raise ::Google::Cloud::Error.from_error(e)
@@ -904,7 +924,7 @@ module Google
904
924
  @attached_clusters_stub.call_rpc :delete_attached_cluster, request, options: options do |response, operation|
905
925
  response = ::Gapic::Operation.new response, @operations_client, options: options
906
926
  yield response, operation if block_given?
907
- return response
927
+ throw :response, response
908
928
  end
909
929
  rescue ::GRPC::BadStatus => e
910
930
  raise ::Google::Cloud::Error.from_error(e)
@@ -999,7 +1019,6 @@ module Google
999
1019
 
1000
1020
  @attached_clusters_stub.call_rpc :get_attached_server_config, request, options: options do |response, operation|
1001
1021
  yield response, operation if block_given?
1002
- return response
1003
1022
  end
1004
1023
  rescue ::GRPC::BadStatus => e
1005
1024
  raise ::Google::Cloud::Error.from_error(e)
@@ -1116,7 +1135,6 @@ module Google
1116
1135
 
1117
1136
  @attached_clusters_stub.call_rpc :generate_attached_cluster_install_manifest, request, options: options do |response, operation|
1118
1137
  yield response, operation if block_given?
1119
- return response
1120
1138
  end
1121
1139
  rescue ::GRPC::BadStatus => e
1122
1140
  raise ::Google::Cloud::Error.from_error(e)
@@ -1218,7 +1236,6 @@ module Google
1218
1236
 
1219
1237
  @attached_clusters_stub.call_rpc :generate_attached_cluster_agent_token, request, options: options do |response, operation|
1220
1238
  yield response, operation if block_given?
1221
- return response
1222
1239
  end
1223
1240
  rescue ::GRPC::BadStatus => e
1224
1241
  raise ::Google::Cloud::Error.from_error(e)
@@ -1307,6 +1324,11 @@ module Google
1307
1324
  # default endpoint URL. The default value of nil uses the environment
1308
1325
  # universe (usually the default "googleapis.com" universe).
1309
1326
  # @return [::String,nil]
1327
+ # @!attribute [rw] logger
1328
+ # A custom logger to use for request/response debug logging, or the value
1329
+ # `:default` (the default) to construct a default logger, or `nil` to
1330
+ # explicitly disable logging.
1331
+ # @return [::Logger,:default,nil]
1310
1332
  #
1311
1333
  class Configuration
1312
1334
  extend ::Gapic::Config
@@ -1331,6 +1353,7 @@ module Google
1331
1353
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1332
1354
  config_attr :quota_project, nil, ::String, nil
1333
1355
  config_attr :universe_domain, nil, ::String, nil
1356
+ config_attr :logger, :default, ::Logger, nil, :default
1334
1357
 
1335
1358
  # @private
1336
1359
  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)
@@ -362,6 +382,7 @@ module Google
362
382
  # * `proxy_config.kubernetes_secret.name`.
363
383
  # * `proxy_config.kubernetes_secret.namespace`.
364
384
  # * `security_posture_config.vulnerability_mode`
385
+ # * `monitoring_config.cloud_monitoring_config.enabled`
365
386
  # @yield [result, operation] Access the result along with the TransportOperation object
366
387
  # @yieldparam result [::Gapic::Operation]
367
388
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -423,7 +444,7 @@ module Google
423
444
  @attached_clusters_stub.update_attached_cluster request, options do |result, operation|
424
445
  result = ::Gapic::Operation.new result, @operations_client, options: options
425
446
  yield result, operation if block_given?
426
- return result
447
+ throw :response, result
427
448
  end
428
449
  rescue ::Gapic::Rest::Error => e
429
450
  raise ::Google::Cloud::Error.from_error(e)
@@ -542,7 +563,7 @@ module Google
542
563
  @attached_clusters_stub.import_attached_cluster request, options do |result, operation|
543
564
  result = ::Gapic::Operation.new result, @operations_client, options: options
544
565
  yield result, operation if block_given?
545
- return result
566
+ throw :response, result
546
567
  end
547
568
  rescue ::Gapic::Rest::Error => e
548
569
  raise ::Google::Cloud::Error.from_error(e)
@@ -630,7 +651,6 @@ module Google
630
651
 
631
652
  @attached_clusters_stub.get_attached_cluster request, options do |result, operation|
632
653
  yield result, operation if block_given?
633
- return result
634
654
  end
635
655
  rescue ::Gapic::Rest::Error => e
636
656
  raise ::Google::Cloud::Error.from_error(e)
@@ -733,7 +753,7 @@ module Google
733
753
  @attached_clusters_stub.list_attached_clusters request, options do |result, operation|
734
754
  result = ::Gapic::Rest::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, "attached_clusters", request, result, options
735
755
  yield result, operation if block_given?
736
- return result
756
+ throw :response, result
737
757
  end
738
758
  rescue ::Gapic::Rest::Error => e
739
759
  raise ::Google::Cloud::Error.from_error(e)
@@ -855,7 +875,7 @@ module Google
855
875
  @attached_clusters_stub.delete_attached_cluster request, options do |result, operation|
856
876
  result = ::Gapic::Operation.new result, @operations_client, options: options
857
877
  yield result, operation if block_given?
858
- return result
878
+ throw :response, result
859
879
  end
860
880
  rescue ::Gapic::Rest::Error => e
861
881
  raise ::Google::Cloud::Error.from_error(e)
@@ -943,7 +963,6 @@ module Google
943
963
 
944
964
  @attached_clusters_stub.get_attached_server_config request, options do |result, operation|
945
965
  yield result, operation if block_given?
946
- return result
947
966
  end
948
967
  rescue ::Gapic::Rest::Error => e
949
968
  raise ::Google::Cloud::Error.from_error(e)
@@ -1053,7 +1072,6 @@ module Google
1053
1072
 
1054
1073
  @attached_clusters_stub.generate_attached_cluster_install_manifest request, options do |result, operation|
1055
1074
  yield result, operation if block_given?
1056
- return result
1057
1075
  end
1058
1076
  rescue ::Gapic::Rest::Error => e
1059
1077
  raise ::Google::Cloud::Error.from_error(e)
@@ -1148,7 +1166,6 @@ module Google
1148
1166
 
1149
1167
  @attached_clusters_stub.generate_attached_cluster_agent_token request, options do |result, operation|
1150
1168
  yield result, operation if block_given?
1151
- return result
1152
1169
  end
1153
1170
  rescue ::Gapic::Rest::Error => e
1154
1171
  raise ::Google::Cloud::Error.from_error(e)
@@ -1228,6 +1245,11 @@ module Google
1228
1245
  # default endpoint URL. The default value of nil uses the environment
1229
1246
  # universe (usually the default "googleapis.com" universe).
1230
1247
  # @return [::String,nil]
1248
+ # @!attribute [rw] logger
1249
+ # A custom logger to use for request/response debug logging, or the value
1250
+ # `:default` (the default) to construct a default logger, or `nil` to
1251
+ # explicitly disable logging.
1252
+ # @return [::Logger,:default,nil]
1231
1253
  #
1232
1254
  class Configuration
1233
1255
  extend ::Gapic::Config
@@ -1249,6 +1271,7 @@ module Google
1249
1271
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1250
1272
  config_attr :quota_project, nil, ::String, nil
1251
1273
  config_attr :universe_domain, nil, ::String, nil
1274
+ config_attr :logger, :default, ::Logger, nil, :default
1252
1275
 
1253
1276
  # @private
1254
1277
  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
  ##