google-cloud-network_connectivity-v1 1.1.0 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6c3c0df2036e7253239435244fdc58ab0f32bb1a0fc744247f76bfe811428571
4
- data.tar.gz: 69c0749cc6e5f026e98768de795bb3ff36bee39355f31b9c7473582c02931e10
3
+ metadata.gz: 7e71fb4a3f178f5272e034eadba2b9f2b27f17f2a06552330e3ece9c39a8fc5b
4
+ data.tar.gz: 8be086c55e4c6ea22ed1f517691f32c570a3179b283a5d20b627fac817ef98dd
5
5
  SHA512:
6
- metadata.gz: 94279a310101193f4439673ce354f2f14c0cfeff48c506624dbf6fe1a8b5a0da2609d5a3f1e02a630b224ef987f0f93db9c7b50eb3ea69d6c0ca070de479eb3a
7
- data.tar.gz: 8376aa3d4a5e7a16f246ec9093d1a630df8e76a8ec19f35bbc4a3b195a174e0089c5fb9f692ea8cbf45e7414e97a0743ab5d9e88a9bd801beb70c3974f2c8d06
6
+ metadata.gz: 1d25c476d3e2d4ba80e94ee653a95eba888d715046146ea5dc508d0c7916dc2752f78946736675334e5d6f27ef11d511bb961e2c16794a6d7066f9a1bcca5305
7
+ data.tar.gz: 32e39ea17475c3d4dc98d126551243b3f8949e139ca1ebc84cde66cfdcfb9f281d43fec3a839c81a2ccd19d2f74368edccc793cf1981e9fe4465ca4968655206
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/network-connectivity/docs)
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/network_connectivity/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::NetworkConnectivity::V1::HubService::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).
@@ -185,14 +185,26 @@ module Google
185
185
  universe_domain: @config.universe_domain,
186
186
  channel_args: @config.channel_args,
187
187
  interceptors: @config.interceptors,
188
- channel_pool_config: @config.channel_pool
188
+ channel_pool_config: @config.channel_pool,
189
+ logger: @config.logger
189
190
  )
190
191
 
192
+ @hub_service_stub.stub_logger&.info do |entry|
193
+ entry.set_system_name
194
+ entry.set_service
195
+ entry.message = "Created client for #{entry.service}"
196
+ entry.set_credentials_fields credentials
197
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
198
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
199
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
200
+ end
201
+
191
202
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
192
203
  config.credentials = credentials
193
204
  config.quota_project = @quota_project_id
194
205
  config.endpoint = @hub_service_stub.endpoint
195
206
  config.universe_domain = @hub_service_stub.universe_domain
207
+ config.logger = @hub_service_stub.logger if config.respond_to? :logger=
196
208
  end
197
209
 
198
210
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -200,6 +212,7 @@ module Google
200
212
  config.quota_project = @quota_project_id
201
213
  config.endpoint = @hub_service_stub.endpoint
202
214
  config.universe_domain = @hub_service_stub.universe_domain
215
+ config.logger = @hub_service_stub.logger if config.respond_to? :logger=
203
216
  end
204
217
  end
205
218
 
@@ -224,6 +237,15 @@ module Google
224
237
  #
225
238
  attr_reader :iam_policy_client
226
239
 
240
+ ##
241
+ # The logger used for request/response debug logging.
242
+ #
243
+ # @return [Logger]
244
+ #
245
+ def logger
246
+ @hub_service_stub.logger
247
+ end
248
+
227
249
  # Service calls
228
250
 
229
251
  ##
@@ -319,7 +341,7 @@ module Google
319
341
  @hub_service_stub.call_rpc :list_hubs, request, options: options do |response, operation|
320
342
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_hubs, request, response, operation, options
321
343
  yield response, operation if block_given?
322
- return response
344
+ throw :response, response
323
345
  end
324
346
  rescue ::GRPC::BadStatus => e
325
347
  raise ::Google::Cloud::Error.from_error(e)
@@ -405,7 +427,6 @@ module Google
405
427
 
406
428
  @hub_service_stub.call_rpc :get_hub, request, options: options do |response, operation|
407
429
  yield response, operation if block_given?
408
- return response
409
430
  end
410
431
  rescue ::GRPC::BadStatus => e
411
432
  raise ::Google::Cloud::Error.from_error(e)
@@ -518,7 +539,7 @@ module Google
518
539
  @hub_service_stub.call_rpc :create_hub, request, options: options do |response, operation|
519
540
  response = ::Gapic::Operation.new response, @operations_client, options: options
520
541
  yield response, operation if block_given?
521
- return response
542
+ throw :response, response
522
543
  end
523
544
  rescue ::GRPC::BadStatus => e
524
545
  raise ::Google::Cloud::Error.from_error(e)
@@ -634,7 +655,7 @@ module Google
634
655
  @hub_service_stub.call_rpc :update_hub, request, options: options do |response, operation|
635
656
  response = ::Gapic::Operation.new response, @operations_client, options: options
636
657
  yield response, operation if block_given?
637
- return response
658
+ throw :response, response
638
659
  end
639
660
  rescue ::GRPC::BadStatus => e
640
661
  raise ::Google::Cloud::Error.from_error(e)
@@ -743,7 +764,7 @@ module Google
743
764
  @hub_service_stub.call_rpc :delete_hub, request, options: options do |response, operation|
744
765
  response = ::Gapic::Operation.new response, @operations_client, options: options
745
766
  yield response, operation if block_given?
746
- return response
767
+ throw :response, response
747
768
  end
748
769
  rescue ::GRPC::BadStatus => e
749
770
  raise ::Google::Cloud::Error.from_error(e)
@@ -857,7 +878,7 @@ module Google
857
878
  @hub_service_stub.call_rpc :list_hub_spokes, request, options: options do |response, operation|
858
879
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_hub_spokes, request, response, operation, options
859
880
  yield response, operation if block_given?
860
- return response
881
+ throw :response, response
861
882
  end
862
883
  rescue ::GRPC::BadStatus => e
863
884
  raise ::Google::Cloud::Error.from_error(e)
@@ -983,7 +1004,7 @@ module Google
983
1004
  @hub_service_stub.call_rpc :query_hub_status, request, options: options do |response, operation|
984
1005
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :query_hub_status, request, response, operation, options
985
1006
  yield response, operation if block_given?
986
- return response
1007
+ throw :response, response
987
1008
  end
988
1009
  rescue ::GRPC::BadStatus => e
989
1010
  raise ::Google::Cloud::Error.from_error(e)
@@ -1083,7 +1104,7 @@ module Google
1083
1104
  @hub_service_stub.call_rpc :list_spokes, request, options: options do |response, operation|
1084
1105
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_spokes, request, response, operation, options
1085
1106
  yield response, operation if block_given?
1086
- return response
1107
+ throw :response, response
1087
1108
  end
1088
1109
  rescue ::GRPC::BadStatus => e
1089
1110
  raise ::Google::Cloud::Error.from_error(e)
@@ -1169,7 +1190,6 @@ module Google
1169
1190
 
1170
1191
  @hub_service_stub.call_rpc :get_spoke, request, options: options do |response, operation|
1171
1192
  yield response, operation if block_given?
1172
- return response
1173
1193
  end
1174
1194
  rescue ::GRPC::BadStatus => e
1175
1195
  raise ::Google::Cloud::Error.from_error(e)
@@ -1282,7 +1302,7 @@ module Google
1282
1302
  @hub_service_stub.call_rpc :create_spoke, request, options: options do |response, operation|
1283
1303
  response = ::Gapic::Operation.new response, @operations_client, options: options
1284
1304
  yield response, operation if block_given?
1285
- return response
1305
+ throw :response, response
1286
1306
  end
1287
1307
  rescue ::GRPC::BadStatus => e
1288
1308
  raise ::Google::Cloud::Error.from_error(e)
@@ -1397,7 +1417,7 @@ module Google
1397
1417
  @hub_service_stub.call_rpc :update_spoke, request, options: options do |response, operation|
1398
1418
  response = ::Gapic::Operation.new response, @operations_client, options: options
1399
1419
  yield response, operation if block_given?
1400
- return response
1420
+ throw :response, response
1401
1421
  end
1402
1422
  rescue ::GRPC::BadStatus => e
1403
1423
  raise ::Google::Cloud::Error.from_error(e)
@@ -1513,7 +1533,7 @@ module Google
1513
1533
  @hub_service_stub.call_rpc :reject_hub_spoke, request, options: options do |response, operation|
1514
1534
  response = ::Gapic::Operation.new response, @operations_client, options: options
1515
1535
  yield response, operation if block_given?
1516
- return response
1536
+ throw :response, response
1517
1537
  end
1518
1538
  rescue ::GRPC::BadStatus => e
1519
1539
  raise ::Google::Cloud::Error.from_error(e)
@@ -1625,7 +1645,7 @@ module Google
1625
1645
  @hub_service_stub.call_rpc :accept_hub_spoke, request, options: options do |response, operation|
1626
1646
  response = ::Gapic::Operation.new response, @operations_client, options: options
1627
1647
  yield response, operation if block_given?
1628
- return response
1648
+ throw :response, response
1629
1649
  end
1630
1650
  rescue ::GRPC::BadStatus => e
1631
1651
  raise ::Google::Cloud::Error.from_error(e)
@@ -1734,7 +1754,7 @@ module Google
1734
1754
  @hub_service_stub.call_rpc :delete_spoke, request, options: options do |response, operation|
1735
1755
  response = ::Gapic::Operation.new response, @operations_client, options: options
1736
1756
  yield response, operation if block_given?
1737
- return response
1757
+ throw :response, response
1738
1758
  end
1739
1759
  rescue ::GRPC::BadStatus => e
1740
1760
  raise ::Google::Cloud::Error.from_error(e)
@@ -1820,7 +1840,6 @@ module Google
1820
1840
 
1821
1841
  @hub_service_stub.call_rpc :get_route_table, request, options: options do |response, operation|
1822
1842
  yield response, operation if block_given?
1823
- return response
1824
1843
  end
1825
1844
  rescue ::GRPC::BadStatus => e
1826
1845
  raise ::Google::Cloud::Error.from_error(e)
@@ -1906,7 +1925,6 @@ module Google
1906
1925
 
1907
1926
  @hub_service_stub.call_rpc :get_route, request, options: options do |response, operation|
1908
1927
  yield response, operation if block_given?
1909
- return response
1910
1928
  end
1911
1929
  rescue ::GRPC::BadStatus => e
1912
1930
  raise ::Google::Cloud::Error.from_error(e)
@@ -2005,7 +2023,7 @@ module Google
2005
2023
  @hub_service_stub.call_rpc :list_routes, request, options: options do |response, operation|
2006
2024
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_routes, request, response, operation, options
2007
2025
  yield response, operation if block_given?
2008
- return response
2026
+ throw :response, response
2009
2027
  end
2010
2028
  rescue ::GRPC::BadStatus => e
2011
2029
  raise ::Google::Cloud::Error.from_error(e)
@@ -2104,7 +2122,7 @@ module Google
2104
2122
  @hub_service_stub.call_rpc :list_route_tables, request, options: options do |response, operation|
2105
2123
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_route_tables, request, response, operation, options
2106
2124
  yield response, operation if block_given?
2107
- return response
2125
+ throw :response, response
2108
2126
  end
2109
2127
  rescue ::GRPC::BadStatus => e
2110
2128
  raise ::Google::Cloud::Error.from_error(e)
@@ -2190,7 +2208,6 @@ module Google
2190
2208
 
2191
2209
  @hub_service_stub.call_rpc :get_group, request, options: options do |response, operation|
2192
2210
  yield response, operation if block_given?
2193
- return response
2194
2211
  end
2195
2212
  rescue ::GRPC::BadStatus => e
2196
2213
  raise ::Google::Cloud::Error.from_error(e)
@@ -2289,7 +2306,7 @@ module Google
2289
2306
  @hub_service_stub.call_rpc :list_groups, request, options: options do |response, operation|
2290
2307
  response = ::Gapic::PagedEnumerable.new @hub_service_stub, :list_groups, request, response, operation, options
2291
2308
  yield response, operation if block_given?
2292
- return response
2309
+ throw :response, response
2293
2310
  end
2294
2311
  rescue ::GRPC::BadStatus => e
2295
2312
  raise ::Google::Cloud::Error.from_error(e)
@@ -2404,7 +2421,7 @@ module Google
2404
2421
  @hub_service_stub.call_rpc :update_group, request, options: options do |response, operation|
2405
2422
  response = ::Gapic::Operation.new response, @operations_client, options: options
2406
2423
  yield response, operation if block_given?
2407
- return response
2424
+ throw :response, response
2408
2425
  end
2409
2426
  rescue ::GRPC::BadStatus => e
2410
2427
  raise ::Google::Cloud::Error.from_error(e)
@@ -2493,6 +2510,11 @@ module Google
2493
2510
  # default endpoint URL. The default value of nil uses the environment
2494
2511
  # universe (usually the default "googleapis.com" universe).
2495
2512
  # @return [::String,nil]
2513
+ # @!attribute [rw] logger
2514
+ # A custom logger to use for request/response debug logging, or the value
2515
+ # `:default` (the default) to construct a default logger, or `nil` to
2516
+ # explicitly disable logging.
2517
+ # @return [::Logger,:default,nil]
2496
2518
  #
2497
2519
  class Configuration
2498
2520
  extend ::Gapic::Config
@@ -2517,6 +2539,7 @@ module Google
2517
2539
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2518
2540
  config_attr :quota_project, nil, ::String, nil
2519
2541
  config_attr :universe_domain, nil, ::String, nil
2542
+ config_attr :logger, :default, ::Logger, nil, :default
2520
2543
 
2521
2544
  # @private
2522
2545
  def initialize parent_config = nil
@@ -213,7 +213,7 @@ module Google
213
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
214
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
215
215
  yield response, operation if block_given?
216
- return response
216
+ throw :response, response
217
217
  end
218
218
  rescue ::GRPC::BadStatus => e
219
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -309,7 +309,7 @@ module Google
309
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
310
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
311
311
  yield response, operation if block_given?
312
- return response
312
+ throw :response, response
313
313
  end
314
314
  rescue ::GRPC::BadStatus => e
315
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +398,6 @@ module Google
398
398
 
399
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
400
400
  yield response, operation if block_given?
401
- return response
402
401
  end
403
402
  rescue ::GRPC::BadStatus => e
404
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -494,7 +493,6 @@ module Google
494
493
 
495
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
496
495
  yield response, operation if block_given?
497
- return response
498
496
  end
499
497
  rescue ::GRPC::BadStatus => e
500
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -592,7 +590,7 @@ module Google
592
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
593
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
594
592
  yield response, operation if block_given?
595
- return response
593
+ throw :response, response
596
594
  end
597
595
  rescue ::GRPC::BadStatus => e
598
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -681,6 +679,11 @@ module Google
681
679
  # default endpoint URL. The default value of nil uses the environment
682
680
  # universe (usually the default "googleapis.com" universe).
683
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]
684
687
  #
685
688
  class Configuration
686
689
  extend ::Gapic::Config
@@ -705,6 +708,7 @@ module Google
705
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
706
709
  config_attr :quota_project, nil, ::String, nil
707
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
708
712
 
709
713
  # @private
710
714
  def initialize parent_config = nil
@@ -176,14 +176,26 @@ module Google
176
176
  universe_domain: @config.universe_domain,
177
177
  channel_args: @config.channel_args,
178
178
  interceptors: @config.interceptors,
179
- channel_pool_config: @config.channel_pool
179
+ channel_pool_config: @config.channel_pool,
180
+ logger: @config.logger
180
181
  )
181
182
 
183
+ @policy_based_routing_service_stub.stub_logger&.info do |entry|
184
+ entry.set_system_name
185
+ entry.set_service
186
+ entry.message = "Created client for #{entry.service}"
187
+ entry.set_credentials_fields credentials
188
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
189
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
190
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
191
+ end
192
+
182
193
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
183
194
  config.credentials = credentials
184
195
  config.quota_project = @quota_project_id
185
196
  config.endpoint = @policy_based_routing_service_stub.endpoint
186
197
  config.universe_domain = @policy_based_routing_service_stub.universe_domain
198
+ config.logger = @policy_based_routing_service_stub.logger if config.respond_to? :logger=
187
199
  end
188
200
 
189
201
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -191,6 +203,7 @@ module Google
191
203
  config.quota_project = @quota_project_id
192
204
  config.endpoint = @policy_based_routing_service_stub.endpoint
193
205
  config.universe_domain = @policy_based_routing_service_stub.universe_domain
206
+ config.logger = @policy_based_routing_service_stub.logger if config.respond_to? :logger=
194
207
  end
195
208
  end
196
209
 
@@ -215,6 +228,15 @@ module Google
215
228
  #
216
229
  attr_reader :iam_policy_client
217
230
 
231
+ ##
232
+ # The logger used for request/response debug logging.
233
+ #
234
+ # @return [Logger]
235
+ #
236
+ def logger
237
+ @policy_based_routing_service_stub.logger
238
+ end
239
+
218
240
  # Service calls
219
241
 
220
242
  ##
@@ -310,7 +332,7 @@ module Google
310
332
  @policy_based_routing_service_stub.call_rpc :list_policy_based_routes, request, options: options do |response, operation|
311
333
  response = ::Gapic::PagedEnumerable.new @policy_based_routing_service_stub, :list_policy_based_routes, request, response, operation, options
312
334
  yield response, operation if block_given?
313
- return response
335
+ throw :response, response
314
336
  end
315
337
  rescue ::GRPC::BadStatus => e
316
338
  raise ::Google::Cloud::Error.from_error(e)
@@ -396,7 +418,6 @@ module Google
396
418
 
397
419
  @policy_based_routing_service_stub.call_rpc :get_policy_based_route, request, options: options do |response, operation|
398
420
  yield response, operation if block_given?
399
- return response
400
421
  end
401
422
  rescue ::GRPC::BadStatus => e
402
423
  raise ::Google::Cloud::Error.from_error(e)
@@ -508,7 +529,7 @@ module Google
508
529
  @policy_based_routing_service_stub.call_rpc :create_policy_based_route, request, options: options do |response, operation|
509
530
  response = ::Gapic::Operation.new response, @operations_client, options: options
510
531
  yield response, operation if block_given?
511
- return response
532
+ throw :response, response
512
533
  end
513
534
  rescue ::GRPC::BadStatus => e
514
535
  raise ::Google::Cloud::Error.from_error(e)
@@ -616,7 +637,7 @@ module Google
616
637
  @policy_based_routing_service_stub.call_rpc :delete_policy_based_route, request, options: options do |response, operation|
617
638
  response = ::Gapic::Operation.new response, @operations_client, options: options
618
639
  yield response, operation if block_given?
619
- return response
640
+ throw :response, response
620
641
  end
621
642
  rescue ::GRPC::BadStatus => e
622
643
  raise ::Google::Cloud::Error.from_error(e)
@@ -705,6 +726,11 @@ module Google
705
726
  # default endpoint URL. The default value of nil uses the environment
706
727
  # universe (usually the default "googleapis.com" universe).
707
728
  # @return [::String,nil]
729
+ # @!attribute [rw] logger
730
+ # A custom logger to use for request/response debug logging, or the value
731
+ # `:default` (the default) to construct a default logger, or `nil` to
732
+ # explicitly disable logging.
733
+ # @return [::Logger,:default,nil]
708
734
  #
709
735
  class Configuration
710
736
  extend ::Gapic::Config
@@ -729,6 +755,7 @@ module Google
729
755
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
730
756
  config_attr :quota_project, nil, ::String, nil
731
757
  config_attr :universe_domain, nil, ::String, nil
758
+ config_attr :logger, :default, ::Logger, nil, :default
732
759
 
733
760
  # @private
734
761
  def initialize parent_config = nil
@@ -213,7 +213,7 @@ module Google
213
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
214
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
215
215
  yield response, operation if block_given?
216
- return response
216
+ throw :response, response
217
217
  end
218
218
  rescue ::GRPC::BadStatus => e
219
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -309,7 +309,7 @@ module Google
309
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
310
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
311
311
  yield response, operation if block_given?
312
- return response
312
+ throw :response, response
313
313
  end
314
314
  rescue ::GRPC::BadStatus => e
315
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +398,6 @@ module Google
398
398
 
399
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
400
400
  yield response, operation if block_given?
401
- return response
402
401
  end
403
402
  rescue ::GRPC::BadStatus => e
404
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -494,7 +493,6 @@ module Google
494
493
 
495
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
496
495
  yield response, operation if block_given?
497
- return response
498
496
  end
499
497
  rescue ::GRPC::BadStatus => e
500
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -592,7 +590,7 @@ module Google
592
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
593
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
594
592
  yield response, operation if block_given?
595
- return response
593
+ throw :response, response
596
594
  end
597
595
  rescue ::GRPC::BadStatus => e
598
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -681,6 +679,11 @@ module Google
681
679
  # default endpoint URL. The default value of nil uses the environment
682
680
  # universe (usually the default "googleapis.com" universe).
683
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]
684
687
  #
685
688
  class Configuration
686
689
  extend ::Gapic::Config
@@ -705,6 +708,7 @@ module Google
705
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
706
709
  config_attr :quota_project, nil, ::String, nil
707
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
708
712
 
709
713
  # @private
710
714
  def initialize parent_config = nil
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module NetworkConnectivity
23
23
  module V1
24
- VERSION = "1.1.0"
24
+ VERSION = "1.2.0"
25
25
  end
26
26
  end
27
27
  end
@@ -306,9 +306,28 @@ module Google
306
306
  # @!attribute [rw] common
307
307
  # @return [::Google::Api::CommonLanguageSettings]
308
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
309
319
  class GoSettings
310
320
  include ::Google::Protobuf::MessageExts
311
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
312
331
  end
313
332
 
314
333
  # Describes the generator configuration for a method.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-network_connectivity-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-12-04 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -153,7 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
153
153
  - !ruby/object:Gem::Version
154
154
  version: '0'
155
155
  requirements: []
156
- rubygems_version: 3.5.22
156
+ rubygems_version: 3.5.23
157
157
  signing_key:
158
158
  specification_version: 4
159
159
  summary: This API enables connectivity with and between Google Cloud resources.