google-cloud-api_hub-v1 0.2.0 → 0.4.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 +37 -1
- data/lib/google/cloud/api_hub/v1/api_hub/rest/client.rb +43 -36
- data/lib/google/cloud/api_hub/v1/api_hub/rest/service_stub.rb +294 -212
- data/lib/google/cloud/api_hub/v1/api_hub_dependencies/rest/client.rb +36 -6
- data/lib/google/cloud/api_hub/v1/api_hub_dependencies/rest/service_stub.rb +54 -32
- data/lib/google/cloud/api_hub/v1/api_hub_plugin/rest/client.rb +35 -4
- data/lib/google/cloud/api_hub/v1/api_hub_plugin/rest/service_stub.rb +38 -20
- data/lib/google/cloud/api_hub/v1/host_project_registration_service/rest/client.rb +36 -4
- data/lib/google/cloud/api_hub/v1/host_project_registration_service/rest/service_stub.rb +38 -20
- data/lib/google/cloud/api_hub/v1/linting_service/rest/client.rb +35 -5
- data/lib/google/cloud/api_hub/v1/linting_service/rest/service_stub.rb +46 -26
- data/lib/google/cloud/api_hub/v1/provisioning/rest/client.rb +36 -4
- data/lib/google/cloud/api_hub/v1/provisioning/rest/operations.rb +50 -38
- data/lib/google/cloud/api_hub/v1/provisioning/rest/service_stub.rb +38 -20
- data/lib/google/cloud/api_hub/v1/runtime_project_attachment_service/rest/client.rb +36 -6
- data/lib/google/cloud/api_hub/v1/runtime_project_attachment_service/rest/service_stub.rb +54 -32
- data/lib/google/cloud/api_hub/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +39 -0
- data/proto_docs/google/cloud/apihub/v1/apihub_service.rb +12 -0
- data/proto_docs/google/cloud/apihub/v1/common_fields.rb +10 -0
- data/proto_docs/google/longrunning/operations.rb +23 -14
- metadata +6 -9
@@ -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 create_host_project_registration 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: "create_host_project_registration",
|
93
106
|
options: options
|
94
107
|
)
|
95
108
|
operation = ::Gapic::Rest::TransportOperation.new response
|
96
109
|
result = ::Google::Cloud::ApiHub::V1::HostProjectRegistration.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_host_project_registration",
|
131
146
|
options: options
|
132
147
|
)
|
133
148
|
operation = ::Gapic::Rest::TransportOperation.new response
|
134
149
|
result = ::Google::Cloud::ApiHub::V1::HostProjectRegistration.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: "list_host_project_registrations",
|
169
186
|
options: options
|
170
187
|
)
|
171
188
|
operation = ::Gapic::Rest::TransportOperation.new response
|
172
189
|
result = ::Google::Cloud::ApiHub::V1::ListHostProjectRegistrationsResponse.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
|
##
|
@@ -165,15 +165,27 @@ module Google
|
|
165
165
|
endpoint: @config.endpoint,
|
166
166
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
167
167
|
universe_domain: @config.universe_domain,
|
168
|
-
credentials: credentials
|
168
|
+
credentials: credentials,
|
169
|
+
logger: @config.logger
|
169
170
|
)
|
170
171
|
|
172
|
+
@linting_service_stub.logger(stub: true)&.info do |entry|
|
173
|
+
entry.set_system_name
|
174
|
+
entry.set_service
|
175
|
+
entry.message = "Created client for #{entry.service}"
|
176
|
+
entry.set_credentials_fields credentials
|
177
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
178
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
179
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
180
|
+
end
|
181
|
+
|
171
182
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
172
183
|
config.credentials = credentials
|
173
184
|
config.quota_project = @quota_project_id
|
174
185
|
config.endpoint = @linting_service_stub.endpoint
|
175
186
|
config.universe_domain = @linting_service_stub.universe_domain
|
176
187
|
config.bindings_override = @config.bindings_override
|
188
|
+
config.logger = @linting_service_stub.logger if config.respond_to? :logger=
|
177
189
|
end
|
178
190
|
end
|
179
191
|
|
@@ -184,6 +196,15 @@ module Google
|
|
184
196
|
#
|
185
197
|
attr_reader :location_client
|
186
198
|
|
199
|
+
##
|
200
|
+
# The logger used for request/response debug logging.
|
201
|
+
#
|
202
|
+
# @return [Logger]
|
203
|
+
#
|
204
|
+
def logger
|
205
|
+
@linting_service_stub.logger
|
206
|
+
end
|
207
|
+
|
187
208
|
# Service calls
|
188
209
|
|
189
210
|
##
|
@@ -261,7 +282,6 @@ module Google
|
|
261
282
|
|
262
283
|
@linting_service_stub.get_style_guide request, options do |result, operation|
|
263
284
|
yield result, operation if block_given?
|
264
|
-
return result
|
265
285
|
end
|
266
286
|
rescue ::Gapic::Rest::Error => e
|
267
287
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -342,7 +362,6 @@ module Google
|
|
342
362
|
|
343
363
|
@linting_service_stub.update_style_guide request, options do |result, operation|
|
344
364
|
yield result, operation if block_given?
|
345
|
-
return result
|
346
365
|
end
|
347
366
|
rescue ::Gapic::Rest::Error => e
|
348
367
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -424,7 +443,6 @@ module Google
|
|
424
443
|
|
425
444
|
@linting_service_stub.get_style_guide_contents request, options do |result, operation|
|
426
445
|
yield result, operation if block_given?
|
427
|
-
return result
|
428
446
|
end
|
429
447
|
rescue ::Gapic::Rest::Error => e
|
430
448
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -507,7 +525,6 @@ module Google
|
|
507
525
|
|
508
526
|
@linting_service_stub.lint_spec request, options do |result, operation|
|
509
527
|
yield result, operation if block_given?
|
510
|
-
return result
|
511
528
|
end
|
512
529
|
rescue ::Gapic::Rest::Error => e
|
513
530
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -555,6 +572,13 @@ module Google
|
|
555
572
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
556
573
|
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
557
574
|
# * (`nil`) indicating no credentials
|
575
|
+
#
|
576
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
577
|
+
# external source for authentication to Google Cloud, you must validate it before
|
578
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
579
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
580
|
+
# For more information, refer to [Validate credential configurations from external
|
581
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
558
582
|
# @return [::Object]
|
559
583
|
# @!attribute [rw] scope
|
560
584
|
# The OAuth scopes
|
@@ -587,6 +611,11 @@ module Google
|
|
587
611
|
# default endpoint URL. The default value of nil uses the environment
|
588
612
|
# universe (usually the default "googleapis.com" universe).
|
589
613
|
# @return [::String,nil]
|
614
|
+
# @!attribute [rw] logger
|
615
|
+
# A custom logger to use for request/response debug logging, or the value
|
616
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
617
|
+
# explicitly disable logging.
|
618
|
+
# @return [::Logger,:default,nil]
|
590
619
|
#
|
591
620
|
class Configuration
|
592
621
|
extend ::Gapic::Config
|
@@ -615,6 +644,7 @@ module Google
|
|
615
644
|
# by the host service.
|
616
645
|
# @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
|
617
646
|
config_attr :bindings_override, {}, ::Hash, nil
|
647
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
618
648
|
|
619
649
|
# @private
|
620
650
|
def initialize parent_config = nil
|
@@ -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 get_style_guide 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: "get_style_guide",
|
93
106
|
options: options
|
94
107
|
)
|
95
108
|
operation = ::Gapic::Rest::TransportOperation.new response
|
96
109
|
result = ::Google::Cloud::ApiHub::V1::StyleGuide.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: "update_style_guide",
|
131
146
|
options: options
|
132
147
|
)
|
133
148
|
operation = ::Gapic::Rest::TransportOperation.new response
|
134
149
|
result = ::Google::Cloud::ApiHub::V1::StyleGuide.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: "get_style_guide_contents",
|
169
186
|
options: options
|
170
187
|
)
|
171
188
|
operation = ::Gapic::Rest::TransportOperation.new response
|
172
189
|
result = ::Google::Cloud::ApiHub::V1::StyleGuideContents.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: "lint_spec",
|
207
226
|
options: options
|
208
227
|
)
|
209
228
|
operation = ::Gapic::Rest::TransportOperation.new response
|
210
229
|
result = ::Google::Protobuf::Empty.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
|
##
|
@@ -170,15 +170,27 @@ module Google
|
|
170
170
|
endpoint: @config.endpoint,
|
171
171
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
172
172
|
universe_domain: @config.universe_domain,
|
173
|
-
credentials: credentials
|
173
|
+
credentials: credentials,
|
174
|
+
logger: @config.logger
|
174
175
|
)
|
175
176
|
|
177
|
+
@provisioning_stub.logger(stub: true)&.info do |entry|
|
178
|
+
entry.set_system_name
|
179
|
+
entry.set_service
|
180
|
+
entry.message = "Created client for #{entry.service}"
|
181
|
+
entry.set_credentials_fields credentials
|
182
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
183
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
184
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
185
|
+
end
|
186
|
+
|
176
187
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
177
188
|
config.credentials = credentials
|
178
189
|
config.quota_project = @quota_project_id
|
179
190
|
config.endpoint = @provisioning_stub.endpoint
|
180
191
|
config.universe_domain = @provisioning_stub.universe_domain
|
181
192
|
config.bindings_override = @config.bindings_override
|
193
|
+
config.logger = @provisioning_stub.logger if config.respond_to? :logger=
|
182
194
|
end
|
183
195
|
end
|
184
196
|
|
@@ -196,6 +208,15 @@ module Google
|
|
196
208
|
#
|
197
209
|
attr_reader :location_client
|
198
210
|
|
211
|
+
##
|
212
|
+
# The logger used for request/response debug logging.
|
213
|
+
#
|
214
|
+
# @return [Logger]
|
215
|
+
#
|
216
|
+
def logger
|
217
|
+
@provisioning_stub.logger
|
218
|
+
end
|
219
|
+
|
199
220
|
# Service calls
|
200
221
|
|
201
222
|
##
|
@@ -289,7 +310,7 @@ module Google
|
|
289
310
|
@provisioning_stub.create_api_hub_instance request, options do |result, operation|
|
290
311
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
291
312
|
yield result, operation if block_given?
|
292
|
-
|
313
|
+
throw :response, result
|
293
314
|
end
|
294
315
|
rescue ::Gapic::Rest::Error => e
|
295
316
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -370,7 +391,6 @@ module Google
|
|
370
391
|
|
371
392
|
@provisioning_stub.get_api_hub_instance request, options do |result, operation|
|
372
393
|
yield result, operation if block_given?
|
373
|
-
return result
|
374
394
|
end
|
375
395
|
rescue ::Gapic::Rest::Error => e
|
376
396
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -453,7 +473,6 @@ module Google
|
|
453
473
|
|
454
474
|
@provisioning_stub.lookup_api_hub_instance request, options do |result, operation|
|
455
475
|
yield result, operation if block_given?
|
456
|
-
return result
|
457
476
|
end
|
458
477
|
rescue ::Gapic::Rest::Error => e
|
459
478
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -501,6 +520,13 @@ module Google
|
|
501
520
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
502
521
|
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
503
522
|
# * (`nil`) indicating no credentials
|
523
|
+
#
|
524
|
+
# Warning: If you accept a credential configuration (JSON file or Hash) from an
|
525
|
+
# external source for authentication to Google Cloud, you must validate it before
|
526
|
+
# providing it to a Google API client library. Providing an unvalidated credential
|
527
|
+
# configuration to Google APIs can compromise the security of your systems and data.
|
528
|
+
# For more information, refer to [Validate credential configurations from external
|
529
|
+
# sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
|
504
530
|
# @return [::Object]
|
505
531
|
# @!attribute [rw] scope
|
506
532
|
# The OAuth scopes
|
@@ -533,6 +559,11 @@ module Google
|
|
533
559
|
# default endpoint URL. The default value of nil uses the environment
|
534
560
|
# universe (usually the default "googleapis.com" universe).
|
535
561
|
# @return [::String,nil]
|
562
|
+
# @!attribute [rw] logger
|
563
|
+
# A custom logger to use for request/response debug logging, or the value
|
564
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
565
|
+
# explicitly disable logging.
|
566
|
+
# @return [::Logger,:default,nil]
|
536
567
|
#
|
537
568
|
class Configuration
|
538
569
|
extend ::Gapic::Config
|
@@ -561,6 +592,7 @@ module Google
|
|
561
592
|
# by the host service.
|
562
593
|
# @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
|
563
594
|
config_attr :bindings_override, {}, ::Hash, nil
|
595
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
564
596
|
|
565
597
|
# @private
|
566
598
|
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
|
##
|