google-cloud-functions-v1 1.1.1 → 1.3.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: 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: []