google-cloud-app_engine-v1 0.4.0 → 0.6.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.
Files changed (62) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +12 -7
  4. data/lib/google/appengine/v1/appengine_pb.rb +0 -1
  5. data/lib/google/cloud/app_engine/v1/applications/client.rb +12 -12
  6. data/lib/google/cloud/app_engine/v1/applications/operations.rb +15 -14
  7. data/lib/google/cloud/app_engine/v1/applications/rest/client.rb +589 -0
  8. data/lib/google/cloud/app_engine/v1/applications/rest/operations.rb +793 -0
  9. data/lib/google/cloud/app_engine/v1/applications/rest/service_stub.rb +285 -0
  10. data/lib/google/cloud/app_engine/v1/applications/rest.rb +52 -0
  11. data/lib/google/cloud/app_engine/v1/applications.rb +7 -1
  12. data/lib/google/cloud/app_engine/v1/authorized_certificates/client.rb +4 -6
  13. data/lib/google/cloud/app_engine/v1/authorized_certificates/rest/client.rb +643 -0
  14. data/lib/google/cloud/app_engine/v1/authorized_certificates/rest/service_stub.rb +345 -0
  15. data/lib/google/cloud/app_engine/v1/authorized_certificates/rest.rb +52 -0
  16. data/lib/google/cloud/app_engine/v1/authorized_certificates.rb +7 -1
  17. data/lib/google/cloud/app_engine/v1/authorized_domains/client.rb +4 -6
  18. data/lib/google/cloud/app_engine/v1/authorized_domains/rest/client.rb +349 -0
  19. data/lib/google/cloud/app_engine/v1/authorized_domains/rest/service_stub.rb +107 -0
  20. data/lib/google/cloud/app_engine/v1/authorized_domains/rest.rb +53 -0
  21. data/lib/google/cloud/app_engine/v1/authorized_domains.rb +7 -1
  22. data/lib/google/cloud/app_engine/v1/domain_mappings/client.rb +16 -18
  23. data/lib/google/cloud/app_engine/v1/domain_mappings/operations.rb +15 -14
  24. data/lib/google/cloud/app_engine/v1/domain_mappings/rest/client.rb +659 -0
  25. data/lib/google/cloud/app_engine/v1/domain_mappings/rest/operations.rb +793 -0
  26. data/lib/google/cloud/app_engine/v1/domain_mappings/rest/service_stub.rb +345 -0
  27. data/lib/google/cloud/app_engine/v1/domain_mappings/rest.rb +52 -0
  28. data/lib/google/cloud/app_engine/v1/domain_mappings.rb +7 -1
  29. data/lib/google/cloud/app_engine/v1/firewall/client.rb +4 -6
  30. data/lib/google/cloud/app_engine/v1/firewall/rest/client.rb +732 -0
  31. data/lib/google/cloud/app_engine/v1/firewall/rest/service_stub.rb +405 -0
  32. data/lib/google/cloud/app_engine/v1/firewall/rest.rb +60 -0
  33. data/lib/google/cloud/app_engine/v1/firewall.rb +7 -1
  34. data/lib/google/cloud/app_engine/v1/instances/client.rb +12 -14
  35. data/lib/google/cloud/app_engine/v1/instances/operations.rb +15 -14
  36. data/lib/google/cloud/app_engine/v1/instances/rest/client.rb +602 -0
  37. data/lib/google/cloud/app_engine/v1/instances/rest/operations.rb +793 -0
  38. data/lib/google/cloud/app_engine/v1/instances/rest/service_stub.rb +285 -0
  39. data/lib/google/cloud/app_engine/v1/instances/rest.rb +52 -0
  40. data/lib/google/cloud/app_engine/v1/instances.rb +7 -1
  41. data/lib/google/cloud/app_engine/v1/rest.rb +44 -0
  42. data/lib/google/cloud/app_engine/v1/services/client.rb +12 -14
  43. data/lib/google/cloud/app_engine/v1/services/operations.rb +15 -14
  44. data/lib/google/cloud/app_engine/v1/services/rest/client.rb +587 -0
  45. data/lib/google/cloud/app_engine/v1/services/rest/operations.rb +793 -0
  46. data/lib/google/cloud/app_engine/v1/services/rest/service_stub.rb +285 -0
  47. data/lib/google/cloud/app_engine/v1/services/rest.rb +52 -0
  48. data/lib/google/cloud/app_engine/v1/services.rb +7 -1
  49. data/lib/google/cloud/app_engine/v1/version.rb +1 -1
  50. data/lib/google/cloud/app_engine/v1/versions/client.rb +16 -18
  51. data/lib/google/cloud/app_engine/v1/versions/operations.rb +15 -14
  52. data/lib/google/cloud/app_engine/v1/versions/rest/client.rb +692 -0
  53. data/lib/google/cloud/app_engine/v1/versions/rest/operations.rb +793 -0
  54. data/lib/google/cloud/app_engine/v1/versions/rest/service_stub.rb +345 -0
  55. data/lib/google/cloud/app_engine/v1/versions/rest.rb +52 -0
  56. data/lib/google/cloud/app_engine/v1/versions.rb +7 -1
  57. data/lib/google/cloud/app_engine/v1.rb +7 -2
  58. data/proto_docs/google/api/client.rb +318 -0
  59. data/proto_docs/google/api/launch_stage.rb +71 -0
  60. data/proto_docs/google/protobuf/empty.rb +0 -2
  61. data/proto_docs/google/rpc/status.rb +4 -2
  62. metadata +45 -13
@@ -0,0 +1,405 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/appengine/v1/appengine_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module AppEngine
24
+ module V1
25
+ module Firewall
26
+ module Rest
27
+ ##
28
+ # REST service stub for the Firewall service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ def initialize endpoint:, credentials:
34
+ # These require statements are intentionally placed here to initialize
35
+ # the REST modules only when it's required.
36
+ require "gapic/rest"
37
+
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ numeric_enums: true,
40
+ raise_faraday_errors: false
41
+ end
42
+
43
+ ##
44
+ # Baseline implementation for the list_ingress_rules REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::AppEngine::V1::ListIngressRulesRequest]
47
+ # A request object representing the call parameters. Required.
48
+ # @param options [::Gapic::CallOptions]
49
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
50
+ #
51
+ # @yield [result, operation] Access the result along with the TransportOperation object
52
+ # @yieldparam result [::Google::Cloud::AppEngine::V1::ListIngressRulesResponse]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::AppEngine::V1::ListIngressRulesResponse]
56
+ # A result object deserialized from the server's reply
57
+ def list_ingress_rules request_pb, options = nil
58
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
59
+
60
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_ingress_rules_request request_pb
61
+ query_string_params = if query_string_params.any?
62
+ query_string_params.to_h { |p| p.split("=", 2) }
63
+ else
64
+ {}
65
+ end
66
+
67
+ response = @client_stub.make_http_request(
68
+ verb,
69
+ uri: uri,
70
+ body: body || "",
71
+ params: query_string_params,
72
+ options: options
73
+ )
74
+ operation = ::Gapic::Rest::TransportOperation.new response
75
+ result = ::Google::Cloud::AppEngine::V1::ListIngressRulesResponse.decode_json response.body, ignore_unknown_fields: true
76
+
77
+ yield result, operation if block_given?
78
+ result
79
+ end
80
+
81
+ ##
82
+ # Baseline implementation for the batch_update_ingress_rules REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::AppEngine::V1::BatchUpdateIngressRulesRequest]
85
+ # A request object representing the call parameters. Required.
86
+ # @param options [::Gapic::CallOptions]
87
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
88
+ #
89
+ # @yield [result, operation] Access the result along with the TransportOperation object
90
+ # @yieldparam result [::Google::Cloud::AppEngine::V1::BatchUpdateIngressRulesResponse]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::AppEngine::V1::BatchUpdateIngressRulesResponse]
94
+ # A result object deserialized from the server's reply
95
+ def batch_update_ingress_rules request_pb, options = nil
96
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
97
+
98
+ verb, uri, query_string_params, body = ServiceStub.transcode_batch_update_ingress_rules_request request_pb
99
+ query_string_params = if query_string_params.any?
100
+ query_string_params.to_h { |p| p.split("=", 2) }
101
+ else
102
+ {}
103
+ end
104
+
105
+ response = @client_stub.make_http_request(
106
+ verb,
107
+ uri: uri,
108
+ body: body || "",
109
+ params: query_string_params,
110
+ options: options
111
+ )
112
+ operation = ::Gapic::Rest::TransportOperation.new response
113
+ result = ::Google::Cloud::AppEngine::V1::BatchUpdateIngressRulesResponse.decode_json response.body, ignore_unknown_fields: true
114
+
115
+ yield result, operation if block_given?
116
+ result
117
+ end
118
+
119
+ ##
120
+ # Baseline implementation for the create_ingress_rule REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::AppEngine::V1::CreateIngressRuleRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @param options [::Gapic::CallOptions]
125
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
+ #
127
+ # @yield [result, operation] Access the result along with the TransportOperation object
128
+ # @yieldparam result [::Google::Cloud::AppEngine::V1::FirewallRule]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Cloud::AppEngine::V1::FirewallRule]
132
+ # A result object deserialized from the server's reply
133
+ def create_ingress_rule request_pb, options = nil
134
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
135
+
136
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_ingress_rule_request request_pb
137
+ query_string_params = if query_string_params.any?
138
+ query_string_params.to_h { |p| p.split("=", 2) }
139
+ else
140
+ {}
141
+ end
142
+
143
+ response = @client_stub.make_http_request(
144
+ verb,
145
+ uri: uri,
146
+ body: body || "",
147
+ params: query_string_params,
148
+ options: options
149
+ )
150
+ operation = ::Gapic::Rest::TransportOperation.new response
151
+ result = ::Google::Cloud::AppEngine::V1::FirewallRule.decode_json response.body, ignore_unknown_fields: true
152
+
153
+ yield result, operation if block_given?
154
+ result
155
+ end
156
+
157
+ ##
158
+ # Baseline implementation for the get_ingress_rule REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::AppEngine::V1::GetIngressRuleRequest]
161
+ # A request object representing the call parameters. Required.
162
+ # @param options [::Gapic::CallOptions]
163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
164
+ #
165
+ # @yield [result, operation] Access the result along with the TransportOperation object
166
+ # @yieldparam result [::Google::Cloud::AppEngine::V1::FirewallRule]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Cloud::AppEngine::V1::FirewallRule]
170
+ # A result object deserialized from the server's reply
171
+ def get_ingress_rule request_pb, options = nil
172
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
173
+
174
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_ingress_rule_request request_pb
175
+ query_string_params = if query_string_params.any?
176
+ query_string_params.to_h { |p| p.split("=", 2) }
177
+ else
178
+ {}
179
+ end
180
+
181
+ response = @client_stub.make_http_request(
182
+ verb,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Cloud::AppEngine::V1::FirewallRule.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # Baseline implementation for the update_ingress_rule REST call
197
+ #
198
+ # @param request_pb [::Google::Cloud::AppEngine::V1::UpdateIngressRuleRequest]
199
+ # A request object representing the call parameters. Required.
200
+ # @param options [::Gapic::CallOptions]
201
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
202
+ #
203
+ # @yield [result, operation] Access the result along with the TransportOperation object
204
+ # @yieldparam result [::Google::Cloud::AppEngine::V1::FirewallRule]
205
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
206
+ #
207
+ # @return [::Google::Cloud::AppEngine::V1::FirewallRule]
208
+ # A result object deserialized from the server's reply
209
+ def update_ingress_rule request_pb, options = nil
210
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
211
+
212
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_ingress_rule_request request_pb
213
+ query_string_params = if query_string_params.any?
214
+ query_string_params.to_h { |p| p.split("=", 2) }
215
+ else
216
+ {}
217
+ end
218
+
219
+ response = @client_stub.make_http_request(
220
+ verb,
221
+ uri: uri,
222
+ body: body || "",
223
+ params: query_string_params,
224
+ options: options
225
+ )
226
+ operation = ::Gapic::Rest::TransportOperation.new response
227
+ result = ::Google::Cloud::AppEngine::V1::FirewallRule.decode_json response.body, ignore_unknown_fields: true
228
+
229
+ yield result, operation if block_given?
230
+ result
231
+ end
232
+
233
+ ##
234
+ # Baseline implementation for the delete_ingress_rule REST call
235
+ #
236
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DeleteIngressRuleRequest]
237
+ # A request object representing the call parameters. Required.
238
+ # @param options [::Gapic::CallOptions]
239
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
240
+ #
241
+ # @yield [result, operation] Access the result along with the TransportOperation object
242
+ # @yieldparam result [::Google::Protobuf::Empty]
243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
244
+ #
245
+ # @return [::Google::Protobuf::Empty]
246
+ # A result object deserialized from the server's reply
247
+ def delete_ingress_rule request_pb, options = nil
248
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
249
+
250
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_ingress_rule_request request_pb
251
+ query_string_params = if query_string_params.any?
252
+ query_string_params.to_h { |p| p.split("=", 2) }
253
+ else
254
+ {}
255
+ end
256
+
257
+ response = @client_stub.make_http_request(
258
+ verb,
259
+ uri: uri,
260
+ body: body || "",
261
+ params: query_string_params,
262
+ options: options
263
+ )
264
+ operation = ::Gapic::Rest::TransportOperation.new response
265
+ result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
266
+
267
+ yield result, operation if block_given?
268
+ result
269
+ end
270
+
271
+ ##
272
+ # @private
273
+ #
274
+ # GRPC transcoding helper method for the list_ingress_rules REST call
275
+ #
276
+ # @param request_pb [::Google::Cloud::AppEngine::V1::ListIngressRulesRequest]
277
+ # A request object representing the call parameters. Required.
278
+ # @return [Array(String, [String, nil], Hash{String => String})]
279
+ # Uri, Body, Query string parameters
280
+ def self.transcode_list_ingress_rules_request request_pb
281
+ transcoder = Gapic::Rest::GrpcTranscoder.new
282
+ .with_bindings(
283
+ uri_method: :get,
284
+ uri_template: "/v1/{parent}/firewall/ingressRules",
285
+ matches: [
286
+ ["parent", %r{^apps/[^/]+/?$}, false]
287
+ ]
288
+ )
289
+ transcoder.transcode request_pb
290
+ end
291
+
292
+ ##
293
+ # @private
294
+ #
295
+ # GRPC transcoding helper method for the batch_update_ingress_rules REST call
296
+ #
297
+ # @param request_pb [::Google::Cloud::AppEngine::V1::BatchUpdateIngressRulesRequest]
298
+ # A request object representing the call parameters. Required.
299
+ # @return [Array(String, [String, nil], Hash{String => String})]
300
+ # Uri, Body, Query string parameters
301
+ def self.transcode_batch_update_ingress_rules_request request_pb
302
+ transcoder = Gapic::Rest::GrpcTranscoder.new
303
+ .with_bindings(
304
+ uri_method: :post,
305
+ uri_template: "/v1/{name}:batchUpdate",
306
+ body: "*",
307
+ matches: [
308
+ ["name", %r{^apps/[^/]+/firewall/ingressRules/?$}, false]
309
+ ]
310
+ )
311
+ transcoder.transcode request_pb
312
+ end
313
+
314
+ ##
315
+ # @private
316
+ #
317
+ # GRPC transcoding helper method for the create_ingress_rule REST call
318
+ #
319
+ # @param request_pb [::Google::Cloud::AppEngine::V1::CreateIngressRuleRequest]
320
+ # A request object representing the call parameters. Required.
321
+ # @return [Array(String, [String, nil], Hash{String => String})]
322
+ # Uri, Body, Query string parameters
323
+ def self.transcode_create_ingress_rule_request request_pb
324
+ transcoder = Gapic::Rest::GrpcTranscoder.new
325
+ .with_bindings(
326
+ uri_method: :post,
327
+ uri_template: "/v1/{parent}/firewall/ingressRules",
328
+ body: "rule",
329
+ matches: [
330
+ ["parent", %r{^apps/[^/]+/?$}, false]
331
+ ]
332
+ )
333
+ transcoder.transcode request_pb
334
+ end
335
+
336
+ ##
337
+ # @private
338
+ #
339
+ # GRPC transcoding helper method for the get_ingress_rule REST call
340
+ #
341
+ # @param request_pb [::Google::Cloud::AppEngine::V1::GetIngressRuleRequest]
342
+ # A request object representing the call parameters. Required.
343
+ # @return [Array(String, [String, nil], Hash{String => String})]
344
+ # Uri, Body, Query string parameters
345
+ def self.transcode_get_ingress_rule_request request_pb
346
+ transcoder = Gapic::Rest::GrpcTranscoder.new
347
+ .with_bindings(
348
+ uri_method: :get,
349
+ uri_template: "/v1/{name}",
350
+ matches: [
351
+ ["name", %r{^apps/[^/]+/firewall/ingressRules/[^/]+/?$}, false]
352
+ ]
353
+ )
354
+ transcoder.transcode request_pb
355
+ end
356
+
357
+ ##
358
+ # @private
359
+ #
360
+ # GRPC transcoding helper method for the update_ingress_rule REST call
361
+ #
362
+ # @param request_pb [::Google::Cloud::AppEngine::V1::UpdateIngressRuleRequest]
363
+ # A request object representing the call parameters. Required.
364
+ # @return [Array(String, [String, nil], Hash{String => String})]
365
+ # Uri, Body, Query string parameters
366
+ def self.transcode_update_ingress_rule_request request_pb
367
+ transcoder = Gapic::Rest::GrpcTranscoder.new
368
+ .with_bindings(
369
+ uri_method: :patch,
370
+ uri_template: "/v1/{name}",
371
+ body: "rule",
372
+ matches: [
373
+ ["name", %r{^apps/[^/]+/firewall/ingressRules/[^/]+/?$}, false]
374
+ ]
375
+ )
376
+ transcoder.transcode request_pb
377
+ end
378
+
379
+ ##
380
+ # @private
381
+ #
382
+ # GRPC transcoding helper method for the delete_ingress_rule REST call
383
+ #
384
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DeleteIngressRuleRequest]
385
+ # A request object representing the call parameters. Required.
386
+ # @return [Array(String, [String, nil], Hash{String => String})]
387
+ # Uri, Body, Query string parameters
388
+ def self.transcode_delete_ingress_rule_request request_pb
389
+ transcoder = Gapic::Rest::GrpcTranscoder.new
390
+ .with_bindings(
391
+ uri_method: :delete,
392
+ uri_template: "/v1/{name}",
393
+ matches: [
394
+ ["name", %r{^apps/[^/]+/firewall/ingressRules/[^/]+/?$}, false]
395
+ ]
396
+ )
397
+ transcoder.transcode request_pb
398
+ end
399
+ end
400
+ end
401
+ end
402
+ end
403
+ end
404
+ end
405
+ end
@@ -0,0 +1,60 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/app_engine/v1/version"
24
+
25
+ require "google/cloud/app_engine/v1/firewall/credentials"
26
+ require "google/cloud/app_engine/v1/firewall/rest/client"
27
+
28
+ module Google
29
+ module Cloud
30
+ module AppEngine
31
+ module V1
32
+ ##
33
+ # Firewall resources are used to define a collection of access control rules
34
+ # for an Application. Each rule is defined with a position which specifies
35
+ # the rule's order in the sequence of rules, an IP range to be matched against
36
+ # requests, and an action to take upon matching requests.
37
+ #
38
+ # Every request is evaluated against the Firewall rules in priority order.
39
+ # Processesing stops at the first rule which matches the request's IP address.
40
+ # A final rule always specifies an action that applies to all remaining
41
+ # IP addresses. The default final rule for a newly-created application will be
42
+ # set to "allow" if not otherwise specified by the user.
43
+ #
44
+ # To load this service and instantiate a REST client:
45
+ #
46
+ # require "google/cloud/app_engine/v1/firewall/rest"
47
+ # client = ::Google::Cloud::AppEngine::V1::Firewall::Rest::Client.new
48
+ #
49
+ module Firewall
50
+ # Client for the REST transport
51
+ module Rest
52
+ end
53
+ end
54
+ end
55
+ end
56
+ end
57
+ end
58
+
59
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
60
+ require "google/cloud/app_engine/v1/firewall/rest/helpers" if ::File.file? helper_path
@@ -24,6 +24,7 @@ require "google/cloud/app_engine/v1/version"
24
24
 
25
25
  require "google/cloud/app_engine/v1/firewall/credentials"
26
26
  require "google/cloud/app_engine/v1/firewall/client"
27
+ require "google/cloud/app_engine/v1/firewall/rest"
27
28
 
28
29
  module Google
29
30
  module Cloud
@@ -41,11 +42,16 @@ module Google
41
42
  # IP addresses. The default final rule for a newly-created application will be
42
43
  # set to "allow" if not otherwise specified by the user.
43
44
  #
44
- # To load this service and instantiate a client:
45
+ # @example Load this service and instantiate a gRPC client
45
46
  #
46
47
  # require "google/cloud/app_engine/v1/firewall"
47
48
  # client = ::Google::Cloud::AppEngine::V1::Firewall::Client.new
48
49
  #
50
+ # @example Load this service and instantiate a REST client
51
+ #
52
+ # require "google/cloud/app_engine/v1/firewall/rest"
53
+ # client = ::Google::Cloud::AppEngine::V1::Firewall::Rest::Client.new
54
+ #
49
55
  module Firewall
50
56
  end
51
57
  end
@@ -204,13 +204,11 @@ module Google
204
204
  # # Call the list_instances method.
205
205
  # result = client.list_instances request
206
206
  #
207
- # # The returned object is of type Gapic::PagedEnumerable. You can
208
- # # iterate over all elements by calling #each, and the enumerable
209
- # # will lazily make API calls to fetch subsequent pages. Other
210
- # # methods are also available for managing paging directly.
211
- # result.each do |response|
207
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
208
+ # # over elements, and API calls will be issued to fetch pages as needed.
209
+ # result.each do |item|
212
210
  # # Each element is of type ::Google::Cloud::AppEngine::V1::Instance.
213
- # p response
211
+ # p item
214
212
  # end
215
213
  #
216
214
  def list_instances request, options = nil
@@ -394,14 +392,14 @@ module Google
394
392
  # # Call the delete_instance method.
395
393
  # result = client.delete_instance request
396
394
  #
397
- # # The returned object is of type Gapic::Operation. You can use this
398
- # # object to check the status of an operation, cancel it, or wait
399
- # # for results. Here is how to block until completion:
395
+ # # The returned object is of type Gapic::Operation. You can use it to
396
+ # # check the status of an operation, cancel it, or wait for results.
397
+ # # Here is how to wait for a response.
400
398
  # result.wait_until_done! timeout: 60
401
399
  # if result.response?
402
400
  # p result.response
403
401
  # else
404
- # puts "Error!"
402
+ # puts "No response received."
405
403
  # end
406
404
  #
407
405
  def delete_instance request, options = nil
@@ -503,14 +501,14 @@ module Google
503
501
  # # Call the debug_instance method.
504
502
  # result = client.debug_instance request
505
503
  #
506
- # # The returned object is of type Gapic::Operation. You can use this
507
- # # object to check the status of an operation, cancel it, or wait
508
- # # for results. Here is how to block until completion:
504
+ # # The returned object is of type Gapic::Operation. You can use it to
505
+ # # check the status of an operation, cancel it, or wait for results.
506
+ # # Here is how to wait for a response.
509
507
  # result.wait_until_done! timeout: 60
510
508
  # if result.response?
511
509
  # p result.response
512
510
  # else
513
- # puts "Error!"
511
+ # puts "No response received."
514
512
  # end
515
513
  #
516
514
  def debug_instance request, options = nil
@@ -95,6 +95,9 @@ module Google
95
95
  channel_args: @config.channel_args,
96
96
  interceptors: @config.interceptors
97
97
  )
98
+
99
+ # Used by an LRO wrapper for some methods of this service
100
+ @operations_client = self
98
101
  end
99
102
 
100
103
  # Service calls
@@ -155,13 +158,11 @@ module Google
155
158
  # # Call the list_operations method.
156
159
  # result = client.list_operations request
157
160
  #
158
- # # The returned object is of type Gapic::PagedEnumerable. You can
159
- # # iterate over all elements by calling #each, and the enumerable
160
- # # will lazily make API calls to fetch subsequent pages. Other
161
- # # methods are also available for managing paging directly.
162
- # result.each do |response|
161
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
162
+ # # over elements, and API calls will be issued to fetch pages as needed.
163
+ # result.each do |item|
163
164
  # # Each element is of type ::Google::Longrunning::Operation.
164
- # p response
165
+ # p item
165
166
  # end
166
167
  #
167
168
  def list_operations request, options = nil
@@ -250,14 +251,14 @@ module Google
250
251
  # # Call the get_operation method.
251
252
  # result = client.get_operation request
252
253
  #
253
- # # The returned object is of type Gapic::Operation. You can use this
254
- # # object to check the status of an operation, cancel it, or wait
255
- # # for results. Here is how to block until completion:
254
+ # # The returned object is of type Gapic::Operation. You can use it to
255
+ # # check the status of an operation, cancel it, or wait for results.
256
+ # # Here is how to wait for a response.
256
257
  # result.wait_until_done! timeout: 60
257
258
  # if result.response?
258
259
  # p result.response
259
260
  # else
260
- # puts "Error!"
261
+ # puts "No response received."
261
262
  # end
262
263
  #
263
264
  def get_operation request, options = nil
@@ -537,14 +538,14 @@ module Google
537
538
  # # Call the wait_operation method.
538
539
  # result = client.wait_operation request
539
540
  #
540
- # # The returned object is of type Gapic::Operation. You can use this
541
- # # object to check the status of an operation, cancel it, or wait
542
- # # for results. Here is how to block until completion:
541
+ # # The returned object is of type Gapic::Operation. You can use it to
542
+ # # check the status of an operation, cancel it, or wait for results.
543
+ # # Here is how to wait for a response.
543
544
  # result.wait_until_done! timeout: 60
544
545
  # if result.response?
545
546
  # p result.response
546
547
  # else
547
- # puts "Error!"
548
+ # puts "No response received."
548
549
  # end
549
550
  #
550
551
  def wait_operation request, options = nil