google-cloud-gke_multi_cloud-v1 0.11.0 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
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
  ##