google-cloud-network_security-v1beta1 0.8.0 → 0.9.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: '0496174d9074492e39a68c2100422c941f907ec9401872314b3dc2cd182f0c04'
4
- data.tar.gz: a6fe28b28a6b9449743e88eb5b6d044404f344adc9ddaa730d03129a3142eb62
3
+ metadata.gz: d16637bff67e4cbd2d359dc9edac103aab5ecab7593ead546b0689590e138098
4
+ data.tar.gz: 464f45cba0a25456b06a7a0dbd61234bf338e97963e8b95e6d4dc3a186894dcf
5
5
  SHA512:
6
- metadata.gz: 8843d7e9b7f1c469c7f987da581e6b6e4b415cce0ff1c50c54581f0ec73f57e72cbcbae71c49700f6f7b55d77dea3b3d884ba537ba517cd12bd405c0d7dacefe
7
- data.tar.gz: 5c3635449eb9d3c855e8d860bf3eb2264fdb35840676a72902d180ffae45e1d825875f1f628b7b9ba019f64a02b067d4e44f82082ac3b44b39cb223c0c2598d2
6
+ metadata.gz: 79c6c36c276830f0771821f5376a137b074640d61aef2843f2274b9e8a4ed0cb54e68356f9f6efa78a1698d08918ad92d3c17f96e7f79da18a87212a6cb3c6f4
7
+ data.tar.gz: b5e97d275c2ab6f82db7eb5820197c764d6bd2af63b43007e0aee24562670f5d615857945dd675c75feafd7d17b1485883138c0d81957188ef7cf04a900466ed
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/traffic-director/docs/reference/network-security/rest/)
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_security/v1beta1"
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::NetworkSecurity::V1beta1::NetworkSecurity::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).
@@ -34,6 +34,9 @@ module Google
34
34
  # information.
35
35
  #
36
36
  class Client
37
+ # @private
38
+ API_VERSION = ""
39
+
37
40
  # @private
38
41
  DEFAULT_ENDPOINT_TEMPLATE = "networksecurity.$UNIVERSE_DOMAIN$"
39
42
 
@@ -167,14 +170,26 @@ module Google
167
170
  universe_domain: @config.universe_domain,
168
171
  channel_args: @config.channel_args,
169
172
  interceptors: @config.interceptors,
170
- channel_pool_config: @config.channel_pool
173
+ channel_pool_config: @config.channel_pool,
174
+ logger: @config.logger
171
175
  )
172
176
 
177
+ @network_security_stub.stub_logger&.info do |entry|
178
+ entry.set_system_name
179
+ entry.set_service
180
+ entry.message = "Created client for #{entry.service}"
181
+ entry.set_credentials_fields credentials
182
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
183
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
184
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
185
+ end
186
+
173
187
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
174
188
  config.credentials = credentials
175
189
  config.quota_project = @quota_project_id
176
190
  config.endpoint = @network_security_stub.endpoint
177
191
  config.universe_domain = @network_security_stub.universe_domain
192
+ config.logger = @network_security_stub.logger if config.respond_to? :logger=
178
193
  end
179
194
 
180
195
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -182,6 +197,7 @@ module Google
182
197
  config.quota_project = @quota_project_id
183
198
  config.endpoint = @network_security_stub.endpoint
184
199
  config.universe_domain = @network_security_stub.universe_domain
200
+ config.logger = @network_security_stub.logger if config.respond_to? :logger=
185
201
  end
186
202
  end
187
203
 
@@ -206,6 +222,15 @@ module Google
206
222
  #
207
223
  attr_reader :iam_policy_client
208
224
 
225
+ ##
226
+ # The logger used for request/response debug logging.
227
+ #
228
+ # @return [Logger]
229
+ #
230
+ def logger
231
+ @network_security_stub.logger
232
+ end
233
+
209
234
  # Service calls
210
235
 
211
236
  ##
@@ -276,10 +301,11 @@ module Google
276
301
  # Customize the options with defaults
277
302
  metadata = @config.rpcs.list_authorization_policies.metadata.to_h
278
303
 
279
- # Set x-goog-api-client and x-goog-user-project headers
304
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
280
305
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
281
306
  lib_name: @config.lib_name, lib_version: @config.lib_version,
282
307
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
308
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
283
309
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
284
310
 
285
311
  header_params = {}
@@ -301,7 +327,7 @@ module Google
301
327
  @network_security_stub.call_rpc :list_authorization_policies, request, options: options do |response, operation|
302
328
  response = ::Gapic::PagedEnumerable.new @network_security_stub, :list_authorization_policies, request, response, operation, options
303
329
  yield response, operation if block_given?
304
- return response
330
+ throw :response, response
305
331
  end
306
332
  rescue ::GRPC::BadStatus => e
307
333
  raise ::Google::Cloud::Error.from_error(e)
@@ -363,10 +389,11 @@ module Google
363
389
  # Customize the options with defaults
364
390
  metadata = @config.rpcs.get_authorization_policy.metadata.to_h
365
391
 
366
- # Set x-goog-api-client and x-goog-user-project headers
392
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
367
393
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
368
394
  lib_name: @config.lib_name, lib_version: @config.lib_version,
369
395
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
396
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
370
397
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
371
398
 
372
399
  header_params = {}
@@ -387,7 +414,6 @@ module Google
387
414
 
388
415
  @network_security_stub.call_rpc :get_authorization_policy, request, options: options do |response, operation|
389
416
  yield response, operation if block_given?
390
- return response
391
417
  end
392
418
  rescue ::GRPC::BadStatus => e
393
419
  raise ::Google::Cloud::Error.from_error(e)
@@ -463,10 +489,11 @@ module Google
463
489
  # Customize the options with defaults
464
490
  metadata = @config.rpcs.create_authorization_policy.metadata.to_h
465
491
 
466
- # Set x-goog-api-client and x-goog-user-project headers
492
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
467
493
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
468
494
  lib_name: @config.lib_name, lib_version: @config.lib_version,
469
495
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
496
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
470
497
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
471
498
 
472
499
  header_params = {}
@@ -488,7 +515,7 @@ module Google
488
515
  @network_security_stub.call_rpc :create_authorization_policy, request, options: options do |response, operation|
489
516
  response = ::Gapic::Operation.new response, @operations_client, options: options
490
517
  yield response, operation if block_given?
491
- return response
518
+ throw :response, response
492
519
  end
493
520
  rescue ::GRPC::BadStatus => e
494
521
  raise ::Google::Cloud::Error.from_error(e)
@@ -562,10 +589,11 @@ module Google
562
589
  # Customize the options with defaults
563
590
  metadata = @config.rpcs.update_authorization_policy.metadata.to_h
564
591
 
565
- # Set x-goog-api-client and x-goog-user-project headers
592
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
566
593
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
567
594
  lib_name: @config.lib_name, lib_version: @config.lib_version,
568
595
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
596
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
569
597
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
570
598
 
571
599
  header_params = {}
@@ -587,7 +615,7 @@ module Google
587
615
  @network_security_stub.call_rpc :update_authorization_policy, request, options: options do |response, operation|
588
616
  response = ::Gapic::Operation.new response, @operations_client, options: options
589
617
  yield response, operation if block_given?
590
- return response
618
+ throw :response, response
591
619
  end
592
620
  rescue ::GRPC::BadStatus => e
593
621
  raise ::Google::Cloud::Error.from_error(e)
@@ -656,10 +684,11 @@ module Google
656
684
  # Customize the options with defaults
657
685
  metadata = @config.rpcs.delete_authorization_policy.metadata.to_h
658
686
 
659
- # Set x-goog-api-client and x-goog-user-project headers
687
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
660
688
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
661
689
  lib_name: @config.lib_name, lib_version: @config.lib_version,
662
690
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
691
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
663
692
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
664
693
 
665
694
  header_params = {}
@@ -681,7 +710,7 @@ module Google
681
710
  @network_security_stub.call_rpc :delete_authorization_policy, request, options: options do |response, operation|
682
711
  response = ::Gapic::Operation.new response, @operations_client, options: options
683
712
  yield response, operation if block_given?
684
- return response
713
+ throw :response, response
685
714
  end
686
715
  rescue ::GRPC::BadStatus => e
687
716
  raise ::Google::Cloud::Error.from_error(e)
@@ -754,10 +783,11 @@ module Google
754
783
  # Customize the options with defaults
755
784
  metadata = @config.rpcs.list_server_tls_policies.metadata.to_h
756
785
 
757
- # Set x-goog-api-client and x-goog-user-project headers
786
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
758
787
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
759
788
  lib_name: @config.lib_name, lib_version: @config.lib_version,
760
789
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
790
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
761
791
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
762
792
 
763
793
  header_params = {}
@@ -779,7 +809,7 @@ module Google
779
809
  @network_security_stub.call_rpc :list_server_tls_policies, request, options: options do |response, operation|
780
810
  response = ::Gapic::PagedEnumerable.new @network_security_stub, :list_server_tls_policies, request, response, operation, options
781
811
  yield response, operation if block_given?
782
- return response
812
+ throw :response, response
783
813
  end
784
814
  rescue ::GRPC::BadStatus => e
785
815
  raise ::Google::Cloud::Error.from_error(e)
@@ -841,10 +871,11 @@ module Google
841
871
  # Customize the options with defaults
842
872
  metadata = @config.rpcs.get_server_tls_policy.metadata.to_h
843
873
 
844
- # Set x-goog-api-client and x-goog-user-project headers
874
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
845
875
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
846
876
  lib_name: @config.lib_name, lib_version: @config.lib_version,
847
877
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
878
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
848
879
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
849
880
 
850
881
  header_params = {}
@@ -865,7 +896,6 @@ module Google
865
896
 
866
897
  @network_security_stub.call_rpc :get_server_tls_policy, request, options: options do |response, operation|
867
898
  yield response, operation if block_given?
868
- return response
869
899
  end
870
900
  rescue ::GRPC::BadStatus => e
871
901
  raise ::Google::Cloud::Error.from_error(e)
@@ -941,10 +971,11 @@ module Google
941
971
  # Customize the options with defaults
942
972
  metadata = @config.rpcs.create_server_tls_policy.metadata.to_h
943
973
 
944
- # Set x-goog-api-client and x-goog-user-project headers
974
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
945
975
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
946
976
  lib_name: @config.lib_name, lib_version: @config.lib_version,
947
977
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
978
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
948
979
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
949
980
 
950
981
  header_params = {}
@@ -966,7 +997,7 @@ module Google
966
997
  @network_security_stub.call_rpc :create_server_tls_policy, request, options: options do |response, operation|
967
998
  response = ::Gapic::Operation.new response, @operations_client, options: options
968
999
  yield response, operation if block_given?
969
- return response
1000
+ throw :response, response
970
1001
  end
971
1002
  rescue ::GRPC::BadStatus => e
972
1003
  raise ::Google::Cloud::Error.from_error(e)
@@ -1041,10 +1072,11 @@ module Google
1041
1072
  # Customize the options with defaults
1042
1073
  metadata = @config.rpcs.update_server_tls_policy.metadata.to_h
1043
1074
 
1044
- # Set x-goog-api-client and x-goog-user-project headers
1075
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1045
1076
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1046
1077
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1047
1078
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1079
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1048
1080
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1049
1081
 
1050
1082
  header_params = {}
@@ -1066,7 +1098,7 @@ module Google
1066
1098
  @network_security_stub.call_rpc :update_server_tls_policy, request, options: options do |response, operation|
1067
1099
  response = ::Gapic::Operation.new response, @operations_client, options: options
1068
1100
  yield response, operation if block_given?
1069
- return response
1101
+ throw :response, response
1070
1102
  end
1071
1103
  rescue ::GRPC::BadStatus => e
1072
1104
  raise ::Google::Cloud::Error.from_error(e)
@@ -1135,10 +1167,11 @@ module Google
1135
1167
  # Customize the options with defaults
1136
1168
  metadata = @config.rpcs.delete_server_tls_policy.metadata.to_h
1137
1169
 
1138
- # Set x-goog-api-client and x-goog-user-project headers
1170
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1139
1171
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1140
1172
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1141
1173
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1174
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1142
1175
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1143
1176
 
1144
1177
  header_params = {}
@@ -1160,7 +1193,7 @@ module Google
1160
1193
  @network_security_stub.call_rpc :delete_server_tls_policy, request, options: options do |response, operation|
1161
1194
  response = ::Gapic::Operation.new response, @operations_client, options: options
1162
1195
  yield response, operation if block_given?
1163
- return response
1196
+ throw :response, response
1164
1197
  end
1165
1198
  rescue ::GRPC::BadStatus => e
1166
1199
  raise ::Google::Cloud::Error.from_error(e)
@@ -1233,10 +1266,11 @@ module Google
1233
1266
  # Customize the options with defaults
1234
1267
  metadata = @config.rpcs.list_client_tls_policies.metadata.to_h
1235
1268
 
1236
- # Set x-goog-api-client and x-goog-user-project headers
1269
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1237
1270
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1238
1271
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1239
1272
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1273
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1240
1274
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1241
1275
 
1242
1276
  header_params = {}
@@ -1258,7 +1292,7 @@ module Google
1258
1292
  @network_security_stub.call_rpc :list_client_tls_policies, request, options: options do |response, operation|
1259
1293
  response = ::Gapic::PagedEnumerable.new @network_security_stub, :list_client_tls_policies, request, response, operation, options
1260
1294
  yield response, operation if block_given?
1261
- return response
1295
+ throw :response, response
1262
1296
  end
1263
1297
  rescue ::GRPC::BadStatus => e
1264
1298
  raise ::Google::Cloud::Error.from_error(e)
@@ -1320,10 +1354,11 @@ module Google
1320
1354
  # Customize the options with defaults
1321
1355
  metadata = @config.rpcs.get_client_tls_policy.metadata.to_h
1322
1356
 
1323
- # Set x-goog-api-client and x-goog-user-project headers
1357
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1324
1358
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1325
1359
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1326
1360
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1361
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1327
1362
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1328
1363
 
1329
1364
  header_params = {}
@@ -1344,7 +1379,6 @@ module Google
1344
1379
 
1345
1380
  @network_security_stub.call_rpc :get_client_tls_policy, request, options: options do |response, operation|
1346
1381
  yield response, operation if block_given?
1347
- return response
1348
1382
  end
1349
1383
  rescue ::GRPC::BadStatus => e
1350
1384
  raise ::Google::Cloud::Error.from_error(e)
@@ -1420,10 +1454,11 @@ module Google
1420
1454
  # Customize the options with defaults
1421
1455
  metadata = @config.rpcs.create_client_tls_policy.metadata.to_h
1422
1456
 
1423
- # Set x-goog-api-client and x-goog-user-project headers
1457
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1424
1458
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1425
1459
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1426
1460
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1461
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1427
1462
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1428
1463
 
1429
1464
  header_params = {}
@@ -1445,7 +1480,7 @@ module Google
1445
1480
  @network_security_stub.call_rpc :create_client_tls_policy, request, options: options do |response, operation|
1446
1481
  response = ::Gapic::Operation.new response, @operations_client, options: options
1447
1482
  yield response, operation if block_given?
1448
- return response
1483
+ throw :response, response
1449
1484
  end
1450
1485
  rescue ::GRPC::BadStatus => e
1451
1486
  raise ::Google::Cloud::Error.from_error(e)
@@ -1520,10 +1555,11 @@ module Google
1520
1555
  # Customize the options with defaults
1521
1556
  metadata = @config.rpcs.update_client_tls_policy.metadata.to_h
1522
1557
 
1523
- # Set x-goog-api-client and x-goog-user-project headers
1558
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1524
1559
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1525
1560
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1526
1561
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1562
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1527
1563
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1528
1564
 
1529
1565
  header_params = {}
@@ -1545,7 +1581,7 @@ module Google
1545
1581
  @network_security_stub.call_rpc :update_client_tls_policy, request, options: options do |response, operation|
1546
1582
  response = ::Gapic::Operation.new response, @operations_client, options: options
1547
1583
  yield response, operation if block_given?
1548
- return response
1584
+ throw :response, response
1549
1585
  end
1550
1586
  rescue ::GRPC::BadStatus => e
1551
1587
  raise ::Google::Cloud::Error.from_error(e)
@@ -1614,10 +1650,11 @@ module Google
1614
1650
  # Customize the options with defaults
1615
1651
  metadata = @config.rpcs.delete_client_tls_policy.metadata.to_h
1616
1652
 
1617
- # Set x-goog-api-client and x-goog-user-project headers
1653
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1618
1654
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1619
1655
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1620
1656
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
1657
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1621
1658
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1622
1659
 
1623
1660
  header_params = {}
@@ -1639,7 +1676,7 @@ module Google
1639
1676
  @network_security_stub.call_rpc :delete_client_tls_policy, request, options: options do |response, operation|
1640
1677
  response = ::Gapic::Operation.new response, @operations_client, options: options
1641
1678
  yield response, operation if block_given?
1642
- return response
1679
+ throw :response, response
1643
1680
  end
1644
1681
  rescue ::GRPC::BadStatus => e
1645
1682
  raise ::Google::Cloud::Error.from_error(e)
@@ -1728,6 +1765,11 @@ module Google
1728
1765
  # default endpoint URL. The default value of nil uses the environment
1729
1766
  # universe (usually the default "googleapis.com" universe).
1730
1767
  # @return [::String,nil]
1768
+ # @!attribute [rw] logger
1769
+ # A custom logger to use for request/response debug logging, or the value
1770
+ # `:default` (the default) to construct a default logger, or `nil` to
1771
+ # explicitly disable logging.
1772
+ # @return [::Logger,:default,nil]
1731
1773
  #
1732
1774
  class Configuration
1733
1775
  extend ::Gapic::Config
@@ -1752,6 +1794,7 @@ module Google
1752
1794
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1753
1795
  config_attr :quota_project, nil, ::String, nil
1754
1796
  config_attr :universe_domain, nil, ::String, nil
1797
+ config_attr :logger, :default, ::Logger, nil, :default
1755
1798
 
1756
1799
  # @private
1757
1800
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module NetworkSecurity
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ API_VERSION = ""
31
+
29
32
  # @private
30
33
  DEFAULT_ENDPOINT_TEMPLATE = "networksecurity.$UNIVERSE_DOMAIN$"
31
34
 
@@ -121,14 +124,6 @@ module Google
121
124
  # Lists operations that match the specified filter in the request. If the
122
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
123
126
  #
124
- # NOTE: the `name` binding allows API services to override the binding
125
- # to use different resource name schemes, such as `users/*/operations`. To
126
- # override the binding, API services can add a binding such as
127
- # `"/v1/{name=users/*}/operations"` to their service configuration.
128
- # For backwards compatibility, the default name includes the operations
129
- # collection id, however overriding users must ensure the name binding
130
- # is the parent resource, without the operations collection id.
131
- #
132
127
  # @overload list_operations(request, options = nil)
133
128
  # Pass arguments to `list_operations` via a request object, either of type
134
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -191,10 +186,11 @@ module Google
191
186
  # Customize the options with defaults
192
187
  metadata = @config.rpcs.list_operations.metadata.to_h
193
188
 
194
- # Set x-goog-api-client and x-goog-user-project headers
189
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
195
190
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
196
191
  lib_name: @config.lib_name, lib_version: @config.lib_version,
197
192
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
193
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
198
194
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
199
195
 
200
196
  header_params = {}
@@ -217,7 +213,7 @@ module Google
217
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
218
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
219
215
  yield response, operation if block_given?
220
- return response
216
+ throw :response, response
221
217
  end
222
218
  rescue ::GRPC::BadStatus => e
223
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -287,10 +283,11 @@ module Google
287
283
  # Customize the options with defaults
288
284
  metadata = @config.rpcs.get_operation.metadata.to_h
289
285
 
290
- # Set x-goog-api-client and x-goog-user-project headers
286
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
291
287
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
292
288
  lib_name: @config.lib_name, lib_version: @config.lib_version,
293
289
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
290
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
294
291
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
295
292
 
296
293
  header_params = {}
@@ -312,7 +309,7 @@ module Google
312
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
313
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
314
311
  yield response, operation if block_given?
315
- return response
312
+ throw :response, response
316
313
  end
317
314
  rescue ::GRPC::BadStatus => e
318
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -376,10 +373,11 @@ module Google
376
373
  # Customize the options with defaults
377
374
  metadata = @config.rpcs.delete_operation.metadata.to_h
378
375
 
379
- # Set x-goog-api-client and x-goog-user-project headers
376
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
380
377
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
381
378
  lib_name: @config.lib_name, lib_version: @config.lib_version,
382
379
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
380
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
383
381
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
384
382
 
385
383
  header_params = {}
@@ -400,7 +398,6 @@ module Google
400
398
 
401
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
402
400
  yield response, operation if block_given?
403
- return response
404
401
  end
405
402
  rescue ::GRPC::BadStatus => e
406
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -415,8 +412,9 @@ module Google
415
412
  # other methods to check whether the cancellation succeeded or whether the
416
413
  # operation completed despite cancellation. On successful cancellation,
417
414
  # the operation is not deleted; instead, it becomes an operation with
418
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
419
- # corresponding to `Code.CANCELLED`.
415
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
416
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
417
+ # `Code.CANCELLED`.
420
418
  #
421
419
  # @overload cancel_operation(request, options = nil)
422
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -470,10 +468,11 @@ module Google
470
468
  # Customize the options with defaults
471
469
  metadata = @config.rpcs.cancel_operation.metadata.to_h
472
470
 
473
- # Set x-goog-api-client and x-goog-user-project headers
471
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
474
472
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
475
473
  lib_name: @config.lib_name, lib_version: @config.lib_version,
476
474
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
475
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
477
476
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
478
477
 
479
478
  header_params = {}
@@ -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)
@@ -574,10 +572,11 @@ module Google
574
572
  # Customize the options with defaults
575
573
  metadata = @config.rpcs.wait_operation.metadata.to_h
576
574
 
577
- # Set x-goog-api-client and x-goog-user-project headers
575
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
578
576
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
579
577
  lib_name: @config.lib_name, lib_version: @config.lib_version,
580
578
  gapic_version: ::Google::Cloud::NetworkSecurity::V1beta1::VERSION
579
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
581
580
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
582
581
 
583
582
  options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
@@ -591,7 +590,7 @@ module Google
591
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
592
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
593
592
  yield response, operation if block_given?
594
- return response
593
+ throw :response, response
595
594
  end
596
595
  rescue ::GRPC::BadStatus => e
597
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -680,6 +679,11 @@ module Google
680
679
  # default endpoint URL. The default value of nil uses the environment
681
680
  # universe (usually the default "googleapis.com" universe).
682
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]
683
687
  #
684
688
  class Configuration
685
689
  extend ::Gapic::Config
@@ -704,6 +708,7 @@ module Google
704
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
705
709
  config_attr :quota_project, nil, ::String, nil
706
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
707
712
 
708
713
  # @private
709
714
  def initialize parent_config = nil