google-cloud-gke_multi_cloud-v1 0.11.0 → 0.12.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|
##
|