google-cloud-security_center-v1 1.2.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: 055d414ad671f290e4358df978ab7642242beb7261499fa1ce16e057668bd12a
4
- data.tar.gz: 7c884df91a6817edd4a81465c928fc73500aac3a9643ce4d388f9774b07dd58e
3
+ metadata.gz: 181eac266a67753a75dc00ee79e1c4e19ed6c1ef8ecf2098bd8e91ba40966081
4
+ data.tar.gz: f74b098db518a55ca23890aa21c7ebd85255c20623feb1c0c5debdcce7fae794
5
5
  SHA512:
6
- metadata.gz: 872260165f6fb0c7a8ba60e3950f400a8a693f98e7586f11d2cc960548d1ddb79bbc280d1a4ac71aa675e9ff52fa6066373fec5e077bae6c72a38eb8c3821d0e
7
- data.tar.gz: 4b95eeb39e191b2d06352a97ab231b80926fad147b9192a5793b05676193605a3e2bd1e2b098ce609d2f440cb1a46ed2ebcd8338a09c3d2b30f7630abfa7282e
6
+ metadata.gz: '0861d90ab02b7892d5d7badd9d003b4c2e86ce43cf6c3e3f4f08ed27b57c716567e752de993354e0644e378aff82dcba041bdfe7961e6bd12fc29772aabd2f4d'
7
+ data.tar.gz: 06a3b3b8789eb7ceac78aa4db0e74a1c93923701ca1fb385071cae97f5c02f70252e103bd9f2ada381b8e74e43174402d8bda53851b7f070a2c6ae802207bf67
data/README.md CHANGED
@@ -42,40 +42,50 @@ for class and method documentation.
42
42
  See also the [Product Documentation](https://cloud.google.com/security-command-center)
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/security_center/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::SecurityCenter::V1::SecurityCenter::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).
75
85
 
76
86
  ## Supported Ruby Versions
77
87
 
78
- This library is supported on Ruby 2.7+.
88
+ This library is supported on Ruby 3.0+.
79
89
 
80
90
  Google provides official support for Ruby versions that are actively supported
81
91
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -274,8 +274,19 @@ module Google
274
274
  universe_domain: @config.universe_domain,
275
275
  channel_args: @config.channel_args,
276
276
  interceptors: @config.interceptors,
277
- channel_pool_config: @config.channel_pool
277
+ channel_pool_config: @config.channel_pool,
278
+ logger: @config.logger
278
279
  )
280
+
281
+ @security_center_stub.stub_logger&.info do |entry|
282
+ entry.set_system_name
283
+ entry.set_service
284
+ entry.message = "Created client for #{entry.service}"
285
+ entry.set_credentials_fields credentials
286
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
287
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
288
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
289
+ end
279
290
  end
280
291
 
281
292
  ##
@@ -285,6 +296,15 @@ module Google
285
296
  #
286
297
  attr_reader :operations_client
287
298
 
299
+ ##
300
+ # The logger used for request/response debug logging.
301
+ #
302
+ # @return [Logger]
303
+ #
304
+ def logger
305
+ @security_center_stub.logger
306
+ end
307
+
288
308
  # Service calls
289
309
 
290
310
  ##
@@ -407,7 +427,7 @@ module Google
407
427
  @security_center_stub.call_rpc :bulk_mute_findings, request, options: options do |response, operation|
408
428
  response = ::Gapic::Operation.new response, @operations_client, options: options
409
429
  yield response, operation if block_given?
410
- return response
430
+ throw :response, response
411
431
  end
412
432
  rescue ::GRPC::BadStatus => e
413
433
  raise ::Google::Cloud::Error.from_error(e)
@@ -503,7 +523,6 @@ module Google
503
523
 
504
524
  @security_center_stub.call_rpc :create_security_health_analytics_custom_module, request, options: options do |response, operation|
505
525
  yield response, operation if block_given?
506
- return response
507
526
  end
508
527
  rescue ::GRPC::BadStatus => e
509
528
  raise ::Google::Cloud::Error.from_error(e)
@@ -593,7 +612,6 @@ module Google
593
612
 
594
613
  @security_center_stub.call_rpc :create_source, request, options: options do |response, operation|
595
614
  yield response, operation if block_given?
596
- return response
597
615
  end
598
616
  rescue ::GRPC::BadStatus => e
599
617
  raise ::Google::Cloud::Error.from_error(e)
@@ -688,7 +706,6 @@ module Google
688
706
 
689
707
  @security_center_stub.call_rpc :create_finding, request, options: options do |response, operation|
690
708
  yield response, operation if block_given?
691
- return response
692
709
  end
693
710
  rescue ::GRPC::BadStatus => e
694
711
  raise ::Google::Cloud::Error.from_error(e)
@@ -783,7 +800,6 @@ module Google
783
800
 
784
801
  @security_center_stub.call_rpc :create_mute_config, request, options: options do |response, operation|
785
802
  yield response, operation if block_given?
786
- return response
787
803
  end
788
804
  rescue ::GRPC::BadStatus => e
789
805
  raise ::Google::Cloud::Error.from_error(e)
@@ -880,7 +896,6 @@ module Google
880
896
 
881
897
  @security_center_stub.call_rpc :create_notification_config, request, options: options do |response, operation|
882
898
  yield response, operation if block_given?
883
- return response
884
899
  end
885
900
  rescue ::GRPC::BadStatus => e
886
901
  raise ::Google::Cloud::Error.from_error(e)
@@ -972,7 +987,6 @@ module Google
972
987
 
973
988
  @security_center_stub.call_rpc :delete_mute_config, request, options: options do |response, operation|
974
989
  yield response, operation if block_given?
975
- return response
976
990
  end
977
991
  rescue ::GRPC::BadStatus => e
978
992
  raise ::Google::Cloud::Error.from_error(e)
@@ -1061,7 +1075,6 @@ module Google
1061
1075
 
1062
1076
  @security_center_stub.call_rpc :delete_notification_config, request, options: options do |response, operation|
1063
1077
  yield response, operation if block_given?
1064
- return response
1065
1078
  end
1066
1079
  rescue ::GRPC::BadStatus => e
1067
1080
  raise ::Google::Cloud::Error.from_error(e)
@@ -1153,7 +1166,6 @@ module Google
1153
1166
 
1154
1167
  @security_center_stub.call_rpc :delete_security_health_analytics_custom_module, request, options: options do |response, operation|
1155
1168
  yield response, operation if block_given?
1156
- return response
1157
1169
  end
1158
1170
  rescue ::GRPC::BadStatus => e
1159
1171
  raise ::Google::Cloud::Error.from_error(e)
@@ -1244,7 +1256,6 @@ module Google
1244
1256
 
1245
1257
  @security_center_stub.call_rpc :get_simulation, request, options: options do |response, operation|
1246
1258
  yield response, operation if block_given?
1247
- return response
1248
1259
  end
1249
1260
  rescue ::GRPC::BadStatus => e
1250
1261
  raise ::Google::Cloud::Error.from_error(e)
@@ -1333,7 +1344,6 @@ module Google
1333
1344
 
1334
1345
  @security_center_stub.call_rpc :get_valued_resource, request, options: options do |response, operation|
1335
1346
  yield response, operation if block_given?
1336
- return response
1337
1347
  end
1338
1348
  rescue ::GRPC::BadStatus => e
1339
1349
  raise ::Google::Cloud::Error.from_error(e)
@@ -1422,7 +1432,6 @@ module Google
1422
1432
 
1423
1433
  @security_center_stub.call_rpc :get_big_query_export, request, options: options do |response, operation|
1424
1434
  yield response, operation if block_given?
1425
- return response
1426
1435
  end
1427
1436
  rescue ::GRPC::BadStatus => e
1428
1437
  raise ::Google::Cloud::Error.from_error(e)
@@ -1512,7 +1521,6 @@ module Google
1512
1521
 
1513
1522
  @security_center_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
1514
1523
  yield response, operation if block_given?
1515
- return response
1516
1524
  end
1517
1525
  rescue ::GRPC::BadStatus => e
1518
1526
  raise ::Google::Cloud::Error.from_error(e)
@@ -1604,7 +1612,6 @@ module Google
1604
1612
 
1605
1613
  @security_center_stub.call_rpc :get_mute_config, request, options: options do |response, operation|
1606
1614
  yield response, operation if block_given?
1607
- return response
1608
1615
  end
1609
1616
  rescue ::GRPC::BadStatus => e
1610
1617
  raise ::Google::Cloud::Error.from_error(e)
@@ -1693,7 +1700,6 @@ module Google
1693
1700
 
1694
1701
  @security_center_stub.call_rpc :get_notification_config, request, options: options do |response, operation|
1695
1702
  yield response, operation if block_given?
1696
- return response
1697
1703
  end
1698
1704
  rescue ::GRPC::BadStatus => e
1699
1705
  raise ::Google::Cloud::Error.from_error(e)
@@ -1780,7 +1786,6 @@ module Google
1780
1786
 
1781
1787
  @security_center_stub.call_rpc :get_organization_settings, request, options: options do |response, operation|
1782
1788
  yield response, operation if block_given?
1783
- return response
1784
1789
  end
1785
1790
  rescue ::GRPC::BadStatus => e
1786
1791
  raise ::Google::Cloud::Error.from_error(e)
@@ -1870,7 +1875,6 @@ module Google
1870
1875
 
1871
1876
  @security_center_stub.call_rpc :get_effective_security_health_analytics_custom_module, request, options: options do |response, operation|
1872
1877
  yield response, operation if block_given?
1873
- return response
1874
1878
  end
1875
1879
  rescue ::GRPC::BadStatus => e
1876
1880
  raise ::Google::Cloud::Error.from_error(e)
@@ -1960,7 +1964,6 @@ module Google
1960
1964
 
1961
1965
  @security_center_stub.call_rpc :get_security_health_analytics_custom_module, request, options: options do |response, operation|
1962
1966
  yield response, operation if block_given?
1963
- return response
1964
1967
  end
1965
1968
  rescue ::GRPC::BadStatus => e
1966
1969
  raise ::Google::Cloud::Error.from_error(e)
@@ -2047,7 +2050,6 @@ module Google
2047
2050
 
2048
2051
  @security_center_stub.call_rpc :get_source, request, options: options do |response, operation|
2049
2052
  yield response, operation if block_given?
2050
- return response
2051
2053
  end
2052
2054
  rescue ::GRPC::BadStatus => e
2053
2055
  raise ::Google::Cloud::Error.from_error(e)
@@ -2265,7 +2267,7 @@ module Google
2265
2267
  @security_center_stub.call_rpc :group_assets, request, options: options do |response, operation|
2266
2268
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :group_assets, request, response, operation, options
2267
2269
  yield response, operation if block_given?
2268
- return response
2270
+ throw :response, response
2269
2271
  end
2270
2272
  rescue ::GRPC::BadStatus => e
2271
2273
  raise ::Google::Cloud::Error.from_error(e)
@@ -2481,7 +2483,7 @@ module Google
2481
2483
  @security_center_stub.call_rpc :group_findings, request, options: options do |response, operation|
2482
2484
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :group_findings, request, response, operation, options
2483
2485
  yield response, operation if block_given?
2484
- return response
2486
+ throw :response, response
2485
2487
  end
2486
2488
  rescue ::GRPC::BadStatus => e
2487
2489
  raise ::Google::Cloud::Error.from_error(e)
@@ -2704,7 +2706,7 @@ module Google
2704
2706
  @security_center_stub.call_rpc :list_assets, request, options: options do |response, operation|
2705
2707
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_assets, request, response, operation, options
2706
2708
  yield response, operation if block_given?
2707
- return response
2709
+ throw :response, response
2708
2710
  end
2709
2711
  rescue ::GRPC::BadStatus => e
2710
2712
  raise ::Google::Cloud::Error.from_error(e)
@@ -2804,7 +2806,7 @@ module Google
2804
2806
  @security_center_stub.call_rpc :list_descendant_security_health_analytics_custom_modules, request, options: options do |response, operation|
2805
2807
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_descendant_security_health_analytics_custom_modules, request, response, operation, options
2806
2808
  yield response, operation if block_given?
2807
- return response
2809
+ throw :response, response
2808
2810
  end
2809
2811
  rescue ::GRPC::BadStatus => e
2810
2812
  raise ::Google::Cloud::Error.from_error(e)
@@ -3031,7 +3033,7 @@ module Google
3031
3033
  @security_center_stub.call_rpc :list_findings, request, options: options do |response, operation|
3032
3034
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_findings, request, response, operation, options
3033
3035
  yield response, operation if block_given?
3034
- return response
3036
+ throw :response, response
3035
3037
  end
3036
3038
  rescue ::GRPC::BadStatus => e
3037
3039
  raise ::Google::Cloud::Error.from_error(e)
@@ -3135,7 +3137,7 @@ module Google
3135
3137
  @security_center_stub.call_rpc :list_mute_configs, request, options: options do |response, operation|
3136
3138
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_mute_configs, request, response, operation, options
3137
3139
  yield response, operation if block_given?
3138
- return response
3140
+ throw :response, response
3139
3141
  end
3140
3142
  rescue ::GRPC::BadStatus => e
3141
3143
  raise ::Google::Cloud::Error.from_error(e)
@@ -3235,7 +3237,7 @@ module Google
3235
3237
  @security_center_stub.call_rpc :list_notification_configs, request, options: options do |response, operation|
3236
3238
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_notification_configs, request, response, operation, options
3237
3239
  yield response, operation if block_given?
3238
- return response
3240
+ throw :response, response
3239
3241
  end
3240
3242
  rescue ::GRPC::BadStatus => e
3241
3243
  raise ::Google::Cloud::Error.from_error(e)
@@ -3336,7 +3338,7 @@ module Google
3336
3338
  @security_center_stub.call_rpc :list_effective_security_health_analytics_custom_modules, request, options: options do |response, operation|
3337
3339
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_effective_security_health_analytics_custom_modules, request, response, operation, options
3338
3340
  yield response, operation if block_given?
3339
- return response
3341
+ throw :response, response
3340
3342
  end
3341
3343
  rescue ::GRPC::BadStatus => e
3342
3344
  raise ::Google::Cloud::Error.from_error(e)
@@ -3437,7 +3439,7 @@ module Google
3437
3439
  @security_center_stub.call_rpc :list_security_health_analytics_custom_modules, request, options: options do |response, operation|
3438
3440
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_security_health_analytics_custom_modules, request, response, operation, options
3439
3441
  yield response, operation if block_given?
3440
- return response
3442
+ throw :response, response
3441
3443
  end
3442
3444
  rescue ::GRPC::BadStatus => e
3443
3445
  raise ::Google::Cloud::Error.from_error(e)
@@ -3537,7 +3539,7 @@ module Google
3537
3539
  @security_center_stub.call_rpc :list_sources, request, options: options do |response, operation|
3538
3540
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_sources, request, response, operation, options
3539
3541
  yield response, operation if block_given?
3540
- return response
3542
+ throw :response, response
3541
3543
  end
3542
3544
  rescue ::GRPC::BadStatus => e
3543
3545
  raise ::Google::Cloud::Error.from_error(e)
@@ -3639,7 +3641,7 @@ module Google
3639
3641
  @security_center_stub.call_rpc :run_asset_discovery, request, options: options do |response, operation|
3640
3642
  response = ::Gapic::Operation.new response, @operations_client, options: options
3641
3643
  yield response, operation if block_given?
3642
- return response
3644
+ throw :response, response
3643
3645
  end
3644
3646
  rescue ::GRPC::BadStatus => e
3645
3647
  raise ::Google::Cloud::Error.from_error(e)
@@ -3734,7 +3736,6 @@ module Google
3734
3736
 
3735
3737
  @security_center_stub.call_rpc :set_finding_state, request, options: options do |response, operation|
3736
3738
  yield response, operation if block_given?
3737
- return response
3738
3739
  end
3739
3740
  rescue ::GRPC::BadStatus => e
3740
3741
  raise ::Google::Cloud::Error.from_error(e)
@@ -3827,7 +3828,6 @@ module Google
3827
3828
 
3828
3829
  @security_center_stub.call_rpc :set_mute, request, options: options do |response, operation|
3829
3830
  yield response, operation if block_given?
3830
- return response
3831
3831
  end
3832
3832
  rescue ::GRPC::BadStatus => e
3833
3833
  raise ::Google::Cloud::Error.from_error(e)
@@ -3925,7 +3925,6 @@ module Google
3925
3925
 
3926
3926
  @security_center_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
3927
3927
  yield response, operation if block_given?
3928
- return response
3929
3928
  end
3930
3929
  rescue ::GRPC::BadStatus => e
3931
3930
  raise ::Google::Cloud::Error.from_error(e)
@@ -4017,7 +4016,6 @@ module Google
4017
4016
 
4018
4017
  @security_center_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
4019
4018
  yield response, operation if block_given?
4020
- return response
4021
4019
  end
4022
4020
  rescue ::GRPC::BadStatus => e
4023
4021
  raise ::Google::Cloud::Error.from_error(e)
@@ -4111,7 +4109,6 @@ module Google
4111
4109
 
4112
4110
  @security_center_stub.call_rpc :simulate_security_health_analytics_custom_module, request, options: options do |response, operation|
4113
4111
  yield response, operation if block_given?
4114
- return response
4115
4112
  end
4116
4113
  rescue ::GRPC::BadStatus => e
4117
4114
  raise ::Google::Cloud::Error.from_error(e)
@@ -4201,7 +4198,6 @@ module Google
4201
4198
 
4202
4199
  @security_center_stub.call_rpc :update_external_system, request, options: options do |response, operation|
4203
4200
  yield response, operation if block_given?
4204
- return response
4205
4201
  end
4206
4202
  rescue ::GRPC::BadStatus => e
4207
4203
  raise ::Google::Cloud::Error.from_error(e)
@@ -4301,7 +4297,6 @@ module Google
4301
4297
 
4302
4298
  @security_center_stub.call_rpc :update_finding, request, options: options do |response, operation|
4303
4299
  yield response, operation if block_given?
4304
- return response
4305
4300
  end
4306
4301
  rescue ::GRPC::BadStatus => e
4307
4302
  raise ::Google::Cloud::Error.from_error(e)
@@ -4390,7 +4385,6 @@ module Google
4390
4385
 
4391
4386
  @security_center_stub.call_rpc :update_mute_config, request, options: options do |response, operation|
4392
4387
  yield response, operation if block_given?
4393
- return response
4394
4388
  end
4395
4389
  rescue ::GRPC::BadStatus => e
4396
4390
  raise ::Google::Cloud::Error.from_error(e)
@@ -4481,7 +4475,6 @@ module Google
4481
4475
 
4482
4476
  @security_center_stub.call_rpc :update_notification_config, request, options: options do |response, operation|
4483
4477
  yield response, operation if block_given?
4484
- return response
4485
4478
  end
4486
4479
  rescue ::GRPC::BadStatus => e
4487
4480
  raise ::Google::Cloud::Error.from_error(e)
@@ -4571,7 +4564,6 @@ module Google
4571
4564
 
4572
4565
  @security_center_stub.call_rpc :update_organization_settings, request, options: options do |response, operation|
4573
4566
  yield response, operation if block_given?
4574
- return response
4575
4567
  end
4576
4568
  rescue ::GRPC::BadStatus => e
4577
4569
  raise ::Google::Cloud::Error.from_error(e)
@@ -4665,7 +4657,6 @@ module Google
4665
4657
 
4666
4658
  @security_center_stub.call_rpc :update_security_health_analytics_custom_module, request, options: options do |response, operation|
4667
4659
  yield response, operation if block_given?
4668
- return response
4669
4660
  end
4670
4661
  rescue ::GRPC::BadStatus => e
4671
4662
  raise ::Google::Cloud::Error.from_error(e)
@@ -4755,7 +4746,6 @@ module Google
4755
4746
 
4756
4747
  @security_center_stub.call_rpc :update_source, request, options: options do |response, operation|
4757
4748
  yield response, operation if block_given?
4758
- return response
4759
4749
  end
4760
4750
  rescue ::GRPC::BadStatus => e
4761
4751
  raise ::Google::Cloud::Error.from_error(e)
@@ -4852,7 +4842,6 @@ module Google
4852
4842
 
4853
4843
  @security_center_stub.call_rpc :update_security_marks, request, options: options do |response, operation|
4854
4844
  yield response, operation if block_given?
4855
- return response
4856
4845
  end
4857
4846
  rescue ::GRPC::BadStatus => e
4858
4847
  raise ::Google::Cloud::Error.from_error(e)
@@ -4947,7 +4936,6 @@ module Google
4947
4936
 
4948
4937
  @security_center_stub.call_rpc :create_big_query_export, request, options: options do |response, operation|
4949
4938
  yield response, operation if block_given?
4950
- return response
4951
4939
  end
4952
4940
  rescue ::GRPC::BadStatus => e
4953
4941
  raise ::Google::Cloud::Error.from_error(e)
@@ -5036,7 +5024,6 @@ module Google
5036
5024
 
5037
5025
  @security_center_stub.call_rpc :delete_big_query_export, request, options: options do |response, operation|
5038
5026
  yield response, operation if block_given?
5039
- return response
5040
5027
  end
5041
5028
  rescue ::GRPC::BadStatus => e
5042
5029
  raise ::Google::Cloud::Error.from_error(e)
@@ -5125,7 +5112,6 @@ module Google
5125
5112
 
5126
5113
  @security_center_stub.call_rpc :update_big_query_export, request, options: options do |response, operation|
5127
5114
  yield response, operation if block_given?
5128
- return response
5129
5115
  end
5130
5116
  rescue ::GRPC::BadStatus => e
5131
5117
  raise ::Google::Cloud::Error.from_error(e)
@@ -5232,7 +5218,7 @@ module Google
5232
5218
  @security_center_stub.call_rpc :list_big_query_exports, request, options: options do |response, operation|
5233
5219
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_big_query_exports, request, response, operation, options
5234
5220
  yield response, operation if block_given?
5235
- return response
5221
+ throw :response, response
5236
5222
  end
5237
5223
  rescue ::GRPC::BadStatus => e
5238
5224
  raise ::Google::Cloud::Error.from_error(e)
@@ -5331,7 +5317,6 @@ module Google
5331
5317
 
5332
5318
  @security_center_stub.call_rpc :create_event_threat_detection_custom_module, request, options: options do |response, operation|
5333
5319
  yield response, operation if block_given?
5334
- return response
5335
5320
  end
5336
5321
  rescue ::GRPC::BadStatus => e
5337
5322
  raise ::Google::Cloud::Error.from_error(e)
@@ -5425,7 +5410,6 @@ module Google
5425
5410
 
5426
5411
  @security_center_stub.call_rpc :delete_event_threat_detection_custom_module, request, options: options do |response, operation|
5427
5412
  yield response, operation if block_given?
5428
- return response
5429
5413
  end
5430
5414
  rescue ::GRPC::BadStatus => e
5431
5415
  raise ::Google::Cloud::Error.from_error(e)
@@ -5517,7 +5501,6 @@ module Google
5517
5501
 
5518
5502
  @security_center_stub.call_rpc :get_event_threat_detection_custom_module, request, options: options do |response, operation|
5519
5503
  yield response, operation if block_given?
5520
- return response
5521
5504
  end
5522
5505
  rescue ::GRPC::BadStatus => e
5523
5506
  raise ::Google::Cloud::Error.from_error(e)
@@ -5628,7 +5611,7 @@ module Google
5628
5611
  @security_center_stub.call_rpc :list_descendant_event_threat_detection_custom_modules, request, options: options do |response, operation|
5629
5612
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_descendant_event_threat_detection_custom_modules, request, response, operation, options
5630
5613
  yield response, operation if block_given?
5631
- return response
5614
+ throw :response, response
5632
5615
  end
5633
5616
  rescue ::GRPC::BadStatus => e
5634
5617
  raise ::Google::Cloud::Error.from_error(e)
@@ -5740,7 +5723,7 @@ module Google
5740
5723
  @security_center_stub.call_rpc :list_event_threat_detection_custom_modules, request, options: options do |response, operation|
5741
5724
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_event_threat_detection_custom_modules, request, response, operation, options
5742
5725
  yield response, operation if block_given?
5743
- return response
5726
+ throw :response, response
5744
5727
  end
5745
5728
  rescue ::GRPC::BadStatus => e
5746
5729
  raise ::Google::Cloud::Error.from_error(e)
@@ -5834,7 +5817,6 @@ module Google
5834
5817
 
5835
5818
  @security_center_stub.call_rpc :update_event_threat_detection_custom_module, request, options: options do |response, operation|
5836
5819
  yield response, operation if block_given?
5837
- return response
5838
5820
  end
5839
5821
  rescue ::GRPC::BadStatus => e
5840
5822
  raise ::Google::Cloud::Error.from_error(e)
@@ -5931,7 +5913,6 @@ module Google
5931
5913
 
5932
5914
  @security_center_stub.call_rpc :validate_event_threat_detection_custom_module, request, options: options do |response, operation|
5933
5915
  yield response, operation if block_given?
5934
- return response
5935
5916
  end
5936
5917
  rescue ::GRPC::BadStatus => e
5937
5918
  raise ::Google::Cloud::Error.from_error(e)
@@ -6024,7 +6005,6 @@ module Google
6024
6005
 
6025
6006
  @security_center_stub.call_rpc :get_effective_event_threat_detection_custom_module, request, options: options do |response, operation|
6026
6007
  yield response, operation if block_given?
6027
- return response
6028
6008
  end
6029
6009
  rescue ::GRPC::BadStatus => e
6030
6010
  raise ::Google::Cloud::Error.from_error(e)
@@ -6136,7 +6116,7 @@ module Google
6136
6116
  @security_center_stub.call_rpc :list_effective_event_threat_detection_custom_modules, request, options: options do |response, operation|
6137
6117
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_effective_event_threat_detection_custom_modules, request, response, operation, options
6138
6118
  yield response, operation if block_given?
6139
- return response
6119
+ throw :response, response
6140
6120
  end
6141
6121
  rescue ::GRPC::BadStatus => e
6142
6122
  raise ::Google::Cloud::Error.from_error(e)
@@ -6227,7 +6207,6 @@ module Google
6227
6207
 
6228
6208
  @security_center_stub.call_rpc :batch_create_resource_value_configs, request, options: options do |response, operation|
6229
6209
  yield response, operation if block_given?
6230
- return response
6231
6210
  end
6232
6211
  rescue ::GRPC::BadStatus => e
6233
6212
  raise ::Google::Cloud::Error.from_error(e)
@@ -6313,7 +6292,6 @@ module Google
6313
6292
 
6314
6293
  @security_center_stub.call_rpc :delete_resource_value_config, request, options: options do |response, operation|
6315
6294
  yield response, operation if block_given?
6316
- return response
6317
6295
  end
6318
6296
  rescue ::GRPC::BadStatus => e
6319
6297
  raise ::Google::Cloud::Error.from_error(e)
@@ -6400,7 +6378,6 @@ module Google
6400
6378
 
6401
6379
  @security_center_stub.call_rpc :get_resource_value_config, request, options: options do |response, operation|
6402
6380
  yield response, operation if block_given?
6403
- return response
6404
6381
  end
6405
6382
  rescue ::GRPC::BadStatus => e
6406
6383
  raise ::Google::Cloud::Error.from_error(e)
@@ -6507,7 +6484,7 @@ module Google
6507
6484
  @security_center_stub.call_rpc :list_resource_value_configs, request, options: options do |response, operation|
6508
6485
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_resource_value_configs, request, response, operation, options
6509
6486
  yield response, operation if block_given?
6510
- return response
6487
+ throw :response, response
6511
6488
  end
6512
6489
  rescue ::GRPC::BadStatus => e
6513
6490
  raise ::Google::Cloud::Error.from_error(e)
@@ -6596,7 +6573,6 @@ module Google
6596
6573
 
6597
6574
  @security_center_stub.call_rpc :update_resource_value_config, request, options: options do |response, operation|
6598
6575
  yield response, operation if block_given?
6599
- return response
6600
6576
  end
6601
6577
  rescue ::GRPC::BadStatus => e
6602
6578
  raise ::Google::Cloud::Error.from_error(e)
@@ -6726,7 +6702,7 @@ module Google
6726
6702
  @security_center_stub.call_rpc :list_valued_resources, request, options: options do |response, operation|
6727
6703
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_valued_resources, request, response, operation, options
6728
6704
  yield response, operation if block_given?
6729
- return response
6705
+ throw :response, response
6730
6706
  end
6731
6707
  rescue ::GRPC::BadStatus => e
6732
6708
  raise ::Google::Cloud::Error.from_error(e)
@@ -6836,7 +6812,7 @@ module Google
6836
6812
  @security_center_stub.call_rpc :list_attack_paths, request, options: options do |response, operation|
6837
6813
  response = ::Gapic::PagedEnumerable.new @security_center_stub, :list_attack_paths, request, response, operation, options
6838
6814
  yield response, operation if block_given?
6839
- return response
6815
+ throw :response, response
6840
6816
  end
6841
6817
  rescue ::GRPC::BadStatus => e
6842
6818
  raise ::Google::Cloud::Error.from_error(e)
@@ -6886,6 +6862,13 @@ module Google
6886
6862
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
6887
6863
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
6888
6864
  # * (`nil`) indicating no credentials
6865
+ #
6866
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
6867
+ # external source for authentication to Google Cloud, you must validate it before
6868
+ # providing it to a Google API client library. Providing an unvalidated credential
6869
+ # configuration to Google APIs can compromise the security of your systems and data.
6870
+ # For more information, refer to [Validate credential configurations from external
6871
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
6889
6872
  # @return [::Object]
6890
6873
  # @!attribute [rw] scope
6891
6874
  # The OAuth scopes
@@ -6925,6 +6908,11 @@ module Google
6925
6908
  # default endpoint URL. The default value of nil uses the environment
6926
6909
  # universe (usually the default "googleapis.com" universe).
6927
6910
  # @return [::String,nil]
6911
+ # @!attribute [rw] logger
6912
+ # A custom logger to use for request/response debug logging, or the value
6913
+ # `:default` (the default) to construct a default logger, or `nil` to
6914
+ # explicitly disable logging.
6915
+ # @return [::Logger,:default,nil]
6928
6916
  #
6929
6917
  class Configuration
6930
6918
  extend ::Gapic::Config
@@ -6949,6 +6937,7 @@ module Google
6949
6937
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
6950
6938
  config_attr :quota_project, nil, ::String, nil
6951
6939
  config_attr :universe_domain, nil, ::String, nil
6940
+ config_attr :logger, :default, ::Logger, nil, :default
6952
6941
 
6953
6942
  # @private
6954
6943
  def initialize parent_config = nil