google-cloud-network_management-v1 1.3.0 → 1.4.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 32e77684d349ed3395980f0af7f32a474babdddf5819f5e318808819ad5d44dd
4
- data.tar.gz: c4adc2d2ce353bb63f37ef6401027605f7bab98f967605b82beb0f9cfb0eba1e
3
+ metadata.gz: 62b66ca130d7c7cf5d5c1af01f2cfb323b748a604877e10bd249a0b1efaf7b10
4
+ data.tar.gz: e259eca83d026c42359eb73a94415d2d0499e53e74c9114a1afd53d04812e8d6
5
5
  SHA512:
6
- metadata.gz: c43ccba54e110154ec537fdc531dede5aabdff725318816de50deb33f48fe1324c51afd392fe98e5dec39b939bea53c87e046b4bf04b0d6634eda7e82e97bc62
7
- data.tar.gz: de6b019888ba84f28fb98b0bfa83ba73a5e2ab0e9389d399ea15c7390e30c5a5f313923dff0ae39b202d47f0e6cb87270b758e711bceccc118157b00a7add904
6
+ metadata.gz: aa53f7f99569af3a31af3c2f9b92628e6540eda3f243aedf2de60e5526792b85bfd4585a04d295af20309ce23569abf66671e279c8a3833e89768324ade56a61
7
+ data.tar.gz: c88a87d922d5244d9215f47f824f1141ffae58c9332d13476a71de23944262e5e4e1751d9d2e5402010f4f034e7f3fd28d0e4863756a432ae5feb46a1b901dfa
data/README.md CHANGED
@@ -42,33 +42,43 @@ for class and method documentation.
42
42
  See also the [Product Documentation](https://cloud.google.com/network-intelligence-center/docs/connectivity-tests/reference/networkmanagement/rest)
43
43
  for general usage information.
44
44
 
45
- ## Enabling Logging
46
-
47
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
48
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
49
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
50
- 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)
51
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
52
-
53
- Configuring a Ruby stdlib logger:
45
+ ## Debug Logging
46
+
47
+ This library comes with opt-in Debug Logging that can help you troubleshoot
48
+ your application's integration with the API. When logging is activated, key
49
+ events such as requests and responses, along with data payloads and metadata
50
+ such as headers and client configuration, are logged to the standard error
51
+ stream.
52
+
53
+ **WARNING:** Client Library Debug Logging includes your data payloads in
54
+ plaintext, which could include sensitive data such as PII for yourself or your
55
+ customers, private keys, or other security data that could be compromising if
56
+ leaked. Always practice good data hygiene with your application logs, and follow
57
+ the principle of least access. Google also recommends that Client Library Debug
58
+ Logging be enabled only temporarily during active debugging, and not used
59
+ permanently in production.
60
+
61
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
62
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
63
+ list of client library gem names. This will select the default logging behavior,
64
+ which writes logs to the standard error stream. On a local workstation, this may
65
+ result in logs appearing on the console. When running on a Google Cloud hosting
66
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
67
+ results in logs appearing alongside your application logs in the
68
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
69
+
70
+ You can customize logging by modifying the `logger` configuration when
71
+ constructing a client object. For example:
54
72
 
55
73
  ```ruby
74
+ require "google/cloud/network_management/v1"
56
75
  require "logger"
57
76
 
58
- module MyLogger
59
- LOGGER = Logger.new $stderr, level: Logger::WARN
60
- def logger
61
- LOGGER
62
- end
63
- end
64
-
65
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
66
- module GRPC
67
- extend MyLogger
77
+ client = ::Google::Cloud::NetworkManagement::V1::ReachabilityService::Client.new do |config|
78
+ config.logger = Logger.new "my-app.log"
68
79
  end
69
80
  ```
70
81
 
71
-
72
82
  ## Google Cloud Samples
73
83
 
74
84
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -175,14 +175,26 @@ module Google
175
175
  universe_domain: @config.universe_domain,
176
176
  channel_args: @config.channel_args,
177
177
  interceptors: @config.interceptors,
178
- channel_pool_config: @config.channel_pool
178
+ channel_pool_config: @config.channel_pool,
179
+ logger: @config.logger
179
180
  )
180
181
 
182
+ @reachability_service_stub.stub_logger&.info do |entry|
183
+ entry.set_system_name
184
+ entry.set_service
185
+ entry.message = "Created client for #{entry.service}"
186
+ entry.set_credentials_fields credentials
187
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
188
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
189
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
190
+ end
191
+
181
192
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
182
193
  config.credentials = credentials
183
194
  config.quota_project = @quota_project_id
184
195
  config.endpoint = @reachability_service_stub.endpoint
185
196
  config.universe_domain = @reachability_service_stub.universe_domain
197
+ config.logger = @reachability_service_stub.logger if config.respond_to? :logger=
186
198
  end
187
199
 
188
200
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -190,6 +202,7 @@ module Google
190
202
  config.quota_project = @quota_project_id
191
203
  config.endpoint = @reachability_service_stub.endpoint
192
204
  config.universe_domain = @reachability_service_stub.universe_domain
205
+ config.logger = @reachability_service_stub.logger if config.respond_to? :logger=
193
206
  end
194
207
  end
195
208
 
@@ -214,6 +227,15 @@ module Google
214
227
  #
215
228
  attr_reader :iam_policy_client
216
229
 
230
+ ##
231
+ # The logger used for request/response debug logging.
232
+ #
233
+ # @return [Logger]
234
+ #
235
+ def logger
236
+ @reachability_service_stub.logger
237
+ end
238
+
217
239
  # Service calls
218
240
 
219
241
  ##
@@ -327,7 +349,7 @@ module Google
327
349
  @reachability_service_stub.call_rpc :list_connectivity_tests, request, options: options do |response, operation|
328
350
  response = ::Gapic::PagedEnumerable.new @reachability_service_stub, :list_connectivity_tests, request, response, operation, options
329
351
  yield response, operation if block_given?
330
- return response
352
+ throw :response, response
331
353
  end
332
354
  rescue ::GRPC::BadStatus => e
333
355
  raise ::Google::Cloud::Error.from_error(e)
@@ -414,7 +436,6 @@ module Google
414
436
 
415
437
  @reachability_service_stub.call_rpc :get_connectivity_test, request, options: options do |response, operation|
416
438
  yield response, operation if block_given?
417
- return response
418
439
  end
419
440
  rescue ::GRPC::BadStatus => e
420
441
  raise ::Google::Cloud::Error.from_error(e)
@@ -532,7 +553,7 @@ module Google
532
553
  @reachability_service_stub.call_rpc :create_connectivity_test, request, options: options do |response, operation|
533
554
  response = ::Gapic::Operation.new response, @operations_client, options: options
534
555
  yield response, operation if block_given?
535
- return response
556
+ throw :response, response
536
557
  end
537
558
  rescue ::GRPC::BadStatus => e
538
559
  raise ::Google::Cloud::Error.from_error(e)
@@ -642,7 +663,7 @@ module Google
642
663
  @reachability_service_stub.call_rpc :update_connectivity_test, request, options: options do |response, operation|
643
664
  response = ::Gapic::Operation.new response, @operations_client, options: options
644
665
  yield response, operation if block_given?
645
- return response
666
+ throw :response, response
646
667
  end
647
668
  rescue ::GRPC::BadStatus => e
648
669
  raise ::Google::Cloud::Error.from_error(e)
@@ -748,7 +769,7 @@ module Google
748
769
  @reachability_service_stub.call_rpc :rerun_connectivity_test, request, options: options do |response, operation|
749
770
  response = ::Gapic::Operation.new response, @operations_client, options: options
750
771
  yield response, operation if block_given?
751
- return response
772
+ throw :response, response
752
773
  end
753
774
  rescue ::GRPC::BadStatus => e
754
775
  raise ::Google::Cloud::Error.from_error(e)
@@ -843,7 +864,7 @@ module Google
843
864
  @reachability_service_stub.call_rpc :delete_connectivity_test, request, options: options do |response, operation|
844
865
  response = ::Gapic::Operation.new response, @operations_client, options: options
845
866
  yield response, operation if block_given?
846
- return response
867
+ throw :response, response
847
868
  end
848
869
  rescue ::GRPC::BadStatus => e
849
870
  raise ::Google::Cloud::Error.from_error(e)
@@ -932,6 +953,11 @@ module Google
932
953
  # default endpoint URL. The default value of nil uses the environment
933
954
  # universe (usually the default "googleapis.com" universe).
934
955
  # @return [::String,nil]
956
+ # @!attribute [rw] logger
957
+ # A custom logger to use for request/response debug logging, or the value
958
+ # `:default` (the default) to construct a default logger, or `nil` to
959
+ # explicitly disable logging.
960
+ # @return [::Logger,:default,nil]
935
961
  #
936
962
  class Configuration
937
963
  extend ::Gapic::Config
@@ -956,6 +982,7 @@ module Google
956
982
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
957
983
  config_attr :quota_project, nil, ::String, nil
958
984
  config_attr :universe_domain, nil, ::String, nil
985
+ config_attr :logger, :default, ::Logger, nil, :default
959
986
 
960
987
  # @private
961
988
  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
@@ -168,15 +168,27 @@ module Google
168
168
  endpoint: @config.endpoint,
169
169
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
170
170
  universe_domain: @config.universe_domain,
171
- credentials: credentials
171
+ credentials: credentials,
172
+ logger: @config.logger
172
173
  )
173
174
 
175
+ @reachability_service_stub.logger(stub: true)&.info do |entry|
176
+ entry.set_system_name
177
+ entry.set_service
178
+ entry.message = "Created client for #{entry.service}"
179
+ entry.set_credentials_fields credentials
180
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
181
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
182
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
183
+ end
184
+
174
185
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
175
186
  config.credentials = credentials
176
187
  config.quota_project = @quota_project_id
177
188
  config.endpoint = @reachability_service_stub.endpoint
178
189
  config.universe_domain = @reachability_service_stub.universe_domain
179
190
  config.bindings_override = @config.bindings_override
191
+ config.logger = @reachability_service_stub.logger if config.respond_to? :logger=
180
192
  end
181
193
 
182
194
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -185,6 +197,7 @@ module Google
185
197
  config.endpoint = @reachability_service_stub.endpoint
186
198
  config.universe_domain = @reachability_service_stub.universe_domain
187
199
  config.bindings_override = @config.bindings_override
200
+ config.logger = @reachability_service_stub.logger if config.respond_to? :logger=
188
201
  end
189
202
  end
190
203
 
@@ -209,6 +222,15 @@ module Google
209
222
  #
210
223
  attr_reader :iam_policy_client
211
224
 
225
+ ##
226
+ # The logger used for request/response debug logging.
227
+ #
228
+ # @return [Logger]
229
+ #
230
+ def logger
231
+ @reachability_service_stub.logger
232
+ end
233
+
212
234
  # Service calls
213
235
 
214
236
  ##
@@ -314,7 +336,6 @@ module Google
314
336
 
315
337
  @reachability_service_stub.list_connectivity_tests request, options do |result, operation|
316
338
  yield result, operation if block_given?
317
- return result
318
339
  end
319
340
  rescue ::Gapic::Rest::Error => e
320
341
  raise ::Google::Cloud::Error.from_error(e)
@@ -394,7 +415,6 @@ module Google
394
415
 
395
416
  @reachability_service_stub.get_connectivity_test request, options do |result, operation|
396
417
  yield result, operation if block_given?
397
- return result
398
418
  end
399
419
  rescue ::Gapic::Rest::Error => e
400
420
  raise ::Google::Cloud::Error.from_error(e)
@@ -505,7 +525,7 @@ module Google
505
525
  @reachability_service_stub.create_connectivity_test request, options do |result, operation|
506
526
  result = ::Gapic::Operation.new result, @operations_client, options: options
507
527
  yield result, operation if block_given?
508
- return result
528
+ throw :response, result
509
529
  end
510
530
  rescue ::Gapic::Rest::Error => e
511
531
  raise ::Google::Cloud::Error.from_error(e)
@@ -608,7 +628,7 @@ module Google
608
628
  @reachability_service_stub.update_connectivity_test request, options do |result, operation|
609
629
  result = ::Gapic::Operation.new result, @operations_client, options: options
610
630
  yield result, operation if block_given?
611
- return result
631
+ throw :response, result
612
632
  end
613
633
  rescue ::Gapic::Rest::Error => e
614
634
  raise ::Google::Cloud::Error.from_error(e)
@@ -707,7 +727,7 @@ module Google
707
727
  @reachability_service_stub.rerun_connectivity_test request, options do |result, operation|
708
728
  result = ::Gapic::Operation.new result, @operations_client, options: options
709
729
  yield result, operation if block_given?
710
- return result
730
+ throw :response, result
711
731
  end
712
732
  rescue ::Gapic::Rest::Error => e
713
733
  raise ::Google::Cloud::Error.from_error(e)
@@ -795,7 +815,7 @@ module Google
795
815
  @reachability_service_stub.delete_connectivity_test request, options do |result, operation|
796
816
  result = ::Gapic::Operation.new result, @operations_client, options: options
797
817
  yield result, operation if block_given?
798
- return result
818
+ throw :response, result
799
819
  end
800
820
  rescue ::Gapic::Rest::Error => e
801
821
  raise ::Google::Cloud::Error.from_error(e)
@@ -875,6 +895,11 @@ module Google
875
895
  # default endpoint URL. The default value of nil uses the environment
876
896
  # universe (usually the default "googleapis.com" universe).
877
897
  # @return [::String,nil]
898
+ # @!attribute [rw] logger
899
+ # A custom logger to use for request/response debug logging, or the value
900
+ # `:default` (the default) to construct a default logger, or `nil` to
901
+ # explicitly disable logging.
902
+ # @return [::Logger,:default,nil]
878
903
  #
879
904
  class Configuration
880
905
  extend ::Gapic::Config
@@ -903,6 +928,7 @@ module Google
903
928
  # by the host service.
904
929
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
905
930
  config_attr :bindings_override, {}, ::Hash, nil
931
+ config_attr :logger, :default, ::Logger, nil, :default
906
932
 
907
933
  # @private
908
934
  def initialize parent_config = nil
@@ -196,7 +196,7 @@ module Google
196
196
  @operations_stub.list_operations request, options do |result, operation|
197
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
198
198
  yield result, operation if block_given?
199
- return result
199
+ throw :response, result
200
200
  end
201
201
  rescue ::Gapic::Rest::Error => e
202
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -285,7 +285,7 @@ module Google
285
285
  @operations_stub.get_operation request, options do |result, operation|
286
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
287
287
  yield result, operation if block_given?
288
- return result
288
+ throw :response, result
289
289
  end
290
290
  rescue ::Gapic::Rest::Error => e
291
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -367,7 +367,6 @@ module Google
367
367
 
368
368
  @operations_stub.delete_operation request, options do |result, operation|
369
369
  yield result, operation if block_given?
370
- return result
371
370
  end
372
371
  rescue ::Gapic::Rest::Error => e
373
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -456,7 +455,6 @@ module Google
456
455
 
457
456
  @operations_stub.cancel_operation request, options do |result, operation|
458
457
  yield result, operation if block_given?
459
- return result
460
458
  end
461
459
  rescue ::Gapic::Rest::Error => e
462
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -536,6 +534,11 @@ module Google
536
534
  # default endpoint URL. The default value of nil uses the environment
537
535
  # universe (usually the default "googleapis.com" universe).
538
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]
539
542
  #
540
543
  class Configuration
541
544
  extend ::Gapic::Config
@@ -557,6 +560,7 @@ module Google
557
560
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
558
561
  config_attr :quota_project, nil, ::String, nil
559
562
  config_attr :universe_domain, nil, ::String, nil
563
+ config_attr :logger, :default, ::Logger, nil, :default
560
564
 
561
565
  # @private
562
566
  def initialize parent_config = nil
@@ -676,16 +680,18 @@ module Google
676
680
 
677
681
  response = @client_stub.make_http_request(
678
682
  verb,
679
- uri: uri,
680
- body: body || "",
681
- params: query_string_params,
683
+ uri: uri,
684
+ body: body || "",
685
+ params: query_string_params,
686
+ method_name: "list_operations",
682
687
  options: options
683
688
  )
684
689
  operation = ::Gapic::Rest::TransportOperation.new response
685
690
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
686
-
687
- yield result, operation if block_given?
688
- result
691
+ catch :response do
692
+ yield result, operation if block_given?
693
+ result
694
+ end
689
695
  end
690
696
 
691
697
  ##
@@ -714,16 +720,18 @@ module Google
714
720
 
715
721
  response = @client_stub.make_http_request(
716
722
  verb,
717
- uri: uri,
718
- body: body || "",
719
- params: query_string_params,
723
+ uri: uri,
724
+ body: body || "",
725
+ params: query_string_params,
726
+ method_name: "get_operation",
720
727
  options: options
721
728
  )
722
729
  operation = ::Gapic::Rest::TransportOperation.new response
723
730
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
724
-
725
- yield result, operation if block_given?
726
- result
731
+ catch :response do
732
+ yield result, operation if block_given?
733
+ result
734
+ end
727
735
  end
728
736
 
729
737
  ##
@@ -752,16 +760,18 @@ module Google
752
760
 
753
761
  response = @client_stub.make_http_request(
754
762
  verb,
755
- uri: uri,
756
- body: body || "",
757
- params: query_string_params,
763
+ uri: uri,
764
+ body: body || "",
765
+ params: query_string_params,
766
+ method_name: "delete_operation",
758
767
  options: options
759
768
  )
760
769
  operation = ::Gapic::Rest::TransportOperation.new response
761
770
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
762
-
763
- yield result, operation if block_given?
764
- result
771
+ catch :response do
772
+ yield result, operation if block_given?
773
+ result
774
+ end
765
775
  end
766
776
 
767
777
  ##
@@ -790,16 +800,18 @@ module Google
790
800
 
791
801
  response = @client_stub.make_http_request(
792
802
  verb,
793
- uri: uri,
794
- body: body || "",
795
- params: query_string_params,
803
+ uri: uri,
804
+ body: body || "",
805
+ params: query_string_params,
806
+ method_name: "cancel_operation",
796
807
  options: options
797
808
  )
798
809
  operation = ::Gapic::Rest::TransportOperation.new response
799
810
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
800
-
801
- yield result, operation if block_given?
802
- result
811
+ catch :response do
812
+ yield result, operation if block_given?
813
+ result
814
+ end
803
815
  end
804
816
 
805
817
  ##
@@ -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: true,
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 list_connectivity_tests 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: "list_connectivity_tests",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::NetworkManagement::V1::ListConnectivityTestsResponse.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: "get_connectivity_test",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::NetworkManagement::V1::ConnectivityTest.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: "create_connectivity_test",
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: "update_connectivity_test",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Longrunning::Operation.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: "rerun_connectivity_test",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Longrunning::Operation.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_connectivity_test",
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
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module NetworkManagement
23
23
  module V1
24
- VERSION = "1.3.0"
24
+ VERSION = "1.4.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_management-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.3.0
4
+ version: 1.4.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
@@ -152,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
152
152
  - !ruby/object:Gem::Version
153
153
  version: '0'
154
154
  requirements: []
155
- rubygems_version: 3.5.22
155
+ rubygems_version: 3.5.23
156
156
  signing_key:
157
157
  specification_version: 4
158
158
  summary: The Network Management API provides a collection of network performance monitoring