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 +4 -4
- data/README.md +31 -21
- data/lib/google/cloud/functions/v1/cloud_functions_service/client.rb +40 -12
- data/lib/google/cloud/functions/v1/cloud_functions_service/operations.rb +19 -15
- data/lib/google/cloud/functions/v1/cloud_functions_service/rest/client.rb +39 -12
- data/lib/google/cloud/functions/v1/cloud_functions_service/rest/operations.rb +50 -38
- data/lib/google/cloud/functions/v1/cloud_functions_service/rest/service_stub.rb +102 -68
- data/lib/google/cloud/functions/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +39 -0
- data/proto_docs/google/cloud/functions/v1/functions.rb +12 -0
- data/proto_docs/google/longrunning/operations.rb +23 -14
- metadata +6 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: cc10263e2a4fe9e1b2808a8e311ceed76bf036e1147bc50ad061a2e6dbc6a364
|
4
|
+
data.tar.gz: 6f332a7413d64ad66929d797f5d1018d3a77e11afa91df240af8b8c7e92ddeab
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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
|
-
##
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
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
|
-
|
60
|
-
|
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
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
417
|
-
# corresponding to
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
-
|
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
|
394
|
-
# corresponding to
|
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:
|
687
|
-
body:
|
688
|
-
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
|
-
|
695
|
-
|
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:
|
725
|
-
body:
|
726
|
-
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
|
-
|
733
|
-
|
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:
|
763
|
-
body:
|
764
|
-
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
|
-
|
771
|
-
|
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:
|
801
|
-
body:
|
802
|
-
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
|
-
|
809
|
-
|
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
|
-
|
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
|
-
|
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:
|
91
|
-
body:
|
92
|
-
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
|
-
|
99
|
-
|
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:
|
129
|
-
body:
|
130
|
-
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
|
-
|
137
|
-
|
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:
|
167
|
-
body:
|
168
|
-
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
|
-
|
175
|
-
|
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:
|
205
|
-
body:
|
206
|
-
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
|
-
|
213
|
-
|
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:
|
243
|
-
body:
|
244
|
-
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
|
-
|
251
|
-
|
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:
|
281
|
-
body:
|
282
|
-
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
|
-
|
289
|
-
|
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:
|
319
|
-
body:
|
320
|
-
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
|
-
|
327
|
-
|
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:
|
357
|
-
body:
|
358
|
-
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
|
-
|
365
|
-
|
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:
|
395
|
-
body:
|
396
|
-
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
|
-
|
403
|
-
|
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:
|
433
|
-
body:
|
434
|
-
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
|
-
|
441
|
-
|
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:
|
471
|
-
body:
|
472
|
-
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
|
-
|
479
|
-
|
510
|
+
catch :response do
|
511
|
+
yield result, operation if block_given?
|
512
|
+
result
|
513
|
+
end
|
480
514
|
end
|
481
515
|
|
482
516
|
##
|
@@ -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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
-
#
|
134
|
-
#
|
135
|
-
#
|
136
|
-
#
|
137
|
-
#
|
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.
|
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:
|
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.
|
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.
|
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: '
|
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.
|
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: []
|