google-cloud-functions-v1 1.1.1 → 1.3.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 35c5ab8ce9343f4da9d89e22fa7e0f09d9f5537e1b870386961b7da54c3ae7f9
4
- data.tar.gz: 26813bb96e4c8ed12bddb22c783db93912bbf3d9307ebbc5c51abaddb36d1e1f
3
+ metadata.gz: cc10263e2a4fe9e1b2808a8e311ceed76bf036e1147bc50ad061a2e6dbc6a364
4
+ data.tar.gz: 6f332a7413d64ad66929d797f5d1018d3a77e11afa91df240af8b8c7e92ddeab
5
5
  SHA512:
6
- metadata.gz: a782f4b70cf438806165718b43a581a4b91ded218283a2abe9ec3ca68751543090db7b985f5bf6b36562393fb30ab4dae384d0a4efc8e049db19077da3e2e7b4
7
- data.tar.gz: 9a0fcd45c0b1542d91161ed397a63fd4407dfc211b557a63b866c7484a69950799dc654d79730b51cf8e6f865da9a1459dae0056644495304652423db8642b4a
6
+ metadata.gz: f6ddf5372eed2d429664574004d6874398642c12a5fe5be618cec2a421a1ab3c316f68404be01f6af3e30890c63029cad3079dd7fe4c76720839222b145d5b05
7
+ data.tar.gz: '07597d5f217eeeaf2d423c81d98dc616a858dd8c39c2759e5b59d57b04bdbb673c00523e689e038010f0b3cd77fc2f802076aca84985e229ba42447bc494c1c8'
data/README.md CHANGED
@@ -43,40 +43,50 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/functions)
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/functions/v1"
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::Functions::V1::CloudFunctionsService::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).
76
86
 
77
87
  ## Supported Ruby Versions
78
88
 
79
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
80
90
 
81
91
  Google provides official support for Ruby versions that are actively supported
82
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -190,14 +190,26 @@ module Google
190
190
  universe_domain: @config.universe_domain,
191
191
  channel_args: @config.channel_args,
192
192
  interceptors: @config.interceptors,
193
- channel_pool_config: @config.channel_pool
193
+ channel_pool_config: @config.channel_pool,
194
+ logger: @config.logger
194
195
  )
195
196
 
197
+ @cloud_functions_service_stub.stub_logger&.info do |entry|
198
+ entry.set_system_name
199
+ entry.set_service
200
+ entry.message = "Created client for #{entry.service}"
201
+ entry.set_credentials_fields credentials
202
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
203
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
204
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
205
+ end
206
+
196
207
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
197
208
  config.credentials = credentials
198
209
  config.quota_project = @quota_project_id
199
210
  config.endpoint = @cloud_functions_service_stub.endpoint
200
211
  config.universe_domain = @cloud_functions_service_stub.universe_domain
212
+ config.logger = @cloud_functions_service_stub.logger if config.respond_to? :logger=
201
213
  end
202
214
 
203
215
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -205,6 +217,7 @@ module Google
205
217
  config.quota_project = @quota_project_id
206
218
  config.endpoint = @cloud_functions_service_stub.endpoint
207
219
  config.universe_domain = @cloud_functions_service_stub.universe_domain
220
+ config.logger = @cloud_functions_service_stub.logger if config.respond_to? :logger=
208
221
  end
209
222
  end
210
223
 
@@ -229,6 +242,15 @@ module Google
229
242
  #
230
243
  attr_reader :iam_policy_client
231
244
 
245
+ ##
246
+ # The logger used for request/response debug logging.
247
+ #
248
+ # @return [Logger]
249
+ #
250
+ def logger
251
+ @cloud_functions_service_stub.logger
252
+ end
253
+
232
254
  # Service calls
233
255
 
234
256
  ##
@@ -328,7 +350,7 @@ module Google
328
350
  @cloud_functions_service_stub.call_rpc :list_functions, request, options: options do |response, operation|
329
351
  response = ::Gapic::PagedEnumerable.new @cloud_functions_service_stub, :list_functions, request, response, operation, options
330
352
  yield response, operation if block_given?
331
- return response
353
+ throw :response, response
332
354
  end
333
355
  rescue ::GRPC::BadStatus => e
334
356
  raise ::Google::Cloud::Error.from_error(e)
@@ -421,7 +443,6 @@ module Google
421
443
 
422
444
  @cloud_functions_service_stub.call_rpc :get_function, request, options: options do |response, operation|
423
445
  yield response, operation if block_given?
424
- return response
425
446
  end
426
447
  rescue ::GRPC::BadStatus => e
427
448
  raise ::Google::Cloud::Error.from_error(e)
@@ -520,7 +541,7 @@ module Google
520
541
  @cloud_functions_service_stub.call_rpc :create_function, request, options: options do |response, operation|
521
542
  response = ::Gapic::Operation.new response, @operations_client, options: options
522
543
  yield response, operation if block_given?
523
- return response
544
+ throw :response, response
524
545
  end
525
546
  rescue ::GRPC::BadStatus => e
526
547
  raise ::Google::Cloud::Error.from_error(e)
@@ -616,7 +637,7 @@ module Google
616
637
  @cloud_functions_service_stub.call_rpc :update_function, request, options: options do |response, operation|
617
638
  response = ::Gapic::Operation.new response, @operations_client, options: options
618
639
  yield response, operation if block_given?
619
- return response
640
+ throw :response, response
620
641
  end
621
642
  rescue ::GRPC::BadStatus => e
622
643
  raise ::Google::Cloud::Error.from_error(e)
@@ -712,7 +733,7 @@ module Google
712
733
  @cloud_functions_service_stub.call_rpc :delete_function, request, options: options do |response, operation|
713
734
  response = ::Gapic::Operation.new response, @operations_client, options: options
714
735
  yield response, operation if block_given?
715
- return response
736
+ throw :response, response
716
737
  end
717
738
  rescue ::GRPC::BadStatus => e
718
739
  raise ::Google::Cloud::Error.from_error(e)
@@ -803,7 +824,6 @@ module Google
803
824
 
804
825
  @cloud_functions_service_stub.call_rpc :call_function, request, options: options do |response, operation|
805
826
  yield response, operation if block_given?
806
- return response
807
827
  end
808
828
  rescue ::GRPC::BadStatus => e
809
829
  raise ::Google::Cloud::Error.from_error(e)
@@ -932,7 +952,6 @@ module Google
932
952
 
933
953
  @cloud_functions_service_stub.call_rpc :generate_upload_url, request, options: options do |response, operation|
934
954
  yield response, operation if block_given?
935
- return response
936
955
  end
937
956
  rescue ::GRPC::BadStatus => e
938
957
  raise ::Google::Cloud::Error.from_error(e)
@@ -1026,7 +1045,6 @@ module Google
1026
1045
 
1027
1046
  @cloud_functions_service_stub.call_rpc :generate_download_url, request, options: options do |response, operation|
1028
1047
  yield response, operation if block_given?
1029
- return response
1030
1048
  end
1031
1049
  rescue ::GRPC::BadStatus => e
1032
1050
  raise ::Google::Cloud::Error.from_error(e)
@@ -1125,7 +1143,6 @@ module Google
1125
1143
 
1126
1144
  @cloud_functions_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
1127
1145
  yield response, operation if block_given?
1128
- return response
1129
1146
  end
1130
1147
  rescue ::GRPC::BadStatus => e
1131
1148
  raise ::Google::Cloud::Error.from_error(e)
@@ -1217,7 +1234,6 @@ module Google
1217
1234
 
1218
1235
  @cloud_functions_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
1219
1236
  yield response, operation if block_given?
1220
- return response
1221
1237
  end
1222
1238
  rescue ::GRPC::BadStatus => e
1223
1239
  raise ::Google::Cloud::Error.from_error(e)
@@ -1312,7 +1328,6 @@ module Google
1312
1328
 
1313
1329
  @cloud_functions_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
1314
1330
  yield response, operation if block_given?
1315
- return response
1316
1331
  end
1317
1332
  rescue ::GRPC::BadStatus => e
1318
1333
  raise ::Google::Cloud::Error.from_error(e)
@@ -1362,6 +1377,13 @@ module Google
1362
1377
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1363
1378
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1364
1379
  # * (`nil`) indicating no credentials
1380
+ #
1381
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1382
+ # external source for authentication to Google Cloud, you must validate it before
1383
+ # providing it to a Google API client library. Providing an unvalidated credential
1384
+ # configuration to Google APIs can compromise the security of your systems and data.
1385
+ # For more information, refer to [Validate credential configurations from external
1386
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1365
1387
  # @return [::Object]
1366
1388
  # @!attribute [rw] scope
1367
1389
  # The OAuth scopes
@@ -1401,6 +1423,11 @@ module Google
1401
1423
  # default endpoint URL. The default value of nil uses the environment
1402
1424
  # universe (usually the default "googleapis.com" universe).
1403
1425
  # @return [::String,nil]
1426
+ # @!attribute [rw] logger
1427
+ # A custom logger to use for request/response debug logging, or the value
1428
+ # `:default` (the default) to construct a default logger, or `nil` to
1429
+ # explicitly disable logging.
1430
+ # @return [::Logger,:default,nil]
1404
1431
  #
1405
1432
  class Configuration
1406
1433
  extend ::Gapic::Config
@@ -1425,6 +1452,7 @@ module Google
1425
1452
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1426
1453
  config_attr :quota_project, nil, ::String, nil
1427
1454
  config_attr :universe_domain, nil, ::String, nil
1455
+ config_attr :logger, :default, ::Logger, nil, :default
1428
1456
 
1429
1457
  # @private
1430
1458
  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
@@ -183,15 +183,27 @@ module Google
183
183
  endpoint: @config.endpoint,
184
184
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
185
185
  universe_domain: @config.universe_domain,
186
- credentials: credentials
186
+ credentials: credentials,
187
+ logger: @config.logger
187
188
  )
188
189
 
190
+ @cloud_functions_service_stub.logger(stub: true)&.info do |entry|
191
+ entry.set_system_name
192
+ entry.set_service
193
+ entry.message = "Created client for #{entry.service}"
194
+ entry.set_credentials_fields credentials
195
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
196
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
197
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
198
+ end
199
+
189
200
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
190
201
  config.credentials = credentials
191
202
  config.quota_project = @quota_project_id
192
203
  config.endpoint = @cloud_functions_service_stub.endpoint
193
204
  config.universe_domain = @cloud_functions_service_stub.universe_domain
194
205
  config.bindings_override = @config.bindings_override
206
+ config.logger = @cloud_functions_service_stub.logger if config.respond_to? :logger=
195
207
  end
196
208
 
197
209
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -199,6 +211,7 @@ module Google
199
211
  config.quota_project = @quota_project_id
200
212
  config.endpoint = @cloud_functions_service_stub.endpoint
201
213
  config.universe_domain = @cloud_functions_service_stub.universe_domain
214
+ config.logger = @cloud_functions_service_stub.logger if config.respond_to? :logger=
202
215
  end
203
216
  end
204
217
 
@@ -223,6 +236,15 @@ module Google
223
236
  #
224
237
  attr_reader :iam_policy_client
225
238
 
239
+ ##
240
+ # The logger used for request/response debug logging.
241
+ #
242
+ # @return [Logger]
243
+ #
244
+ def logger
245
+ @cloud_functions_service_stub.logger
246
+ end
247
+
226
248
  # Service calls
227
249
 
228
250
  ##
@@ -314,7 +336,6 @@ module Google
314
336
 
315
337
  @cloud_functions_service_stub.list_functions request, options do |result, operation|
316
338
  yield result, operation if block_given?
317
- return result
318
339
  end
319
340
  rescue ::Gapic::Rest::Error => e
320
341
  raise ::Google::Cloud::Error.from_error(e)
@@ -400,7 +421,6 @@ module Google
400
421
 
401
422
  @cloud_functions_service_stub.get_function request, options do |result, operation|
402
423
  yield result, operation if block_given?
403
- return result
404
424
  end
405
425
  rescue ::Gapic::Rest::Error => e
406
426
  raise ::Google::Cloud::Error.from_error(e)
@@ -492,7 +512,7 @@ module Google
492
512
  @cloud_functions_service_stub.create_function request, options do |result, operation|
493
513
  result = ::Gapic::Operation.new result, @operations_client, options: options
494
514
  yield result, operation if block_given?
495
- return result
515
+ throw :response, result
496
516
  end
497
517
  rescue ::Gapic::Rest::Error => e
498
518
  raise ::Google::Cloud::Error.from_error(e)
@@ -581,7 +601,7 @@ module Google
581
601
  @cloud_functions_service_stub.update_function request, options do |result, operation|
582
602
  result = ::Gapic::Operation.new result, @operations_client, options: options
583
603
  yield result, operation if block_given?
584
- return result
604
+ throw :response, result
585
605
  end
586
606
  rescue ::Gapic::Rest::Error => e
587
607
  raise ::Google::Cloud::Error.from_error(e)
@@ -670,7 +690,7 @@ module Google
670
690
  @cloud_functions_service_stub.delete_function request, options do |result, operation|
671
691
  result = ::Gapic::Operation.new result, @operations_client, options: options
672
692
  yield result, operation if block_given?
673
- return result
693
+ throw :response, result
674
694
  end
675
695
  rescue ::Gapic::Rest::Error => e
676
696
  raise ::Google::Cloud::Error.from_error(e)
@@ -754,7 +774,6 @@ module Google
754
774
 
755
775
  @cloud_functions_service_stub.call_function request, options do |result, operation|
756
776
  yield result, operation if block_given?
757
- return result
758
777
  end
759
778
  rescue ::Gapic::Rest::Error => e
760
779
  raise ::Google::Cloud::Error.from_error(e)
@@ -876,7 +895,6 @@ module Google
876
895
 
877
896
  @cloud_functions_service_stub.generate_upload_url request, options do |result, operation|
878
897
  yield result, operation if block_given?
879
- return result
880
898
  end
881
899
  rescue ::Gapic::Rest::Error => e
882
900
  raise ::Google::Cloud::Error.from_error(e)
@@ -963,7 +981,6 @@ module Google
963
981
 
964
982
  @cloud_functions_service_stub.generate_download_url request, options do |result, operation|
965
983
  yield result, operation if block_given?
966
- return result
967
984
  end
968
985
  rescue ::Gapic::Rest::Error => e
969
986
  raise ::Google::Cloud::Error.from_error(e)
@@ -1055,7 +1072,6 @@ module Google
1055
1072
 
1056
1073
  @cloud_functions_service_stub.set_iam_policy request, options do |result, operation|
1057
1074
  yield result, operation if block_given?
1058
- return result
1059
1075
  end
1060
1076
  rescue ::Gapic::Rest::Error => e
1061
1077
  raise ::Google::Cloud::Error.from_error(e)
@@ -1140,7 +1156,6 @@ module Google
1140
1156
 
1141
1157
  @cloud_functions_service_stub.get_iam_policy request, options do |result, operation|
1142
1158
  yield result, operation if block_given?
1143
- return result
1144
1159
  end
1145
1160
  rescue ::Gapic::Rest::Error => e
1146
1161
  raise ::Google::Cloud::Error.from_error(e)
@@ -1228,7 +1243,6 @@ module Google
1228
1243
 
1229
1244
  @cloud_functions_service_stub.test_iam_permissions request, options do |result, operation|
1230
1245
  yield result, operation if block_given?
1231
- return result
1232
1246
  end
1233
1247
  rescue ::Gapic::Rest::Error => e
1234
1248
  raise ::Google::Cloud::Error.from_error(e)
@@ -1276,6 +1290,13 @@ module Google
1276
1290
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1277
1291
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1278
1292
  # * (`nil`) indicating no credentials
1293
+ #
1294
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1295
+ # external source for authentication to Google Cloud, you must validate it before
1296
+ # providing it to a Google API client library. Providing an unvalidated credential
1297
+ # configuration to Google APIs can compromise the security of your systems and data.
1298
+ # For more information, refer to [Validate credential configurations from external
1299
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1279
1300
  # @return [::Object]
1280
1301
  # @!attribute [rw] scope
1281
1302
  # The OAuth scopes
@@ -1308,6 +1329,11 @@ module Google
1308
1329
  # default endpoint URL. The default value of nil uses the environment
1309
1330
  # universe (usually the default "googleapis.com" universe).
1310
1331
  # @return [::String,nil]
1332
+ # @!attribute [rw] logger
1333
+ # A custom logger to use for request/response debug logging, or the value
1334
+ # `:default` (the default) to construct a default logger, or `nil` to
1335
+ # explicitly disable logging.
1336
+ # @return [::Logger,:default,nil]
1311
1337
  #
1312
1338
  class Configuration
1313
1339
  extend ::Gapic::Config
@@ -1336,6 +1362,7 @@ module Google
1336
1362
  # by the host service.
1337
1363
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1338
1364
  config_attr :bindings_override, {}, ::Hash, nil
1365
+ config_attr :logger, :default, ::Logger, nil, :default
1339
1366
 
1340
1367
  # @private
1341
1368
  def initialize parent_config = nil
@@ -115,14 +115,6 @@ module Google
115
115
  # Lists operations that match the specified filter in the request. If the
116
116
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
117
117
  #
118
- # NOTE: the `name` binding allows API services to override the binding
119
- # to use different resource name schemes, such as `users/*/operations`. To
120
- # override the binding, API services can add a binding such as
121
- # `"/v1/{name=users/*}/operations"` to their service configuration.
122
- # For backwards compatibility, the default name includes the operations
123
- # collection id, however overriding users must ensure the name binding
124
- # is the parent resource, without the operations collection id.
125
- #
126
118
  # @overload list_operations(request, options = nil)
127
119
  # Pass arguments to `list_operations` via a request object, either of type
128
120
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -204,7 +196,7 @@ module Google
204
196
  @operations_stub.list_operations request, options do |result, operation|
205
197
  result = ::Gapic::Rest::PagedEnumerable.new @operations_stub, :list_operations, "operations", request, result, options
206
198
  yield result, operation if block_given?
207
- return result
199
+ throw :response, result
208
200
  end
209
201
  rescue ::Gapic::Rest::Error => e
210
202
  raise ::Google::Cloud::Error.from_error(e)
@@ -293,7 +285,7 @@ module Google
293
285
  @operations_stub.get_operation request, options do |result, operation|
294
286
  result = ::Gapic::Operation.new result, @operations_client, options: options
295
287
  yield result, operation if block_given?
296
- return result
288
+ throw :response, result
297
289
  end
298
290
  rescue ::Gapic::Rest::Error => e
299
291
  raise ::Google::Cloud::Error.from_error(e)
@@ -375,7 +367,6 @@ module Google
375
367
 
376
368
  @operations_stub.delete_operation request, options do |result, operation|
377
369
  yield result, operation if block_given?
378
- return result
379
370
  end
380
371
  rescue ::Gapic::Rest::Error => e
381
372
  raise ::Google::Cloud::Error.from_error(e)
@@ -390,8 +381,9 @@ module Google
390
381
  # other methods to check whether the cancellation succeeded or whether the
391
382
  # operation completed despite cancellation. On successful cancellation,
392
383
  # the operation is not deleted; instead, it becomes an operation with
393
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
394
- # corresponding to `Code.CANCELLED`.
384
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
385
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
386
+ # `Code.CANCELLED`.
395
387
  #
396
388
  # @overload cancel_operation(request, options = nil)
397
389
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -463,7 +455,6 @@ module Google
463
455
 
464
456
  @operations_stub.cancel_operation request, options do |result, operation|
465
457
  yield result, operation if block_given?
466
- return result
467
458
  end
468
459
  rescue ::Gapic::Rest::Error => e
469
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -511,6 +502,13 @@ module Google
511
502
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
512
503
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
513
504
  # * (`nil`) indicating no credentials
505
+ #
506
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
507
+ # external source for authentication to Google Cloud, you must validate it before
508
+ # providing it to a Google API client library. Providing an unvalidated credential
509
+ # configuration to Google APIs can compromise the security of your systems and data.
510
+ # For more information, refer to [Validate credential configurations from external
511
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
514
512
  # @return [::Object]
515
513
  # @!attribute [rw] scope
516
514
  # The OAuth scopes
@@ -543,6 +541,11 @@ module Google
543
541
  # default endpoint URL. The default value of nil uses the environment
544
542
  # universe (usually the default "googleapis.com" universe).
545
543
  # @return [::String,nil]
544
+ # @!attribute [rw] logger
545
+ # A custom logger to use for request/response debug logging, or the value
546
+ # `:default` (the default) to construct a default logger, or `nil` to
547
+ # explicitly disable logging.
548
+ # @return [::Logger,:default,nil]
546
549
  #
547
550
  class Configuration
548
551
  extend ::Gapic::Config
@@ -564,6 +567,7 @@ module Google
564
567
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
565
568
  config_attr :quota_project, nil, ::String, nil
566
569
  config_attr :universe_domain, nil, ::String, nil
570
+ config_attr :logger, :default, ::Logger, nil, :default
567
571
 
568
572
  # @private
569
573
  def initialize parent_config = nil
@@ -683,16 +687,18 @@ module Google
683
687
 
684
688
  response = @client_stub.make_http_request(
685
689
  verb,
686
- uri: uri,
687
- body: body || "",
688
- params: query_string_params,
690
+ uri: uri,
691
+ body: body || "",
692
+ params: query_string_params,
693
+ method_name: "list_operations",
689
694
  options: options
690
695
  )
691
696
  operation = ::Gapic::Rest::TransportOperation.new response
692
697
  result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
693
-
694
- yield result, operation if block_given?
695
- result
698
+ catch :response do
699
+ yield result, operation if block_given?
700
+ result
701
+ end
696
702
  end
697
703
 
698
704
  ##
@@ -721,16 +727,18 @@ module Google
721
727
 
722
728
  response = @client_stub.make_http_request(
723
729
  verb,
724
- uri: uri,
725
- body: body || "",
726
- params: query_string_params,
730
+ uri: uri,
731
+ body: body || "",
732
+ params: query_string_params,
733
+ method_name: "get_operation",
727
734
  options: options
728
735
  )
729
736
  operation = ::Gapic::Rest::TransportOperation.new response
730
737
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
731
-
732
- yield result, operation if block_given?
733
- result
738
+ catch :response do
739
+ yield result, operation if block_given?
740
+ result
741
+ end
734
742
  end
735
743
 
736
744
  ##
@@ -759,16 +767,18 @@ module Google
759
767
 
760
768
  response = @client_stub.make_http_request(
761
769
  verb,
762
- uri: uri,
763
- body: body || "",
764
- params: query_string_params,
770
+ uri: uri,
771
+ body: body || "",
772
+ params: query_string_params,
773
+ method_name: "delete_operation",
765
774
  options: options
766
775
  )
767
776
  operation = ::Gapic::Rest::TransportOperation.new response
768
777
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
769
-
770
- yield result, operation if block_given?
771
- result
778
+ catch :response do
779
+ yield result, operation if block_given?
780
+ result
781
+ end
772
782
  end
773
783
 
774
784
  ##
@@ -797,16 +807,18 @@ module Google
797
807
 
798
808
  response = @client_stub.make_http_request(
799
809
  verb,
800
- uri: uri,
801
- body: body || "",
802
- params: query_string_params,
810
+ uri: uri,
811
+ body: body || "",
812
+ params: query_string_params,
813
+ method_name: "cancel_operation",
803
814
  options: options
804
815
  )
805
816
  operation = ::Gapic::Rest::TransportOperation.new response
806
817
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
807
-
808
- yield result, operation if block_given?
809
- result
818
+ catch :response do
819
+ yield result, operation if block_given?
820
+ result
821
+ end
810
822
  end
811
823
 
812
824
  ##
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the list_functions REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "list_functions",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Functions::V1::ListFunctionsResponse.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "get_function",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Functions::V1::CloudFunction.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "create_function",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "update_function",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "delete_function",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "call_function",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::Functions::V1::CallFunctionResponse.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "generate_upload_url",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Cloud::Functions::V1::GenerateUploadUrlResponse.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -353,16 +379,18 @@ module Google
353
379
 
354
380
  response = @client_stub.make_http_request(
355
381
  verb,
356
- uri: uri,
357
- body: body || "",
358
- params: query_string_params,
382
+ uri: uri,
383
+ body: body || "",
384
+ params: query_string_params,
385
+ method_name: "generate_download_url",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::Functions::V1::GenerateDownloadUrlResponse.decode_json response.body, ignore_unknown_fields: true
363
-
364
- yield result, operation if block_given?
365
- result
390
+ catch :response do
391
+ yield result, operation if block_given?
392
+ result
393
+ end
366
394
  end
367
395
 
368
396
  ##
@@ -391,16 +419,18 @@ module Google
391
419
 
392
420
  response = @client_stub.make_http_request(
393
421
  verb,
394
- uri: uri,
395
- body: body || "",
396
- params: query_string_params,
422
+ uri: uri,
423
+ body: body || "",
424
+ params: query_string_params,
425
+ method_name: "set_iam_policy",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
401
-
402
- yield result, operation if block_given?
403
- result
430
+ catch :response do
431
+ yield result, operation if block_given?
432
+ result
433
+ end
404
434
  end
405
435
 
406
436
  ##
@@ -429,16 +459,18 @@ module Google
429
459
 
430
460
  response = @client_stub.make_http_request(
431
461
  verb,
432
- uri: uri,
433
- body: body || "",
434
- params: query_string_params,
462
+ uri: uri,
463
+ body: body || "",
464
+ params: query_string_params,
465
+ method_name: "get_iam_policy",
435
466
  options: options
436
467
  )
437
468
  operation = ::Gapic::Rest::TransportOperation.new response
438
469
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
439
-
440
- yield result, operation if block_given?
441
- result
470
+ catch :response do
471
+ yield result, operation if block_given?
472
+ result
473
+ end
442
474
  end
443
475
 
444
476
  ##
@@ -467,16 +499,18 @@ module Google
467
499
 
468
500
  response = @client_stub.make_http_request(
469
501
  verb,
470
- uri: uri,
471
- body: body || "",
472
- params: query_string_params,
502
+ uri: uri,
503
+ body: body || "",
504
+ params: query_string_params,
505
+ method_name: "test_iam_permissions",
473
506
  options: options
474
507
  )
475
508
  operation = ::Gapic::Rest::TransportOperation.new response
476
509
  result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
477
-
478
- yield result, operation if block_given?
479
- result
510
+ catch :response do
511
+ yield result, operation if block_given?
512
+ result
513
+ end
480
514
  end
481
515
 
482
516
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Functions
23
23
  module V1
24
- VERSION = "1.1.1"
24
+ VERSION = "1.3.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -34,11 +34,15 @@ module Google
34
34
  # @return [::String]
35
35
  # The Google Cloud Storage URL, starting with `gs://`, pointing to the zip
36
36
  # archive which contains the function.
37
+ #
38
+ # Note: The following fields are mutually exclusive: `source_archive_url`, `source_repository`, `source_upload_url`. If a field in that set is populated, all other fields in the set will automatically be cleared.
37
39
  # @!attribute [rw] source_repository
38
40
  # @return [::Google::Cloud::Functions::V1::SourceRepository]
39
41
  # **Beta Feature**
40
42
  #
41
43
  # The source repository where a function is hosted.
44
+ #
45
+ # Note: The following fields are mutually exclusive: `source_repository`, `source_archive_url`, `source_upload_url`. If a field in that set is populated, all other fields in the set will automatically be cleared.
42
46
  # @!attribute [rw] source_upload_url
43
47
  # @return [::String]
44
48
  # The Google Cloud Storage signed URL used for source uploading, generated
@@ -47,12 +51,18 @@ module Google
47
51
  # The signature is validated on write methods (Create, Update)
48
52
  # The signature is stripped from the Function object on read methods (Get,
49
53
  # List)
54
+ #
55
+ # Note: The following fields are mutually exclusive: `source_upload_url`, `source_archive_url`, `source_repository`. If a field in that set is populated, all other fields in the set will automatically be cleared.
50
56
  # @!attribute [rw] https_trigger
51
57
  # @return [::Google::Cloud::Functions::V1::HttpsTrigger]
52
58
  # An HTTPS endpoint type of source that can be triggered via URL.
59
+ #
60
+ # Note: The following fields are mutually exclusive: `https_trigger`, `event_trigger`. If a field in that set is populated, all other fields in the set will automatically be cleared.
53
61
  # @!attribute [rw] event_trigger
54
62
  # @return [::Google::Cloud::Functions::V1::EventTrigger]
55
63
  # A source that fires events in response to a condition in another service.
64
+ #
65
+ # Note: The following fields are mutually exclusive: `event_trigger`, `https_trigger`. If a field in that set is populated, all other fields in the set will automatically be cleared.
56
66
  # @!attribute [r] status
57
67
  # @return [::Google::Cloud::Functions::V1::CloudFunctionStatus]
58
68
  # Output only. Status of the function deployment.
@@ -226,8 +236,10 @@ module Google
226
236
  # unspecified or set to `ARTIFACT_REGISTRY`.
227
237
  # @!attribute [rw] automatic_update_policy
228
238
  # @return [::Google::Cloud::Functions::V1::CloudFunction::AutomaticUpdatePolicy]
239
+ # Note: The following fields are mutually exclusive: `automatic_update_policy`, `on_deploy_update_policy`. If a field in that set is populated, all other fields in the set will automatically be cleared.
229
240
  # @!attribute [rw] on_deploy_update_policy
230
241
  # @return [::Google::Cloud::Functions::V1::CloudFunction::OnDeployUpdatePolicy]
242
+ # Note: The following fields are mutually exclusive: `on_deploy_update_policy`, `automatic_update_policy`. If a field in that set is populated, all other fields in the set will automatically be cleared.
231
243
  # @!attribute [rw] build_service_account
232
244
  # @return [::String]
233
245
  # A service account the user provides for use with Cloud Build. The format of
@@ -40,9 +40,11 @@ module Google
40
40
  # @!attribute [rw] error
41
41
  # @return [::Google::Rpc::Status]
42
42
  # The error result of the operation in case of failure or cancellation.
43
+ #
44
+ # Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
43
45
  # @!attribute [rw] response
44
46
  # @return [::Google::Protobuf::Any]
45
- # The normal response of the operation in case of success. If the original
47
+ # The normal, successful response of the operation. If the original
46
48
  # method returns no data on success, such as `Delete`, the response is
47
49
  # `google.protobuf.Empty`. If the original method is standard
48
50
  # `Get`/`Create`/`Update`, the response should be the resource. For other
@@ -50,12 +52,15 @@ module Google
50
52
  # is the original method name. For example, if the original method name
51
53
  # is `TakeSnapshot()`, the inferred response type is
52
54
  # `TakeSnapshotResponse`.
55
+ #
56
+ # Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
53
57
  class Operation
54
58
  include ::Google::Protobuf::MessageExts
55
59
  extend ::Google::Protobuf::MessageExts::ClassMethods
56
60
  end
57
61
 
58
- # The request message for Operations.GetOperation.
62
+ # The request message for
63
+ # Operations.GetOperation.
59
64
  # @!attribute [rw] name
60
65
  # @return [::String]
61
66
  # The name of the operation resource.
@@ -64,7 +69,8 @@ module Google
64
69
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
70
  end
66
71
 
67
- # The request message for Operations.ListOperations.
72
+ # The request message for
73
+ # Operations.ListOperations.
68
74
  # @!attribute [rw] name
69
75
  # @return [::String]
70
76
  # The name of the operation's parent resource.
@@ -82,7 +88,8 @@ module Google
82
88
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
89
  end
84
90
 
85
- # The response message for Operations.ListOperations.
91
+ # The response message for
92
+ # Operations.ListOperations.
86
93
  # @!attribute [rw] operations
87
94
  # @return [::Array<::Google::Longrunning::Operation>]
88
95
  # A list of operations that matches the specified filter in the request.
@@ -94,7 +101,8 @@ module Google
94
101
  extend ::Google::Protobuf::MessageExts::ClassMethods
95
102
  end
96
103
 
97
- # The request message for Operations.CancelOperation.
104
+ # The request message for
105
+ # Operations.CancelOperation.
98
106
  # @!attribute [rw] name
99
107
  # @return [::String]
100
108
  # The name of the operation resource to be cancelled.
@@ -103,7 +111,8 @@ module Google
103
111
  extend ::Google::Protobuf::MessageExts::ClassMethods
104
112
  end
105
113
 
106
- # The request message for Operations.DeleteOperation.
114
+ # The request message for
115
+ # Operations.DeleteOperation.
107
116
  # @!attribute [rw] name
108
117
  # @return [::String]
109
118
  # The name of the operation resource to be deleted.
@@ -112,7 +121,8 @@ module Google
112
121
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
122
  end
114
123
 
115
- # The request message for Operations.WaitOperation.
124
+ # The request message for
125
+ # Operations.WaitOperation.
116
126
  # @!attribute [rw] name
117
127
  # @return [::String]
118
128
  # The name of the operation resource to wait on.
@@ -130,13 +140,12 @@ module Google
130
140
  #
131
141
  # Example:
132
142
  #
133
- # rpc LongRunningRecognize(LongRunningRecognizeRequest)
134
- # returns (google.longrunning.Operation) {
135
- # option (google.longrunning.operation_info) = {
136
- # response_type: "LongRunningRecognizeResponse"
137
- # metadata_type: "LongRunningRecognizeMetadata"
138
- # };
139
- # }
143
+ # rpc Export(ExportRequest) returns (google.longrunning.Operation) {
144
+ # option (google.longrunning.operation_info) = {
145
+ # response_type: "ExportResponse"
146
+ # metadata_type: "ExportMetadata"
147
+ # };
148
+ # }
140
149
  # @!attribute [rw] response_type
141
150
  # @return [::String]
142
151
  # Required. The message name of the primary return type for this
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-functions-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.1
4
+ version: 1.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
10
+ date: 2025-01-29 00:00:00.000000000 Z
12
11
  dependencies:
13
12
  - !ruby/object:Gem::Dependency
14
13
  name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
16
15
  requirements:
17
16
  - - ">="
18
17
  - !ruby/object:Gem::Version
19
- version: 0.21.1
18
+ version: 0.25.0
20
19
  - - "<"
21
20
  - !ruby/object:Gem::Version
22
21
  version: 2.a
@@ -26,7 +25,7 @@ dependencies:
26
25
  requirements:
27
26
  - - ">="
28
27
  - !ruby/object:Gem::Version
29
- version: 0.21.1
28
+ version: 0.25.0
30
29
  - - "<"
31
30
  - !ruby/object:Gem::Version
32
31
  version: 2.a
@@ -133,7 +132,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
133
132
  licenses:
134
133
  - Apache-2.0
135
134
  metadata: {}
136
- post_install_message:
137
135
  rdoc_options: []
138
136
  require_paths:
139
137
  - lib
@@ -141,15 +139,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
141
139
  requirements:
142
140
  - - ">="
143
141
  - !ruby/object:Gem::Version
144
- version: '2.7'
142
+ version: '3.0'
145
143
  required_rubygems_version: !ruby/object:Gem::Requirement
146
144
  requirements:
147
145
  - - ">="
148
146
  - !ruby/object:Gem::Version
149
147
  version: '0'
150
148
  requirements: []
151
- rubygems_version: 3.5.6
152
- signing_key:
149
+ rubygems_version: 3.6.2
153
150
  specification_version: 4
154
151
  summary: Manages lightweight user-provided functions executed in response to events.
155
152
  test_files: []