google-cloud-app_engine-v1 0.4.0 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
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,285 @@
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 Instances
26
+ module Rest
27
+ ##
28
+ # REST service stub for the Instances 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_instances REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::AppEngine::V1::ListInstancesRequest]
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::ListInstancesResponse]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::AppEngine::V1::ListInstancesResponse]
56
+ # A result object deserialized from the server's reply
57
+ def list_instances 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_instances_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::ListInstancesResponse.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 get_instance REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::AppEngine::V1::GetInstanceRequest]
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::Instance]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::AppEngine::V1::Instance]
94
+ # A result object deserialized from the server's reply
95
+ def get_instance 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_get_instance_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::Instance.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 delete_instance REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DeleteInstanceRequest]
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::Longrunning::Operation]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Longrunning::Operation]
132
+ # A result object deserialized from the server's reply
133
+ def delete_instance 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_delete_instance_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::Longrunning::Operation.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 debug_instance REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DebugInstanceRequest]
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::Longrunning::Operation]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Longrunning::Operation]
170
+ # A result object deserialized from the server's reply
171
+ def debug_instance 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_debug_instance_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::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # @private
197
+ #
198
+ # GRPC transcoding helper method for the list_instances REST call
199
+ #
200
+ # @param request_pb [::Google::Cloud::AppEngine::V1::ListInstancesRequest]
201
+ # A request object representing the call parameters. Required.
202
+ # @return [Array(String, [String, nil], Hash{String => String})]
203
+ # Uri, Body, Query string parameters
204
+ def self.transcode_list_instances_request request_pb
205
+ transcoder = Gapic::Rest::GrpcTranscoder.new
206
+ .with_bindings(
207
+ uri_method: :get,
208
+ uri_template: "/v1/{parent}/instances",
209
+ matches: [
210
+ ["parent", %r{^apps/[^/]+/services/[^/]+/versions/[^/]+/?$}, false]
211
+ ]
212
+ )
213
+ transcoder.transcode request_pb
214
+ end
215
+
216
+ ##
217
+ # @private
218
+ #
219
+ # GRPC transcoding helper method for the get_instance REST call
220
+ #
221
+ # @param request_pb [::Google::Cloud::AppEngine::V1::GetInstanceRequest]
222
+ # A request object representing the call parameters. Required.
223
+ # @return [Array(String, [String, nil], Hash{String => String})]
224
+ # Uri, Body, Query string parameters
225
+ def self.transcode_get_instance_request request_pb
226
+ transcoder = Gapic::Rest::GrpcTranscoder.new
227
+ .with_bindings(
228
+ uri_method: :get,
229
+ uri_template: "/v1/{name}",
230
+ matches: [
231
+ ["name", %r{^apps/[^/]+/services/[^/]+/versions/[^/]+/instances/[^/]+/?$}, false]
232
+ ]
233
+ )
234
+ transcoder.transcode request_pb
235
+ end
236
+
237
+ ##
238
+ # @private
239
+ #
240
+ # GRPC transcoding helper method for the delete_instance REST call
241
+ #
242
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DeleteInstanceRequest]
243
+ # A request object representing the call parameters. Required.
244
+ # @return [Array(String, [String, nil], Hash{String => String})]
245
+ # Uri, Body, Query string parameters
246
+ def self.transcode_delete_instance_request request_pb
247
+ transcoder = Gapic::Rest::GrpcTranscoder.new
248
+ .with_bindings(
249
+ uri_method: :delete,
250
+ uri_template: "/v1/{name}",
251
+ matches: [
252
+ ["name", %r{^apps/[^/]+/services/[^/]+/versions/[^/]+/instances/[^/]+/?$}, false]
253
+ ]
254
+ )
255
+ transcoder.transcode request_pb
256
+ end
257
+
258
+ ##
259
+ # @private
260
+ #
261
+ # GRPC transcoding helper method for the debug_instance REST call
262
+ #
263
+ # @param request_pb [::Google::Cloud::AppEngine::V1::DebugInstanceRequest]
264
+ # A request object representing the call parameters. Required.
265
+ # @return [Array(String, [String, nil], Hash{String => String})]
266
+ # Uri, Body, Query string parameters
267
+ def self.transcode_debug_instance_request request_pb
268
+ transcoder = Gapic::Rest::GrpcTranscoder.new
269
+ .with_bindings(
270
+ uri_method: :post,
271
+ uri_template: "/v1/{name}:debug",
272
+ body: "*",
273
+ matches: [
274
+ ["name", %r{^apps/[^/]+/services/[^/]+/versions/[^/]+/instances/[^/]+/?$}, false]
275
+ ]
276
+ )
277
+ transcoder.transcode request_pb
278
+ end
279
+ end
280
+ end
281
+ end
282
+ end
283
+ end
284
+ end
285
+ end
@@ -0,0 +1,52 @@
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/instances/credentials"
26
+ require "google/cloud/app_engine/v1/instances/rest/operations"
27
+ require "google/cloud/app_engine/v1/instances/rest/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module AppEngine
32
+ module V1
33
+ ##
34
+ # Manages instances of a version.
35
+ #
36
+ # To load this service and instantiate a REST client:
37
+ #
38
+ # require "google/cloud/app_engine/v1/instances/rest"
39
+ # client = ::Google::Cloud::AppEngine::V1::Instances::Rest::Client.new
40
+ #
41
+ module Instances
42
+ # Client for the REST transport
43
+ module Rest
44
+ end
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+
51
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
52
+ require "google/cloud/app_engine/v1/instances/rest/helpers" if ::File.file? helper_path
@@ -25,6 +25,7 @@ require "google/cloud/app_engine/v1/version"
25
25
  require "google/cloud/app_engine/v1/instances/credentials"
26
26
  require "google/cloud/app_engine/v1/instances/operations"
27
27
  require "google/cloud/app_engine/v1/instances/client"
28
+ require "google/cloud/app_engine/v1/instances/rest"
28
29
 
29
30
  module Google
30
31
  module Cloud
@@ -33,11 +34,16 @@ module Google
33
34
  ##
34
35
  # Manages instances of a version.
35
36
  #
36
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
37
38
  #
38
39
  # require "google/cloud/app_engine/v1/instances"
39
40
  # client = ::Google::Cloud::AppEngine::V1::Instances::Client.new
40
41
  #
42
+ # @example Load this service and instantiate a REST client
43
+ #
44
+ # require "google/cloud/app_engine/v1/instances/rest"
45
+ # client = ::Google::Cloud::AppEngine::V1::Instances::Rest::Client.new
46
+ #
41
47
  module Instances
42
48
  end
43
49
  end
@@ -0,0 +1,44 @@
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/cloud/app_engine/v1/applications/rest"
20
+ require "google/cloud/app_engine/v1/services/rest"
21
+ require "google/cloud/app_engine/v1/versions/rest"
22
+ require "google/cloud/app_engine/v1/instances/rest"
23
+ require "google/cloud/app_engine/v1/firewall/rest"
24
+ require "google/cloud/app_engine/v1/authorized_domains/rest"
25
+ require "google/cloud/app_engine/v1/authorized_certificates/rest"
26
+ require "google/cloud/app_engine/v1/domain_mappings/rest"
27
+ require "google/cloud/app_engine/v1/version"
28
+
29
+ module Google
30
+ module Cloud
31
+ module AppEngine
32
+ ##
33
+ # To load just the REST part of this package, including all its services, and instantiate a REST client:
34
+ #
35
+ # @example
36
+ #
37
+ # require "google/cloud/app_engine/v1/rest"
38
+ # client = ::Google::Cloud::AppEngine::V1::Applications::Rest::Client.new
39
+ #
40
+ module V1
41
+ end
42
+ end
43
+ end
44
+ end
@@ -200,13 +200,11 @@ module Google
200
200
  # # Call the list_services method.
201
201
  # result = client.list_services request
202
202
  #
203
- # # The returned object is of type Gapic::PagedEnumerable. You can
204
- # # iterate over all elements by calling #each, and the enumerable
205
- # # will lazily make API calls to fetch subsequent pages. Other
206
- # # methods are also available for managing paging directly.
207
- # result.each do |response|
203
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
204
+ # # over elements, and API calls will be issued to fetch pages as needed.
205
+ # result.each do |item|
208
206
  # # Each element is of type ::Google::Cloud::AppEngine::V1::Service.
209
- # p response
207
+ # p item
210
208
  # end
211
209
  #
212
210
  def list_services request, options = nil
@@ -395,14 +393,14 @@ module Google
395
393
  # # Call the update_service method.
396
394
  # result = client.update_service request
397
395
  #
398
- # # The returned object is of type Gapic::Operation. You can use this
399
- # # object to check the status of an operation, cancel it, or wait
400
- # # for results. Here is how to block until completion:
396
+ # # The returned object is of type Gapic::Operation. You can use it to
397
+ # # check the status of an operation, cancel it, or wait for results.
398
+ # # Here is how to wait for a response.
401
399
  # result.wait_until_done! timeout: 60
402
400
  # if result.response?
403
401
  # p result.response
404
402
  # else
405
- # puts "Error!"
403
+ # puts "No response received."
406
404
  # end
407
405
  #
408
406
  def update_service request, options = nil
@@ -488,14 +486,14 @@ module Google
488
486
  # # Call the delete_service method.
489
487
  # result = client.delete_service request
490
488
  #
491
- # # The returned object is of type Gapic::Operation. You can use this
492
- # # object to check the status of an operation, cancel it, or wait
493
- # # for results. Here is how to block until completion:
489
+ # # The returned object is of type Gapic::Operation. You can use it to
490
+ # # check the status of an operation, cancel it, or wait for results.
491
+ # # Here is how to wait for a response.
494
492
  # result.wait_until_done! timeout: 60
495
493
  # if result.response?
496
494
  # p result.response
497
495
  # else
498
- # puts "Error!"
496
+ # puts "No response received."
499
497
  # end
500
498
  #
501
499
  def delete_service 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