google-cloud-gke_multi_cloud-v1 0.11.0 → 0.12.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 +30 -20
- data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/client.rb +32 -10
- data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/operations.rb +12 -15
- data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/client.rb +32 -10
- data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/operations.rb +43 -38
- data/lib/google/cloud/gke_multi_cloud/v1/attached_clusters/rest/service_stub.rb +86 -56
- data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/client.rb +36 -17
- data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/operations.rb +12 -15
- data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/client.rb +36 -17
- data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/operations.rb +43 -38
- data/lib/google/cloud/gke_multi_cloud/v1/aws_clusters/rest/service_stub.rb +142 -98
- data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/client.rb +38 -20
- data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/operations.rb +12 -15
- data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/client.rb +38 -20
- data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/operations.rb +43 -38
- data/lib/google/cloud/gke_multi_cloud/v1/azure_clusters/rest/service_stub.rb +166 -116
- data/lib/google/cloud/gke_multi_cloud/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +39 -0
- data/proto_docs/google/longrunning/operations.rb +19 -14
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: ba68b4c33ec67cc9d379afc10b3f988b09d98cdebee7227337b3a73d60fbb734
|
4
|
+
data.tar.gz: 8338b0fadfcfc9fbd54f8d9f74026a9a6d43e9eb961e0422349a00161278228c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b803eec20a12035b95de71135ebd1b679f9fc3d0e7b795f31a9a1597a1a79315a677a9f4d4b4cab1428f44df224e739b3246ebafc3b4225924382d7268d87db1
|
7
|
+
data.tar.gz: 2a08028f99dd7e914621468b04bfb8bd0b479ee7a3b4158156c27f608ced412ab8601c0a042dba8428d28e6097ef51859781cba7467b390deab6e1d4e10e46d7
|
data/README.md
CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
|
|
43
43
|
See also the [Product Documentation](https://cloud.google.com/anthos/clusters/docs/multi-cloud)
|
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/gke_multi_cloud/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::GkeMultiCloud::V1::AttachedClusters::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).
|
@@ -199,8 +199,19 @@ module Google
|
|
199
199
|
universe_domain: @config.universe_domain,
|
200
200
|
channel_args: @config.channel_args,
|
201
201
|
interceptors: @config.interceptors,
|
202
|
-
channel_pool_config: @config.channel_pool
|
202
|
+
channel_pool_config: @config.channel_pool,
|
203
|
+
logger: @config.logger
|
203
204
|
)
|
205
|
+
|
206
|
+
@attached_clusters_stub.stub_logger&.info do |entry|
|
207
|
+
entry.set_system_name
|
208
|
+
entry.set_service
|
209
|
+
entry.message = "Created client for #{entry.service}"
|
210
|
+
entry.set_credentials_fields credentials
|
211
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
212
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
213
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
214
|
+
end
|
204
215
|
end
|
205
216
|
|
206
217
|
##
|
@@ -210,6 +221,15 @@ module Google
|
|
210
221
|
#
|
211
222
|
attr_reader :operations_client
|
212
223
|
|
224
|
+
##
|
225
|
+
# The logger used for request/response debug logging.
|
226
|
+
#
|
227
|
+
# @return [Logger]
|
228
|
+
#
|
229
|
+
def logger
|
230
|
+
@attached_clusters_stub.logger
|
231
|
+
end
|
232
|
+
|
213
233
|
# Service calls
|
214
234
|
|
215
235
|
##
|
@@ -328,7 +348,7 @@ module Google
|
|
328
348
|
@attached_clusters_stub.call_rpc :create_attached_cluster, request, options: options do |response, operation|
|
329
349
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
330
350
|
yield response, operation if block_given?
|
331
|
-
|
351
|
+
throw :response, response
|
332
352
|
end
|
333
353
|
rescue ::GRPC::BadStatus => e
|
334
354
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -444,7 +464,7 @@ module Google
|
|
444
464
|
@attached_clusters_stub.call_rpc :update_attached_cluster, request, options: options do |response, operation|
|
445
465
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
446
466
|
yield response, operation if block_given?
|
447
|
-
|
467
|
+
throw :response, response
|
448
468
|
end
|
449
469
|
rescue ::GRPC::BadStatus => e
|
450
470
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -570,7 +590,7 @@ module Google
|
|
570
590
|
@attached_clusters_stub.call_rpc :import_attached_cluster, request, options: options do |response, operation|
|
571
591
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
572
592
|
yield response, operation if block_given?
|
573
|
-
|
593
|
+
throw :response, response
|
574
594
|
end
|
575
595
|
rescue ::GRPC::BadStatus => e
|
576
596
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -665,7 +685,6 @@ module Google
|
|
665
685
|
|
666
686
|
@attached_clusters_stub.call_rpc :get_attached_cluster, request, options: options do |response, operation|
|
667
687
|
yield response, operation if block_given?
|
668
|
-
return response
|
669
688
|
end
|
670
689
|
rescue ::GRPC::BadStatus => e
|
671
690
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -775,7 +794,7 @@ module Google
|
|
775
794
|
@attached_clusters_stub.call_rpc :list_attached_clusters, request, options: options do |response, operation|
|
776
795
|
response = ::Gapic::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, request, response, operation, options
|
777
796
|
yield response, operation if block_given?
|
778
|
-
|
797
|
+
throw :response, response
|
779
798
|
end
|
780
799
|
rescue ::GRPC::BadStatus => e
|
781
800
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -904,7 +923,7 @@ module Google
|
|
904
923
|
@attached_clusters_stub.call_rpc :delete_attached_cluster, request, options: options do |response, operation|
|
905
924
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
906
925
|
yield response, operation if block_given?
|
907
|
-
|
926
|
+
throw :response, response
|
908
927
|
end
|
909
928
|
rescue ::GRPC::BadStatus => e
|
910
929
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -999,7 +1018,6 @@ module Google
|
|
999
1018
|
|
1000
1019
|
@attached_clusters_stub.call_rpc :get_attached_server_config, request, options: options do |response, operation|
|
1001
1020
|
yield response, operation if block_given?
|
1002
|
-
return response
|
1003
1021
|
end
|
1004
1022
|
rescue ::GRPC::BadStatus => e
|
1005
1023
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1116,7 +1134,6 @@ module Google
|
|
1116
1134
|
|
1117
1135
|
@attached_clusters_stub.call_rpc :generate_attached_cluster_install_manifest, request, options: options do |response, operation|
|
1118
1136
|
yield response, operation if block_given?
|
1119
|
-
return response
|
1120
1137
|
end
|
1121
1138
|
rescue ::GRPC::BadStatus => e
|
1122
1139
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1218,7 +1235,6 @@ module Google
|
|
1218
1235
|
|
1219
1236
|
@attached_clusters_stub.call_rpc :generate_attached_cluster_agent_token, request, options: options do |response, operation|
|
1220
1237
|
yield response, operation if block_given?
|
1221
|
-
return response
|
1222
1238
|
end
|
1223
1239
|
rescue ::GRPC::BadStatus => e
|
1224
1240
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1307,6 +1323,11 @@ module Google
|
|
1307
1323
|
# default endpoint URL. The default value of nil uses the environment
|
1308
1324
|
# universe (usually the default "googleapis.com" universe).
|
1309
1325
|
# @return [::String,nil]
|
1326
|
+
# @!attribute [rw] logger
|
1327
|
+
# A custom logger to use for request/response debug logging, or the value
|
1328
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1329
|
+
# explicitly disable logging.
|
1330
|
+
# @return [::Logger,:default,nil]
|
1310
1331
|
#
|
1311
1332
|
class Configuration
|
1312
1333
|
extend ::Gapic::Config
|
@@ -1331,6 +1352,7 @@ module Google
|
|
1331
1352
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
1332
1353
|
config_attr :quota_project, nil, ::String, nil
|
1333
1354
|
config_attr :universe_domain, nil, ::String, nil
|
1355
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1334
1356
|
|
1335
1357
|
# @private
|
1336
1358
|
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.
|
@@ -221,7 +213,7 @@ module Google
|
|
221
213
|
wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
|
222
214
|
response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
|
223
215
|
yield response, operation if block_given?
|
224
|
-
|
216
|
+
throw :response, response
|
225
217
|
end
|
226
218
|
rescue ::GRPC::BadStatus => e
|
227
219
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -317,7 +309,7 @@ module Google
|
|
317
309
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
318
310
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
319
311
|
yield response, operation if block_given?
|
320
|
-
|
312
|
+
throw :response, response
|
321
313
|
end
|
322
314
|
rescue ::GRPC::BadStatus => e
|
323
315
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -406,7 +398,6 @@ module Google
|
|
406
398
|
|
407
399
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
408
400
|
yield response, operation if block_given?
|
409
|
-
return response
|
410
401
|
end
|
411
402
|
rescue ::GRPC::BadStatus => e
|
412
403
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -421,8 +412,9 @@ module Google
|
|
421
412
|
# other methods to check whether the cancellation succeeded or whether the
|
422
413
|
# operation completed despite cancellation. On successful cancellation,
|
423
414
|
# the operation is not deleted; instead, it becomes an operation with
|
424
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
425
|
-
# corresponding to
|
415
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
416
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
417
|
+
# `Code.CANCELLED`.
|
426
418
|
#
|
427
419
|
# @overload cancel_operation(request, options = nil)
|
428
420
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
@@ -501,7 +493,6 @@ module Google
|
|
501
493
|
|
502
494
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
503
495
|
yield response, operation if block_given?
|
504
|
-
return response
|
505
496
|
end
|
506
497
|
rescue ::GRPC::BadStatus => e
|
507
498
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -599,7 +590,7 @@ module Google
|
|
599
590
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
600
591
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
601
592
|
yield response, operation if block_given?
|
602
|
-
|
593
|
+
throw :response, response
|
603
594
|
end
|
604
595
|
rescue ::GRPC::BadStatus => e
|
605
596
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -688,6 +679,11 @@ module Google
|
|
688
679
|
# default endpoint URL. The default value of nil uses the environment
|
689
680
|
# universe (usually the default "googleapis.com" universe).
|
690
681
|
# @return [::String,nil]
|
682
|
+
# @!attribute [rw] logger
|
683
|
+
# A custom logger to use for request/response debug logging, or the value
|
684
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
685
|
+
# explicitly disable logging.
|
686
|
+
# @return [::Logger,:default,nil]
|
691
687
|
#
|
692
688
|
class Configuration
|
693
689
|
extend ::Gapic::Config
|
@@ -712,6 +708,7 @@ module Google
|
|
712
708
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
713
709
|
config_attr :quota_project, nil, ::String, nil
|
714
710
|
config_attr :universe_domain, nil, ::String, nil
|
711
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
715
712
|
|
716
713
|
# @private
|
717
714
|
def initialize parent_config = nil
|
@@ -192,8 +192,19 @@ module Google
|
|
192
192
|
endpoint: @config.endpoint,
|
193
193
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
194
194
|
universe_domain: @config.universe_domain,
|
195
|
-
credentials: credentials
|
195
|
+
credentials: credentials,
|
196
|
+
logger: @config.logger
|
196
197
|
)
|
198
|
+
|
199
|
+
@attached_clusters_stub.logger(stub: true)&.info do |entry|
|
200
|
+
entry.set_system_name
|
201
|
+
entry.set_service
|
202
|
+
entry.message = "Created client for #{entry.service}"
|
203
|
+
entry.set_credentials_fields credentials
|
204
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
205
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
206
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
207
|
+
end
|
197
208
|
end
|
198
209
|
|
199
210
|
##
|
@@ -203,6 +214,15 @@ module Google
|
|
203
214
|
#
|
204
215
|
attr_reader :operations_client
|
205
216
|
|
217
|
+
##
|
218
|
+
# The logger used for request/response debug logging.
|
219
|
+
#
|
220
|
+
# @return [Logger]
|
221
|
+
#
|
222
|
+
def logger
|
223
|
+
@attached_clusters_stub.logger
|
224
|
+
end
|
225
|
+
|
206
226
|
# Service calls
|
207
227
|
|
208
228
|
##
|
@@ -314,7 +334,7 @@ module Google
|
|
314
334
|
@attached_clusters_stub.create_attached_cluster request, options do |result, operation|
|
315
335
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
316
336
|
yield result, operation if block_given?
|
317
|
-
|
337
|
+
throw :response, result
|
318
338
|
end
|
319
339
|
rescue ::Gapic::Rest::Error => e
|
320
340
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -423,7 +443,7 @@ module Google
|
|
423
443
|
@attached_clusters_stub.update_attached_cluster request, options do |result, operation|
|
424
444
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
425
445
|
yield result, operation if block_given?
|
426
|
-
|
446
|
+
throw :response, result
|
427
447
|
end
|
428
448
|
rescue ::Gapic::Rest::Error => e
|
429
449
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -542,7 +562,7 @@ module Google
|
|
542
562
|
@attached_clusters_stub.import_attached_cluster request, options do |result, operation|
|
543
563
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
544
564
|
yield result, operation if block_given?
|
545
|
-
|
565
|
+
throw :response, result
|
546
566
|
end
|
547
567
|
rescue ::Gapic::Rest::Error => e
|
548
568
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -630,7 +650,6 @@ module Google
|
|
630
650
|
|
631
651
|
@attached_clusters_stub.get_attached_cluster request, options do |result, operation|
|
632
652
|
yield result, operation if block_given?
|
633
|
-
return result
|
634
653
|
end
|
635
654
|
rescue ::Gapic::Rest::Error => e
|
636
655
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -733,7 +752,7 @@ module Google
|
|
733
752
|
@attached_clusters_stub.list_attached_clusters request, options do |result, operation|
|
734
753
|
result = ::Gapic::Rest::PagedEnumerable.new @attached_clusters_stub, :list_attached_clusters, "attached_clusters", request, result, options
|
735
754
|
yield result, operation if block_given?
|
736
|
-
|
755
|
+
throw :response, result
|
737
756
|
end
|
738
757
|
rescue ::Gapic::Rest::Error => e
|
739
758
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -855,7 +874,7 @@ module Google
|
|
855
874
|
@attached_clusters_stub.delete_attached_cluster request, options do |result, operation|
|
856
875
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
857
876
|
yield result, operation if block_given?
|
858
|
-
|
877
|
+
throw :response, result
|
859
878
|
end
|
860
879
|
rescue ::Gapic::Rest::Error => e
|
861
880
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -943,7 +962,6 @@ module Google
|
|
943
962
|
|
944
963
|
@attached_clusters_stub.get_attached_server_config request, options do |result, operation|
|
945
964
|
yield result, operation if block_given?
|
946
|
-
return result
|
947
965
|
end
|
948
966
|
rescue ::Gapic::Rest::Error => e
|
949
967
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1053,7 +1071,6 @@ module Google
|
|
1053
1071
|
|
1054
1072
|
@attached_clusters_stub.generate_attached_cluster_install_manifest request, options do |result, operation|
|
1055
1073
|
yield result, operation if block_given?
|
1056
|
-
return result
|
1057
1074
|
end
|
1058
1075
|
rescue ::Gapic::Rest::Error => e
|
1059
1076
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1148,7 +1165,6 @@ module Google
|
|
1148
1165
|
|
1149
1166
|
@attached_clusters_stub.generate_attached_cluster_agent_token request, options do |result, operation|
|
1150
1167
|
yield result, operation if block_given?
|
1151
|
-
return result
|
1152
1168
|
end
|
1153
1169
|
rescue ::Gapic::Rest::Error => e
|
1154
1170
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1228,6 +1244,11 @@ module Google
|
|
1228
1244
|
# default endpoint URL. The default value of nil uses the environment
|
1229
1245
|
# universe (usually the default "googleapis.com" universe).
|
1230
1246
|
# @return [::String,nil]
|
1247
|
+
# @!attribute [rw] logger
|
1248
|
+
# A custom logger to use for request/response debug logging, or the value
|
1249
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1250
|
+
# explicitly disable logging.
|
1251
|
+
# @return [::Logger,:default,nil]
|
1231
1252
|
#
|
1232
1253
|
class Configuration
|
1233
1254
|
extend ::Gapic::Config
|
@@ -1249,6 +1270,7 @@ module Google
|
|
1249
1270
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
1250
1271
|
config_attr :quota_project, nil, ::String, nil
|
1251
1272
|
config_attr :universe_domain, nil, ::String, nil
|
1273
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1252
1274
|
|
1253
1275
|
# @private
|
1254
1276
|
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)
|
@@ -543,6 +534,11 @@ module Google
|
|
543
534
|
# default endpoint URL. The default value of nil uses the environment
|
544
535
|
# universe (usually the default "googleapis.com" universe).
|
545
536
|
# @return [::String,nil]
|
537
|
+
# @!attribute [rw] logger
|
538
|
+
# A custom logger to use for request/response debug logging, or the value
|
539
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
540
|
+
# explicitly disable logging.
|
541
|
+
# @return [::Logger,:default,nil]
|
546
542
|
#
|
547
543
|
class Configuration
|
548
544
|
extend ::Gapic::Config
|
@@ -564,6 +560,7 @@ module Google
|
|
564
560
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
565
561
|
config_attr :quota_project, nil, ::String, nil
|
566
562
|
config_attr :universe_domain, nil, ::String, nil
|
563
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
567
564
|
|
568
565
|
# @private
|
569
566
|
def initialize parent_config = nil
|
@@ -683,16 +680,18 @@ module Google
|
|
683
680
|
|
684
681
|
response = @client_stub.make_http_request(
|
685
682
|
verb,
|
686
|
-
uri:
|
687
|
-
body:
|
688
|
-
params:
|
683
|
+
uri: uri,
|
684
|
+
body: body || "",
|
685
|
+
params: query_string_params,
|
686
|
+
method_name: "list_operations",
|
689
687
|
options: options
|
690
688
|
)
|
691
689
|
operation = ::Gapic::Rest::TransportOperation.new response
|
692
690
|
result = ::Google::Longrunning::ListOperationsResponse.decode_json response.body, ignore_unknown_fields: true
|
693
|
-
|
694
|
-
|
695
|
-
|
691
|
+
catch :response do
|
692
|
+
yield result, operation if block_given?
|
693
|
+
result
|
694
|
+
end
|
696
695
|
end
|
697
696
|
|
698
697
|
##
|
@@ -721,16 +720,18 @@ module Google
|
|
721
720
|
|
722
721
|
response = @client_stub.make_http_request(
|
723
722
|
verb,
|
724
|
-
uri:
|
725
|
-
body:
|
726
|
-
params:
|
723
|
+
uri: uri,
|
724
|
+
body: body || "",
|
725
|
+
params: query_string_params,
|
726
|
+
method_name: "get_operation",
|
727
727
|
options: options
|
728
728
|
)
|
729
729
|
operation = ::Gapic::Rest::TransportOperation.new response
|
730
730
|
result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
|
731
|
-
|
732
|
-
|
733
|
-
|
731
|
+
catch :response do
|
732
|
+
yield result, operation if block_given?
|
733
|
+
result
|
734
|
+
end
|
734
735
|
end
|
735
736
|
|
736
737
|
##
|
@@ -759,16 +760,18 @@ module Google
|
|
759
760
|
|
760
761
|
response = @client_stub.make_http_request(
|
761
762
|
verb,
|
762
|
-
uri:
|
763
|
-
body:
|
764
|
-
params:
|
763
|
+
uri: uri,
|
764
|
+
body: body || "",
|
765
|
+
params: query_string_params,
|
766
|
+
method_name: "delete_operation",
|
765
767
|
options: options
|
766
768
|
)
|
767
769
|
operation = ::Gapic::Rest::TransportOperation.new response
|
768
770
|
result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
|
769
|
-
|
770
|
-
|
771
|
-
|
771
|
+
catch :response do
|
772
|
+
yield result, operation if block_given?
|
773
|
+
result
|
774
|
+
end
|
772
775
|
end
|
773
776
|
|
774
777
|
##
|
@@ -797,16 +800,18 @@ module Google
|
|
797
800
|
|
798
801
|
response = @client_stub.make_http_request(
|
799
802
|
verb,
|
800
|
-
uri:
|
801
|
-
body:
|
802
|
-
params:
|
803
|
+
uri: uri,
|
804
|
+
body: body || "",
|
805
|
+
params: query_string_params,
|
806
|
+
method_name: "cancel_operation",
|
803
807
|
options: options
|
804
808
|
)
|
805
809
|
operation = ::Gapic::Rest::TransportOperation.new response
|
806
810
|
result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
|
807
|
-
|
808
|
-
|
809
|
-
|
811
|
+
catch :response do
|
812
|
+
yield result, operation if block_given?
|
813
|
+
result
|
814
|
+
end
|
810
815
|
end
|
811
816
|
|
812
817
|
##
|