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
data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/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: false,
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 create_attached_cluster 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: "create_attached_cluster",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Longrunning::Operation.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: "update_attached_cluster",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Longrunning::Operation.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: "import_attached_cluster",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "get_attached_cluster",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::GkeMultiCloud::V1::AttachedCluster.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_attached_clusters",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Cloud::GkeMultiCloud::V1::ListAttachedClustersResponse.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: "delete_attached_cluster",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Longrunning::Operation.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_attached_server_config",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Cloud::GkeMultiCloud::V1::AttachedServerConfig.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: "generate_attached_cluster_install_manifest",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::GkeMultiCloud::V1::GenerateAttachedClusterInstallManifestResponse.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: "generate_attached_cluster_agent_token",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Cloud::GkeMultiCloud::V1::GenerateAttachedClusterAgentTokenResponse.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
  ##
data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/client.rb CHANGED
@@ -224,8 +224,19 @@ module Google
224
224
  universe_domain: @config.universe_domain,
225
225
  channel_args: @config.channel_args,
226
226
  interceptors: @config.interceptors,
227
- channel_pool_config: @config.channel_pool
227
+ channel_pool_config: @config.channel_pool,
228
+ logger: @config.logger
228
229
  )
230
+
231
+ @aws_clusters_stub.stub_logger&.info do |entry|
232
+ entry.set_system_name
233
+ entry.set_service
234
+ entry.message = "Created client for #{entry.service}"
235
+ entry.set_credentials_fields credentials
236
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
237
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
238
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
239
+ end
229
240
  end
230
241
 
231
242
  ##
@@ -235,6 +246,15 @@ module Google
235
246
  #
236
247
  attr_reader :operations_client
237
248
 
249
+ ##
250
+ # The logger used for request/response debug logging.
251
+ #
252
+ # @return [Logger]
253
+ #
254
+ def logger
255
+ @aws_clusters_stub.logger
256
+ end
257
+
238
258
  # Service calls
239
259
 
240
260
  ##
@@ -352,7 +372,7 @@ module Google
352
372
  @aws_clusters_stub.call_rpc :create_aws_cluster, request, options: options do |response, operation|
353
373
  response = ::Gapic::Operation.new response, @operations_client, options: options
354
374
  yield response, operation if block_given?
355
- return response
375
+ throw :response, response
356
376
  end
357
377
  rescue ::GRPC::BadStatus => e
358
378
  raise ::Google::Cloud::Error.from_error(e)
@@ -481,7 +501,7 @@ module Google
481
501
  @aws_clusters_stub.call_rpc :update_aws_cluster, request, options: options do |response, operation|
482
502
  response = ::Gapic::Operation.new response, @operations_client, options: options
483
503
  yield response, operation if block_given?
484
- return response
504
+ throw :response, response
485
505
  end
486
506
  rescue ::GRPC::BadStatus => e
487
507
  raise ::Google::Cloud::Error.from_error(e)
@@ -576,7 +596,6 @@ module Google
576
596
 
577
597
  @aws_clusters_stub.call_rpc :get_aws_cluster, request, options: options do |response, operation|
578
598
  yield response, operation if block_given?
579
- return response
580
599
  end
581
600
  rescue ::GRPC::BadStatus => e
582
601
  raise ::Google::Cloud::Error.from_error(e)
@@ -686,7 +705,7 @@ module Google
686
705
  @aws_clusters_stub.call_rpc :list_aws_clusters, request, options: options do |response, operation|
687
706
  response = ::Gapic::PagedEnumerable.new @aws_clusters_stub, :list_aws_clusters, request, response, operation, options
688
707
  yield response, operation if block_given?
689
- return response
708
+ throw :response, response
690
709
  end
691
710
  rescue ::GRPC::BadStatus => e
692
711
  raise ::Google::Cloud::Error.from_error(e)
@@ -817,7 +836,7 @@ module Google
817
836
  @aws_clusters_stub.call_rpc :delete_aws_cluster, request, options: options do |response, operation|
818
837
  response = ::Gapic::Operation.new response, @operations_client, options: options
819
838
  yield response, operation if block_given?
820
- return response
839
+ throw :response, response
821
840
  end
822
841
  rescue ::GRPC::BadStatus => e
823
842
  raise ::Google::Cloud::Error.from_error(e)
@@ -921,7 +940,6 @@ module Google
921
940
 
922
941
  @aws_clusters_stub.call_rpc :generate_aws_cluster_agent_token, request, options: options do |response, operation|
923
942
  yield response, operation if block_given?
924
- return response
925
943
  end
926
944
  rescue ::GRPC::BadStatus => e
927
945
  raise ::Google::Cloud::Error.from_error(e)
@@ -1016,7 +1034,6 @@ module Google
1016
1034
 
1017
1035
  @aws_clusters_stub.call_rpc :generate_aws_access_token, request, options: options do |response, operation|
1018
1036
  yield response, operation if block_given?
1019
- return response
1020
1037
  end
1021
1038
  rescue ::GRPC::BadStatus => e
1022
1039
  raise ::Google::Cloud::Error.from_error(e)
@@ -1138,7 +1155,7 @@ module Google
1138
1155
  @aws_clusters_stub.call_rpc :create_aws_node_pool, request, options: options do |response, operation|
1139
1156
  response = ::Gapic::Operation.new response, @operations_client, options: options
1140
1157
  yield response, operation if block_given?
1141
- return response
1158
+ throw :response, response
1142
1159
  end
1143
1160
  rescue ::GRPC::BadStatus => e
1144
1161
  raise ::Google::Cloud::Error.from_error(e)
@@ -1270,7 +1287,7 @@ module Google
1270
1287
  @aws_clusters_stub.call_rpc :update_aws_node_pool, request, options: options do |response, operation|
1271
1288
  response = ::Gapic::Operation.new response, @operations_client, options: options
1272
1289
  yield response, operation if block_given?
1273
- return response
1290
+ throw :response, response
1274
1291
  end
1275
1292
  rescue ::GRPC::BadStatus => e
1276
1293
  raise ::Google::Cloud::Error.from_error(e)
@@ -1380,7 +1397,7 @@ module Google
1380
1397
  @aws_clusters_stub.call_rpc :rollback_aws_node_pool_update, request, options: options do |response, operation|
1381
1398
  response = ::Gapic::Operation.new response, @operations_client, options: options
1382
1399
  yield response, operation if block_given?
1383
- return response
1400
+ throw :response, response
1384
1401
  end
1385
1402
  rescue ::GRPC::BadStatus => e
1386
1403
  raise ::Google::Cloud::Error.from_error(e)
@@ -1475,7 +1492,6 @@ module Google
1475
1492
 
1476
1493
  @aws_clusters_stub.call_rpc :get_aws_node_pool, request, options: options do |response, operation|
1477
1494
  yield response, operation if block_given?
1478
- return response
1479
1495
  end
1480
1496
  rescue ::GRPC::BadStatus => e
1481
1497
  raise ::Google::Cloud::Error.from_error(e)
@@ -1587,7 +1603,7 @@ module Google
1587
1603
  @aws_clusters_stub.call_rpc :list_aws_node_pools, request, options: options do |response, operation|
1588
1604
  response = ::Gapic::PagedEnumerable.new @aws_clusters_stub, :list_aws_node_pools, request, response, operation, options
1589
1605
  yield response, operation if block_given?
1590
- return response
1606
+ throw :response, response
1591
1607
  end
1592
1608
  rescue ::GRPC::BadStatus => e
1593
1609
  raise ::Google::Cloud::Error.from_error(e)
@@ -1716,7 +1732,7 @@ module Google
1716
1732
  @aws_clusters_stub.call_rpc :delete_aws_node_pool, request, options: options do |response, operation|
1717
1733
  response = ::Gapic::Operation.new response, @operations_client, options: options
1718
1734
  yield response, operation if block_given?
1719
- return response
1735
+ throw :response, response
1720
1736
  end
1721
1737
  rescue ::GRPC::BadStatus => e
1722
1738
  raise ::Google::Cloud::Error.from_error(e)
@@ -1808,7 +1824,6 @@ module Google
1808
1824
 
1809
1825
  @aws_clusters_stub.call_rpc :get_aws_open_id_config, request, options: options do |response, operation|
1810
1826
  yield response, operation if block_given?
1811
- return response
1812
1827
  end
1813
1828
  rescue ::GRPC::BadStatus => e
1814
1829
  raise ::Google::Cloud::Error.from_error(e)
@@ -1897,7 +1912,6 @@ module Google
1897
1912
 
1898
1913
  @aws_clusters_stub.call_rpc :get_aws_json_web_keys, request, options: options do |response, operation|
1899
1914
  yield response, operation if block_given?
1900
- return response
1901
1915
  end
1902
1916
  rescue ::GRPC::BadStatus => e
1903
1917
  raise ::Google::Cloud::Error.from_error(e)
@@ -1992,7 +2006,6 @@ module Google
1992
2006
 
1993
2007
  @aws_clusters_stub.call_rpc :get_aws_server_config, request, options: options do |response, operation|
1994
2008
  yield response, operation if block_given?
1995
- return response
1996
2009
  end
1997
2010
  rescue ::GRPC::BadStatus => e
1998
2011
  raise ::Google::Cloud::Error.from_error(e)
@@ -2081,6 +2094,11 @@ module Google
2081
2094
  # default endpoint URL. The default value of nil uses the environment
2082
2095
  # universe (usually the default "googleapis.com" universe).
2083
2096
  # @return [::String,nil]
2097
+ # @!attribute [rw] logger
2098
+ # A custom logger to use for request/response debug logging, or the value
2099
+ # `:default` (the default) to construct a default logger, or `nil` to
2100
+ # explicitly disable logging.
2101
+ # @return [::Logger,:default,nil]
2084
2102
  #
2085
2103
  class Configuration
2086
2104
  extend ::Gapic::Config
@@ -2105,6 +2123,7 @@ module Google
2105
2123
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2106
2124
  config_attr :quota_project, nil, ::String, nil
2107
2125
  config_attr :universe_domain, nil, ::String, nil
2126
+ config_attr :logger, :default, ::Logger, nil, :default
2108
2127
 
2109
2128
  # @private
2110
2129
  def initialize parent_config = nil
data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/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)
@@ -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