google-cloud-service_management-v1 1.0.2 → 1.2.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: e3ebd712a7cec2c51462d5784ceddb8c6458d3b6f30c29714446ca6222adc215
4
- data.tar.gz: 5df991aff4d4e8cda24c4ef84576edce04f732e79db505bcfa66149280fe068c
3
+ metadata.gz: c9975e310ff5e6522472335d73156e3628777e7caef6c60147cf87bb56c72ce9
4
+ data.tar.gz: fb0318f2689bd3fe121eecdca8bd420fb8b129b9efd2f52b5e9748643df593d9
5
5
  SHA512:
6
- metadata.gz: aaac3526b78022e7f9abfb2a23239f8a2b778465910313a9fea188fae761ebec43f531c7782085538c7830fb13c8a7a9c4e5d7236efd75f9d79fa60cb7357098
7
- data.tar.gz: 6c4b87db9fd9fa9c3d8ed03ba93cddb26774a1615c76a5561457d25a9a6742d39a615e06f54b710d5528d6d271a852e2258a9e396004871f45d31b847d4e58cb
6
+ metadata.gz: bf09478953ab1a1060b4b42889a69992d413780cf60083c38723d36f2aae6429af47ebb59c9181d4b0feac85c7d3bafe87a265a07b1db602f0e9b838996dbf37
7
+ data.tar.gz: c8384ae1e69987b2c4d1411538a29507c9ee467d3021eae3ae3eb205e8aaeaec17ea3e70d25b606e09395258679f77d395c8abb593e09852b7bb6592f9299b23
data/README.md CHANGED
@@ -42,40 +42,50 @@ for class and method documentation.
42
42
  See also the [Product Documentation](https://cloud.google.com/service-infrastructure/docs/overview/)
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/service_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::ServiceManagement::V1::ServiceManager::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
@@ -166,14 +166,26 @@ module Google
166
166
  universe_domain: @config.universe_domain,
167
167
  channel_args: @config.channel_args,
168
168
  interceptors: @config.interceptors,
169
- channel_pool_config: @config.channel_pool
169
+ channel_pool_config: @config.channel_pool,
170
+ logger: @config.logger
170
171
  )
171
172
 
173
+ @service_manager_stub.stub_logger&.info do |entry|
174
+ entry.set_system_name
175
+ entry.set_service
176
+ entry.message = "Created client for #{entry.service}"
177
+ entry.set_credentials_fields credentials
178
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
179
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
180
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
181
+ end
182
+
172
183
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
173
184
  config.credentials = credentials
174
185
  config.quota_project = @quota_project_id
175
186
  config.endpoint = @service_manager_stub.endpoint
176
187
  config.universe_domain = @service_manager_stub.universe_domain
188
+ config.logger = @service_manager_stub.logger if config.respond_to? :logger=
177
189
  end
178
190
  end
179
191
 
@@ -191,6 +203,15 @@ module Google
191
203
  #
192
204
  attr_reader :iam_policy_client
193
205
 
206
+ ##
207
+ # The logger used for request/response debug logging.
208
+ #
209
+ # @return [Logger]
210
+ #
211
+ def logger
212
+ @service_manager_stub.logger
213
+ end
214
+
194
215
  # Service calls
195
216
 
196
217
  ##
@@ -286,7 +307,7 @@ module Google
286
307
  @service_manager_stub.call_rpc :list_services, request, options: options do |response, operation|
287
308
  response = ::Gapic::PagedEnumerable.new @service_manager_stub, :list_services, request, response, operation, options
288
309
  yield response, operation if block_given?
289
- return response
310
+ throw :response, response
290
311
  end
291
312
  rescue ::GRPC::BadStatus => e
292
313
  raise ::Google::Cloud::Error.from_error(e)
@@ -374,7 +395,6 @@ module Google
374
395
 
375
396
  @service_manager_stub.call_rpc :get_service, request, options: options do |response, operation|
376
397
  yield response, operation if block_given?
377
- return response
378
398
  end
379
399
  rescue ::GRPC::BadStatus => e
380
400
  raise ::Google::Cloud::Error.from_error(e)
@@ -470,7 +490,7 @@ module Google
470
490
  @service_manager_stub.call_rpc :create_service, request, options: options do |response, operation|
471
491
  response = ::Gapic::Operation.new response, @operations_client, options: options
472
492
  yield response, operation if block_given?
473
- return response
493
+ throw :response, response
474
494
  end
475
495
  rescue ::GRPC::BadStatus => e
476
496
  raise ::Google::Cloud::Error.from_error(e)
@@ -573,7 +593,7 @@ module Google
573
593
  @service_manager_stub.call_rpc :delete_service, request, options: options do |response, operation|
574
594
  response = ::Gapic::Operation.new response, @operations_client, options: options
575
595
  yield response, operation if block_given?
576
- return response
596
+ throw :response, response
577
597
  end
578
598
  rescue ::GRPC::BadStatus => e
579
599
  raise ::Google::Cloud::Error.from_error(e)
@@ -674,7 +694,7 @@ module Google
674
694
  @service_manager_stub.call_rpc :undelete_service, request, options: options do |response, operation|
675
695
  response = ::Gapic::Operation.new response, @operations_client, options: options
676
696
  yield response, operation if block_given?
677
- return response
697
+ throw :response, response
678
698
  end
679
699
  rescue ::GRPC::BadStatus => e
680
700
  raise ::Google::Cloud::Error.from_error(e)
@@ -773,7 +793,7 @@ module Google
773
793
  @service_manager_stub.call_rpc :list_service_configs, request, options: options do |response, operation|
774
794
  response = ::Gapic::PagedEnumerable.new @service_manager_stub, :list_service_configs, request, response, operation, options
775
795
  yield response, operation if block_given?
776
- return response
796
+ throw :response, response
777
797
  end
778
798
  rescue ::GRPC::BadStatus => e
779
799
  raise ::Google::Cloud::Error.from_error(e)
@@ -872,7 +892,6 @@ module Google
872
892
 
873
893
  @service_manager_stub.call_rpc :get_service_config, request, options: options do |response, operation|
874
894
  yield response, operation if block_given?
875
- return response
876
895
  end
877
896
  rescue ::GRPC::BadStatus => e
878
897
  raise ::Google::Cloud::Error.from_error(e)
@@ -969,7 +988,6 @@ module Google
969
988
 
970
989
  @service_manager_stub.call_rpc :create_service_config, request, options: options do |response, operation|
971
990
  yield response, operation if block_given?
972
- return response
973
991
  end
974
992
  rescue ::GRPC::BadStatus => e
975
993
  raise ::Google::Cloud::Error.from_error(e)
@@ -1084,7 +1102,7 @@ module Google
1084
1102
  @service_manager_stub.call_rpc :submit_config_source, request, options: options do |response, operation|
1085
1103
  response = ::Gapic::Operation.new response, @operations_client, options: options
1086
1104
  yield response, operation if block_given?
1087
- return response
1105
+ throw :response, response
1088
1106
  end
1089
1107
  rescue ::GRPC::BadStatus => e
1090
1108
  raise ::Google::Cloud::Error.from_error(e)
@@ -1194,7 +1212,7 @@ module Google
1194
1212
  @service_manager_stub.call_rpc :list_service_rollouts, request, options: options do |response, operation|
1195
1213
  response = ::Gapic::PagedEnumerable.new @service_manager_stub, :list_service_rollouts, request, response, operation, options
1196
1214
  yield response, operation if block_given?
1197
- return response
1215
+ throw :response, response
1198
1216
  end
1199
1217
  rescue ::GRPC::BadStatus => e
1200
1218
  raise ::Google::Cloud::Error.from_error(e)
@@ -1288,7 +1306,6 @@ module Google
1288
1306
 
1289
1307
  @service_manager_stub.call_rpc :get_service_rollout, request, options: options do |response, operation|
1290
1308
  yield response, operation if block_given?
1291
- return response
1292
1309
  end
1293
1310
  rescue ::GRPC::BadStatus => e
1294
1311
  raise ::Google::Cloud::Error.from_error(e)
@@ -1399,7 +1416,7 @@ module Google
1399
1416
  @service_manager_stub.call_rpc :create_service_rollout, request, options: options do |response, operation|
1400
1417
  response = ::Gapic::Operation.new response, @operations_client, options: options
1401
1418
  yield response, operation if block_given?
1402
- return response
1419
+ throw :response, response
1403
1420
  end
1404
1421
  rescue ::GRPC::BadStatus => e
1405
1422
  raise ::Google::Cloud::Error.from_error(e)
@@ -1497,7 +1514,6 @@ module Google
1497
1514
 
1498
1515
  @service_manager_stub.call_rpc :generate_config_report, request, options: options do |response, operation|
1499
1516
  yield response, operation if block_given?
1500
- return response
1501
1517
  end
1502
1518
  rescue ::GRPC::BadStatus => e
1503
1519
  raise ::Google::Cloud::Error.from_error(e)
@@ -1547,6 +1563,13 @@ module Google
1547
1563
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1548
1564
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1549
1565
  # * (`nil`) indicating no credentials
1566
+ #
1567
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1568
+ # external source for authentication to Google Cloud, you must validate it before
1569
+ # providing it to a Google API client library. Providing an unvalidated credential
1570
+ # configuration to Google APIs can compromise the security of your systems and data.
1571
+ # For more information, refer to [Validate credential configurations from external
1572
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1550
1573
  # @return [::Object]
1551
1574
  # @!attribute [rw] scope
1552
1575
  # The OAuth scopes
@@ -1586,6 +1609,11 @@ module Google
1586
1609
  # default endpoint URL. The default value of nil uses the environment
1587
1610
  # universe (usually the default "googleapis.com" universe).
1588
1611
  # @return [::String,nil]
1612
+ # @!attribute [rw] logger
1613
+ # A custom logger to use for request/response debug logging, or the value
1614
+ # `:default` (the default) to construct a default logger, or `nil` to
1615
+ # explicitly disable logging.
1616
+ # @return [::Logger,:default,nil]
1589
1617
  #
1590
1618
  class Configuration
1591
1619
  extend ::Gapic::Config
@@ -1610,6 +1638,7 @@ module Google
1610
1638
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1611
1639
  config_attr :quota_project, nil, ::String, nil
1612
1640
  config_attr :universe_domain, nil, ::String, nil
1641
+ config_attr :logger, :default, ::Logger, nil, :default
1613
1642
 
1614
1643
  # @private
1615
1644
  def initialize parent_config = nil
@@ -124,14 +124,6 @@ module Google
124
124
  # Lists operations that match the specified filter in the request. If the
125
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
126
126
  #
127
- # NOTE: the `name` binding allows API services to override the binding
128
- # to use different resource name schemes, such as `users/*/operations`. To
129
- # override the binding, API services can add a binding such as
130
- # `"/v1/{name=users/*}/operations"` to their service configuration.
131
- # For backwards compatibility, the default name includes the operations
132
- # collection id, however overriding users must ensure the name binding
133
- # is the parent resource, without the operations collection id.
134
- #
135
127
  # @overload list_operations(request, options = nil)
136
128
  # Pass arguments to `list_operations` via a request object, either of type
137
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -213,7 +205,7 @@ module Google
213
205
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
214
206
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
215
207
  yield response, operation if block_given?
216
- return response
208
+ throw :response, response
217
209
  end
218
210
  rescue ::GRPC::BadStatus => e
219
211
  raise ::Google::Cloud::Error.from_error(e)
@@ -309,7 +301,7 @@ module Google
309
301
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
310
302
  response = ::Gapic::Operation.new response, @operations_client, options: options
311
303
  yield response, operation if block_given?
312
- return response
304
+ throw :response, response
313
305
  end
314
306
  rescue ::GRPC::BadStatus => e
315
307
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +390,6 @@ module Google
398
390
 
399
391
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
400
392
  yield response, operation if block_given?
401
- return response
402
393
  end
403
394
  rescue ::GRPC::BadStatus => e
404
395
  raise ::Google::Cloud::Error.from_error(e)
@@ -413,8 +404,9 @@ module Google
413
404
  # other methods to check whether the cancellation succeeded or whether the
414
405
  # operation completed despite cancellation. On successful cancellation,
415
406
  # the operation is not deleted; instead, it becomes an operation with
416
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
417
- # corresponding to `Code.CANCELLED`.
407
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
408
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
409
+ # `Code.CANCELLED`.
418
410
  #
419
411
  # @overload cancel_operation(request, options = nil)
420
412
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -493,7 +485,6 @@ module Google
493
485
 
494
486
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
495
487
  yield response, operation if block_given?
496
- return response
497
488
  end
498
489
  rescue ::GRPC::BadStatus => e
499
490
  raise ::Google::Cloud::Error.from_error(e)
@@ -591,7 +582,7 @@ module Google
591
582
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
592
583
  response = ::Gapic::Operation.new response, @operations_client, options: options
593
584
  yield response, operation if block_given?
594
- return response
585
+ throw :response, response
595
586
  end
596
587
  rescue ::GRPC::BadStatus => e
597
588
  raise ::Google::Cloud::Error.from_error(e)
@@ -641,6 +632,13 @@ module Google
641
632
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
642
633
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
643
634
  # * (`nil`) indicating no credentials
635
+ #
636
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
637
+ # external source for authentication to Google Cloud, you must validate it before
638
+ # providing it to a Google API client library. Providing an unvalidated credential
639
+ # configuration to Google APIs can compromise the security of your systems and data.
640
+ # For more information, refer to [Validate credential configurations from external
641
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
644
642
  # @return [::Object]
645
643
  # @!attribute [rw] scope
646
644
  # The OAuth scopes
@@ -680,6 +678,11 @@ module Google
680
678
  # default endpoint URL. The default value of nil uses the environment
681
679
  # universe (usually the default "googleapis.com" universe).
682
680
  # @return [::String,nil]
681
+ # @!attribute [rw] logger
682
+ # A custom logger to use for request/response debug logging, or the value
683
+ # `:default` (the default) to construct a default logger, or `nil` to
684
+ # explicitly disable logging.
685
+ # @return [::Logger,:default,nil]
683
686
  #
684
687
  class Configuration
685
688
  extend ::Gapic::Config
@@ -704,6 +707,7 @@ module Google
704
707
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
705
708
  config_attr :quota_project, nil, ::String, nil
706
709
  config_attr :universe_domain, nil, ::String, nil
710
+ config_attr :logger, :default, ::Logger, nil, :default
707
711
 
708
712
  # @private
709
713
  def initialize parent_config = nil
@@ -159,15 +159,27 @@ module Google
159
159
  endpoint: @config.endpoint,
160
160
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
161
161
  universe_domain: @config.universe_domain,
162
- credentials: credentials
162
+ credentials: credentials,
163
+ logger: @config.logger
163
164
  )
164
165
 
166
+ @service_manager_stub.logger(stub: true)&.info do |entry|
167
+ entry.set_system_name
168
+ entry.set_service
169
+ entry.message = "Created client for #{entry.service}"
170
+ entry.set_credentials_fields credentials
171
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
172
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
173
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
174
+ end
175
+
165
176
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
166
177
  config.credentials = credentials
167
178
  config.quota_project = @quota_project_id
168
179
  config.endpoint = @service_manager_stub.endpoint
169
180
  config.universe_domain = @service_manager_stub.universe_domain
170
181
  config.bindings_override = @config.bindings_override
182
+ config.logger = @service_manager_stub.logger if config.respond_to? :logger=
171
183
  end
172
184
  end
173
185
 
@@ -185,6 +197,15 @@ module Google
185
197
  #
186
198
  attr_reader :iam_policy_client
187
199
 
200
+ ##
201
+ # The logger used for request/response debug logging.
202
+ #
203
+ # @return [Logger]
204
+ #
205
+ def logger
206
+ @service_manager_stub.logger
207
+ end
208
+
188
209
  # Service calls
189
210
 
190
211
  ##
@@ -281,7 +302,7 @@ module Google
281
302
  @service_manager_stub.list_services request, options do |result, operation|
282
303
  result = ::Gapic::Rest::PagedEnumerable.new @service_manager_stub, :list_services, "services", request, result, options
283
304
  yield result, operation if block_given?
284
- return result
305
+ throw :response, result
285
306
  end
286
307
  rescue ::Gapic::Rest::Error => e
287
308
  raise ::Google::Cloud::Error.from_error(e)
@@ -362,7 +383,6 @@ module Google
362
383
 
363
384
  @service_manager_stub.get_service request, options do |result, operation|
364
385
  yield result, operation if block_given?
365
- return result
366
386
  end
367
387
  rescue ::Gapic::Rest::Error => e
368
388
  raise ::Google::Cloud::Error.from_error(e)
@@ -459,7 +479,7 @@ module Google
459
479
  @service_manager_stub.create_service request, options do |result, operation|
460
480
  result = ::Gapic::Operation.new result, @operations_client, options: options
461
481
  yield result, operation if block_given?
462
- return result
482
+ throw :response, result
463
483
  end
464
484
  rescue ::Gapic::Rest::Error => e
465
485
  raise ::Google::Cloud::Error.from_error(e)
@@ -555,7 +575,7 @@ module Google
555
575
  @service_manager_stub.delete_service request, options do |result, operation|
556
576
  result = ::Gapic::Operation.new result, @operations_client, options: options
557
577
  yield result, operation if block_given?
558
- return result
578
+ throw :response, result
559
579
  end
560
580
  rescue ::Gapic::Rest::Error => e
561
581
  raise ::Google::Cloud::Error.from_error(e)
@@ -649,7 +669,7 @@ module Google
649
669
  @service_manager_stub.undelete_service request, options do |result, operation|
650
670
  result = ::Gapic::Operation.new result, @operations_client, options: options
651
671
  yield result, operation if block_given?
652
- return result
672
+ throw :response, result
653
673
  end
654
674
  rescue ::Gapic::Rest::Error => e
655
675
  raise ::Google::Cloud::Error.from_error(e)
@@ -741,7 +761,7 @@ module Google
741
761
  @service_manager_stub.list_service_configs request, options do |result, operation|
742
762
  result = ::Gapic::Rest::PagedEnumerable.new @service_manager_stub, :list_service_configs, "service_configs", request, result, options
743
763
  yield result, operation if block_given?
744
- return result
764
+ throw :response, result
745
765
  end
746
766
  rescue ::Gapic::Rest::Error => e
747
767
  raise ::Google::Cloud::Error.from_error(e)
@@ -830,7 +850,6 @@ module Google
830
850
 
831
851
  @service_manager_stub.get_service_config request, options do |result, operation|
832
852
  yield result, operation if block_given?
833
- return result
834
853
  end
835
854
  rescue ::Gapic::Rest::Error => e
836
855
  raise ::Google::Cloud::Error.from_error(e)
@@ -920,7 +939,6 @@ module Google
920
939
 
921
940
  @service_manager_stub.create_service_config request, options do |result, operation|
922
941
  yield result, operation if block_given?
923
- return result
924
942
  end
925
943
  rescue ::Gapic::Rest::Error => e
926
944
  raise ::Google::Cloud::Error.from_error(e)
@@ -1028,7 +1046,7 @@ module Google
1028
1046
  @service_manager_stub.submit_config_source request, options do |result, operation|
1029
1047
  result = ::Gapic::Operation.new result, @operations_client, options: options
1030
1048
  yield result, operation if block_given?
1031
- return result
1049
+ throw :response, result
1032
1050
  end
1033
1051
  rescue ::Gapic::Rest::Error => e
1034
1052
  raise ::Google::Cloud::Error.from_error(e)
@@ -1131,7 +1149,7 @@ module Google
1131
1149
  @service_manager_stub.list_service_rollouts request, options do |result, operation|
1132
1150
  result = ::Gapic::Rest::PagedEnumerable.new @service_manager_stub, :list_service_rollouts, "rollouts", request, result, options
1133
1151
  yield result, operation if block_given?
1134
- return result
1152
+ throw :response, result
1135
1153
  end
1136
1154
  rescue ::Gapic::Rest::Error => e
1137
1155
  raise ::Google::Cloud::Error.from_error(e)
@@ -1215,7 +1233,6 @@ module Google
1215
1233
 
1216
1234
  @service_manager_stub.get_service_rollout request, options do |result, operation|
1217
1235
  yield result, operation if block_given?
1218
- return result
1219
1236
  end
1220
1237
  rescue ::Gapic::Rest::Error => e
1221
1238
  raise ::Google::Cloud::Error.from_error(e)
@@ -1319,7 +1336,7 @@ module Google
1319
1336
  @service_manager_stub.create_service_rollout request, options do |result, operation|
1320
1337
  result = ::Gapic::Operation.new result, @operations_client, options: options
1321
1338
  yield result, operation if block_given?
1322
- return result
1339
+ throw :response, result
1323
1340
  end
1324
1341
  rescue ::Gapic::Rest::Error => e
1325
1342
  raise ::Google::Cloud::Error.from_error(e)
@@ -1418,7 +1435,6 @@ module Google
1418
1435
 
1419
1436
  @service_manager_stub.generate_config_report request, options do |result, operation|
1420
1437
  yield result, operation if block_given?
1421
- return result
1422
1438
  end
1423
1439
  rescue ::Gapic::Rest::Error => e
1424
1440
  raise ::Google::Cloud::Error.from_error(e)
@@ -1466,6 +1482,13 @@ module Google
1466
1482
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1467
1483
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1468
1484
  # * (`nil`) indicating no credentials
1485
+ #
1486
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1487
+ # external source for authentication to Google Cloud, you must validate it before
1488
+ # providing it to a Google API client library. Providing an unvalidated credential
1489
+ # configuration to Google APIs can compromise the security of your systems and data.
1490
+ # For more information, refer to [Validate credential configurations from external
1491
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1469
1492
  # @return [::Object]
1470
1493
  # @!attribute [rw] scope
1471
1494
  # The OAuth scopes
@@ -1498,6 +1521,11 @@ module Google
1498
1521
  # default endpoint URL. The default value of nil uses the environment
1499
1522
  # universe (usually the default "googleapis.com" universe).
1500
1523
  # @return [::String,nil]
1524
+ # @!attribute [rw] logger
1525
+ # A custom logger to use for request/response debug logging, or the value
1526
+ # `:default` (the default) to construct a default logger, or `nil` to
1527
+ # explicitly disable logging.
1528
+ # @return [::Logger,:default,nil]
1501
1529
  #
1502
1530
  class Configuration
1503
1531
  extend ::Gapic::Config
@@ -1526,6 +1554,7 @@ module Google
1526
1554
  # by the host service.
1527
1555
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1528
1556
  config_attr :bindings_override, {}, ::Hash, nil
1557
+ config_attr :logger, :default, ::Logger, nil, :default
1529
1558
 
1530
1559
  # @private
1531
1560
  def initialize parent_config = nil