google-cloud-network_management-v1 1.3.0 → 1.4.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: 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