google-cloud-dataproc 0.1.0 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,40 @@
1
+ # Copyright 2018 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require "googleauth"
16
+
17
+ module Google
18
+ module Cloud
19
+ module Dataproc
20
+ module V1
21
+ class Credentials < Google::Auth::Credentials
22
+ SCOPE = [
23
+ "https://www.googleapis.com/auth/cloud-platform"
24
+ ].freeze
25
+ PATH_ENV_VARS = %w(DATAPROC_CREDENTIALS
26
+ DATAPROC_KEYFILE
27
+ GOOGLE_CLOUD_CREDENTIALS
28
+ GOOGLE_CLOUD_KEYFILE
29
+ GCLOUD_KEYFILE)
30
+ JSON_ENV_VARS = %w(DATAPROC_CREDENTIALS_JSON
31
+ DATAPROC_KEYFILE_JSON
32
+ GOOGLE_CLOUD_CREDENTIALS_JSON
33
+ GOOGLE_CLOUD_KEYFILE_JSON
34
+ GCLOUD_KEYFILE_JSON)
35
+ DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
36
+ end
37
+ end
38
+ end
39
+ end
40
+ end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -15,19 +15,6 @@
15
15
  module Google
16
16
  module Cloud
17
17
  module Dataproc
18
- ##
19
- # # Google Cloud Dataproc API Contents
20
- #
21
- # | Class | Description |
22
- # | ----- | ----------- |
23
- # | [ClusterControllerClient][] | Manages Hadoop-based clusters and jobs on Google Cloud Platform. |
24
- # | [JobControllerClient][] | Manages Hadoop-based clusters and jobs on Google Cloud Platform. |
25
- # | [Data Types][] | Data types for Google::Cloud::Dataproc::V1 |
26
- #
27
- # [ClusterControllerClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/clustercontrollerclient
28
- # [JobControllerClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/jobcontrollerclient
29
- # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/datatypes
30
- #
31
18
  module V1
32
19
  # Describes the identifying information, config, and status of
33
20
  # a cluster of Google Compute Engine instances.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -15,19 +15,6 @@
15
15
  module Google
16
16
  module Cloud
17
17
  module Dataproc
18
- ##
19
- # # Google Cloud Dataproc API Contents
20
- #
21
- # | Class | Description |
22
- # | ----- | ----------- |
23
- # | [ClusterControllerClient][] | Manages Hadoop-based clusters and jobs on Google Cloud Platform. |
24
- # | [JobControllerClient][] | Manages Hadoop-based clusters and jobs on Google Cloud Platform. |
25
- # | [Data Types][] | Data types for Google::Cloud::Dataproc::V1 |
26
- #
27
- # [ClusterControllerClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/clustercontrollerclient
28
- # [JobControllerClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/jobcontrollerclient
29
- # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-dataproc/latest/google/cloud/dataproc/v1/datatypes
30
- #
31
18
  module V1
32
19
  # The runtime logging config of the job.
33
20
  # @!attribute [rw] driver_log_levels
@@ -0,0 +1,92 @@
1
+ # Copyright 2018 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ module Google
16
+ module Longrunning
17
+ # This resource represents a long-running operation that is the result of a
18
+ # network API call.
19
+ # @!attribute [rw] name
20
+ # @return [String]
21
+ # The server-assigned name, which is only unique within the same service that
22
+ # originally returns it. If you use the default HTTP mapping, the
23
+ # +name+ should have the format of +operations/some/unique/name+.
24
+ # @!attribute [rw] metadata
25
+ # @return [Google::Protobuf::Any]
26
+ # Service-specific metadata associated with the operation. It typically
27
+ # contains progress information and common metadata such as create time.
28
+ # Some services might not provide such metadata. Any method that returns a
29
+ # long-running operation should document the metadata type, if any.
30
+ # @!attribute [rw] done
31
+ # @return [true, false]
32
+ # If the value is +false+, it means the operation is still in progress.
33
+ # If true, the operation is completed, and either +error+ or +response+ is
34
+ # available.
35
+ # @!attribute [rw] error
36
+ # @return [Google::Rpc::Status]
37
+ # The error result of the operation in case of failure or cancellation.
38
+ # @!attribute [rw] response
39
+ # @return [Google::Protobuf::Any]
40
+ # The normal response of the operation in case of success. If the original
41
+ # method returns no data on success, such as +Delete+, the response is
42
+ # +google.protobuf.Empty+. If the original method is standard
43
+ # +Get+/+Create+/+Update+, the response should be the resource. For other
44
+ # methods, the response should have the type +XxxResponse+, where +Xxx+
45
+ # is the original method name. For example, if the original method name
46
+ # is +TakeSnapshot()+, the inferred response type is
47
+ # +TakeSnapshotResponse+.
48
+ class Operation; end
49
+
50
+ # The request message for {Google::Longrunning::Operations::GetOperation Operations::GetOperation}.
51
+ # @!attribute [rw] name
52
+ # @return [String]
53
+ # The name of the operation resource.
54
+ class GetOperationRequest; end
55
+
56
+ # The request message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
57
+ # @!attribute [rw] name
58
+ # @return [String]
59
+ # The name of the operation collection.
60
+ # @!attribute [rw] filter
61
+ # @return [String]
62
+ # The standard list filter.
63
+ # @!attribute [rw] page_size
64
+ # @return [Integer]
65
+ # The standard list page size.
66
+ # @!attribute [rw] page_token
67
+ # @return [String]
68
+ # The standard list page token.
69
+ class ListOperationsRequest; end
70
+
71
+ # The response message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
72
+ # @!attribute [rw] operations
73
+ # @return [Array<Google::Longrunning::Operation>]
74
+ # A list of operations that matches the specified filter in the request.
75
+ # @!attribute [rw] next_page_token
76
+ # @return [String]
77
+ # The standard List next-page token.
78
+ class ListOperationsResponse; end
79
+
80
+ # The request message for {Google::Longrunning::Operations::CancelOperation Operations::CancelOperation}.
81
+ # @!attribute [rw] name
82
+ # @return [String]
83
+ # The name of the operation resource to be cancelled.
84
+ class CancelOperationRequest; end
85
+
86
+ # The request message for {Google::Longrunning::Operations::DeleteOperation Operations::DeleteOperation}.
87
+ # @!attribute [rw] name
88
+ # @return [String]
89
+ # The name of the operation resource to be deleted.
90
+ class DeleteOperationRequest; end
91
+ end
92
+ end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -12,19 +12,17 @@
12
12
  # See the License for the specific language governing permissions and
13
13
  # limitations under the License.
14
14
 
15
- require "googleauth"
16
-
17
15
  module Google
18
- module Cloud
19
- module Dataproc
20
- class Credentials < Google::Auth::Credentials
21
- SCOPE = [
22
- "https://www.googleapis.com/auth/cloud-platform"
23
- ].freeze
24
- PATH_ENV_VARS = %w(DATAPROC_KEYFILE GOOGLE_CLOUD_KEYFILE GCLOUD_KEYFILE)
25
- JSON_ENV_VARS = %w(DATAPROC_KEYFILE_JSON GOOGLE_CLOUD_KEYFILE_JSON GCLOUD_KEYFILE_JSON)
26
- DEFAULT_PATHS = ["~/.config/gcloud/application_default_credentials.json"]
27
- end
28
- end
16
+ module Protobuf
17
+ # A generic empty message that you can re-use to avoid defining duplicated
18
+ # empty messages in your APIs. A typical example is to use it as the request
19
+ # or the response type of an API method. For instance:
20
+ #
21
+ # service Foo {
22
+ # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
23
+ # }
24
+ #
25
+ # The JSON representation for +Empty+ is empty JSON object +{}+.
26
+ class Empty; end
29
27
  end
30
- end
28
+ end
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -17,7 +17,7 @@ module Google
17
17
  # rubocop:disable LineLength
18
18
 
19
19
  ##
20
- # # Ruby Client for Google Cloud Dataproc API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
20
+ # # Ruby Client for Google Cloud Dataproc API ([Beta](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
21
21
  #
22
22
  # [Google Cloud Dataproc API][Product Documentation]:
23
23
  # Manages Hadoop-based clusters and jobs on Google Cloud Platform.
@@ -29,7 +29,7 @@ module Google
29
29
  #
30
30
  # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
31
31
  # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
32
- # 3. [Enable the Google Cloud Dataproc API.](https://console.cloud.google.com/apis/api/dataproc)
32
+ # 3. [Enable the Google Cloud Dataproc API.](https://console.cloud.google.com/apis/library/dataproc.googleapis.com)
33
33
  # 4. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
34
34
  #
35
35
  # ### Installation
@@ -68,6 +68,31 @@ module Google
68
68
  #
69
69
  # [Product Documentation]: https://cloud.google.com/dataproc
70
70
  #
71
+ # ## Enabling Logging
72
+ #
73
+ # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
74
+ # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
75
+ # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
76
+ # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
77
+ # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
78
+ #
79
+ # Configuring a Ruby stdlib logger:
80
+ #
81
+ # ```ruby
82
+ # require "logger"
83
+ #
84
+ # module MyLogger
85
+ # LOGGER = Logger.new $stderr, level: Logger::WARN
86
+ # def logger
87
+ # LOGGER
88
+ # end
89
+ # end
90
+ #
91
+ # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
92
+ # module GRPC
93
+ # extend MyLogger
94
+ # end
95
+ # ```
71
96
  #
72
97
  module Dataproc
73
98
  module V1
@@ -1,4 +1,4 @@
1
- # Copyright 2017 Google LLC
1
+ # Copyright 2018 Google LLC
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
@@ -18,9 +18,6 @@
18
18
  # and updates to that file get reflected here through a refresh process.
19
19
  # For the short term, the refresh process will only be runnable by Google
20
20
  # engineers.
21
- #
22
- # The only allowed edits are to method and file documentation. A 3-way
23
- # merge preserves those additions if the generated source changes.
24
21
 
25
22
  require "json"
26
23
  require "pathname"
@@ -28,7 +25,7 @@ require "pathname"
28
25
  require "google/gax"
29
26
 
30
27
  require "google/cloud/dataproc/v1/jobs_pb"
31
- require "google/cloud/dataproc/credentials"
28
+ require "google/cloud/dataproc/v1/credentials"
32
29
 
33
30
  module Google
34
31
  module Cloud
@@ -47,6 +44,9 @@ module Google
47
44
  # The default port of the service.
48
45
  DEFAULT_SERVICE_PORT = 443
49
46
 
47
+ # The default set of gRPC interceptors.
48
+ GRPC_INTERCEPTORS = []
49
+
50
50
  DEFAULT_TIMEOUT = 30
51
51
 
52
52
  PAGE_DESCRIPTORS = {
@@ -89,11 +89,18 @@ module Google
89
89
  # or the specified config is missing data points.
90
90
  # @param timeout [Numeric]
91
91
  # The default timeout, in seconds, for calls made through this client.
92
+ # @param metadata [Hash]
93
+ # Default metadata to be sent with each request. This can be overridden on a per call basis.
94
+ # @param exception_transformer [Proc]
95
+ # An optional proc that intercepts any exceptions raised during an API call to inject
96
+ # custom error handling.
92
97
  def initialize \
93
98
  credentials: nil,
94
99
  scopes: ALL_SCOPES,
95
100
  client_config: {},
96
101
  timeout: DEFAULT_TIMEOUT,
102
+ metadata: nil,
103
+ exception_transformer: nil,
97
104
  lib_name: nil,
98
105
  lib_version: ""
99
106
  # These require statements are intentionally placed here to initialize
@@ -102,10 +109,10 @@ module Google
102
109
  require "google/gax/grpc"
103
110
  require "google/cloud/dataproc/v1/jobs_services_pb"
104
111
 
105
- credentials ||= Google::Cloud::Dataproc::Credentials.default
112
+ credentials ||= Google::Cloud::Dataproc::V1::Credentials.default
106
113
 
107
114
  if credentials.is_a?(String) || credentials.is_a?(Hash)
108
- updater_proc = Google::Cloud::Dataproc::Credentials.new(credentials).updater_proc
115
+ updater_proc = Google::Cloud::Dataproc::V1::Credentials.new(credentials).updater_proc
109
116
  end
110
117
  if credentials.is_a?(GRPC::Core::Channel)
111
118
  channel = credentials
@@ -129,6 +136,7 @@ module Google
129
136
  google_api_client.freeze
130
137
 
131
138
  headers = { :"x-goog-api-client" => google_api_client }
139
+ headers.merge!(metadata) unless metadata.nil?
132
140
  client_config_file = Pathname.new(__dir__).join(
133
141
  "job_controller_client_config.json"
134
142
  )
@@ -141,13 +149,14 @@ module Google
141
149
  timeout,
142
150
  page_descriptors: PAGE_DESCRIPTORS,
143
151
  errors: Google::Gax::Grpc::API_ERRORS,
144
- kwargs: headers
152
+ metadata: headers
145
153
  )
146
154
  end
147
155
 
148
156
  # Allow overriding the service path/port in subclasses.
149
157
  service_path = self.class::SERVICE_ADDRESS
150
158
  port = self.class::DEFAULT_SERVICE_PORT
159
+ interceptors = self.class::GRPC_INTERCEPTORS
151
160
  @job_controller_stub = Google::Gax::Grpc.create_stub(
152
161
  service_path,
153
162
  port,
@@ -155,32 +164,39 @@ module Google
155
164
  channel: channel,
156
165
  updater_proc: updater_proc,
157
166
  scopes: scopes,
167
+ interceptors: interceptors,
158
168
  &Google::Cloud::Dataproc::V1::JobController::Stub.method(:new)
159
169
  )
160
170
 
161
171
  @submit_job = Google::Gax.create_api_call(
162
172
  @job_controller_stub.method(:submit_job),
163
- defaults["submit_job"]
173
+ defaults["submit_job"],
174
+ exception_transformer: exception_transformer
164
175
  )
165
176
  @get_job = Google::Gax.create_api_call(
166
177
  @job_controller_stub.method(:get_job),
167
- defaults["get_job"]
178
+ defaults["get_job"],
179
+ exception_transformer: exception_transformer
168
180
  )
169
181
  @list_jobs = Google::Gax.create_api_call(
170
182
  @job_controller_stub.method(:list_jobs),
171
- defaults["list_jobs"]
183
+ defaults["list_jobs"],
184
+ exception_transformer: exception_transformer
172
185
  )
173
186
  @update_job = Google::Gax.create_api_call(
174
187
  @job_controller_stub.method(:update_job),
175
- defaults["update_job"]
188
+ defaults["update_job"],
189
+ exception_transformer: exception_transformer
176
190
  )
177
191
  @cancel_job = Google::Gax.create_api_call(
178
192
  @job_controller_stub.method(:cancel_job),
179
- defaults["cancel_job"]
193
+ defaults["cancel_job"],
194
+ exception_transformer: exception_transformer
180
195
  )
181
196
  @delete_job = Google::Gax.create_api_call(
182
197
  @job_controller_stub.method(:delete_job),
183
- defaults["delete_job"]
198
+ defaults["delete_job"],
199
+ exception_transformer: exception_transformer
184
200
  )
185
201
  end
186
202
 
@@ -200,14 +216,23 @@ module Google
200
216
  # @param options [Google::Gax::CallOptions]
201
217
  # Overrides the default settings for this call, e.g, timeout,
202
218
  # retries, etc.
219
+ # @yield [result, operation] Access the result along with the RPC operation
220
+ # @yieldparam result [Google::Cloud::Dataproc::V1::Job]
221
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
203
222
  # @return [Google::Cloud::Dataproc::V1::Job]
204
223
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
205
224
  # @example
206
- # require "google/cloud/dataproc/v1"
225
+ # require "google/cloud/dataproc"
226
+ #
227
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
207
228
  #
208
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
229
+ # # TODO: Initialize +project_id+:
209
230
  # project_id = ''
231
+ #
232
+ # # TODO: Initialize +region+:
210
233
  # region = ''
234
+ #
235
+ # # TODO: Initialize +job+:
211
236
  # job = {}
212
237
  # response = job_controller_client.submit_job(project_id, region, job)
213
238
 
@@ -215,14 +240,15 @@ module Google
215
240
  project_id,
216
241
  region,
217
242
  job,
218
- options: nil
243
+ options: nil,
244
+ &block
219
245
  req = {
220
246
  project_id: project_id,
221
247
  region: region,
222
248
  job: job
223
249
  }.delete_if { |_, v| v.nil? }
224
250
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::SubmitJobRequest)
225
- @submit_job.call(req, options)
251
+ @submit_job.call(req, options, &block)
226
252
  end
227
253
 
228
254
  # Gets the resource representation for a job in a project.
@@ -237,14 +263,23 @@ module Google
237
263
  # @param options [Google::Gax::CallOptions]
238
264
  # Overrides the default settings for this call, e.g, timeout,
239
265
  # retries, etc.
266
+ # @yield [result, operation] Access the result along with the RPC operation
267
+ # @yieldparam result [Google::Cloud::Dataproc::V1::Job]
268
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
240
269
  # @return [Google::Cloud::Dataproc::V1::Job]
241
270
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
242
271
  # @example
243
- # require "google/cloud/dataproc/v1"
272
+ # require "google/cloud/dataproc"
273
+ #
274
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
244
275
  #
245
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
276
+ # # TODO: Initialize +project_id+:
246
277
  # project_id = ''
278
+ #
279
+ # # TODO: Initialize +region+:
247
280
  # region = ''
281
+ #
282
+ # # TODO: Initialize +job_id+:
248
283
  # job_id = ''
249
284
  # response = job_controller_client.get_job(project_id, region, job_id)
250
285
 
@@ -252,14 +287,15 @@ module Google
252
287
  project_id,
253
288
  region,
254
289
  job_id,
255
- options: nil
290
+ options: nil,
291
+ &block
256
292
  req = {
257
293
  project_id: project_id,
258
294
  region: region,
259
295
  job_id: job_id
260
296
  }.delete_if { |_, v| v.nil? }
261
297
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::GetJobRequest)
262
- @get_job.call(req, options)
298
+ @get_job.call(req, options, &block)
263
299
  end
264
300
 
265
301
  # Lists regions/{region}/jobs in a project.
@@ -301,6 +337,9 @@ module Google
301
337
  # @param options [Google::Gax::CallOptions]
302
338
  # Overrides the default settings for this call, e.g, timeout,
303
339
  # retries, etc.
340
+ # @yield [result, operation] Access the result along with the RPC operation
341
+ # @yieldparam result [Google::Gax::PagedEnumerable<Google::Cloud::Dataproc::V1::Job>]
342
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
304
343
  # @return [Google::Gax::PagedEnumerable<Google::Cloud::Dataproc::V1::Job>]
305
344
  # An enumerable of Google::Cloud::Dataproc::V1::Job instances.
306
345
  # See Google::Gax::PagedEnumerable documentation for other
@@ -308,10 +347,14 @@ module Google
308
347
  # object.
309
348
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
310
349
  # @example
311
- # require "google/cloud/dataproc/v1"
350
+ # require "google/cloud/dataproc"
351
+ #
352
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
312
353
  #
313
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
354
+ # # TODO: Initialize +project_id+:
314
355
  # project_id = ''
356
+ #
357
+ # # TODO: Initialize +region+:
315
358
  # region = ''
316
359
  #
317
360
  # # Iterate over all results.
@@ -334,7 +377,8 @@ module Google
334
377
  cluster_name: nil,
335
378
  job_state_matcher: nil,
336
379
  filter: nil,
337
- options: nil
380
+ options: nil,
381
+ &block
338
382
  req = {
339
383
  project_id: project_id,
340
384
  region: region,
@@ -344,7 +388,7 @@ module Google
344
388
  filter: filter
345
389
  }.delete_if { |_, v| v.nil? }
346
390
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::ListJobsRequest)
347
- @list_jobs.call(req, options)
391
+ @list_jobs.call(req, options, &block)
348
392
  end
349
393
 
350
394
  # Updates a job in a project.
@@ -372,16 +416,29 @@ module Google
372
416
  # @param options [Google::Gax::CallOptions]
373
417
  # Overrides the default settings for this call, e.g, timeout,
374
418
  # retries, etc.
419
+ # @yield [result, operation] Access the result along with the RPC operation
420
+ # @yieldparam result [Google::Cloud::Dataproc::V1::Job]
421
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
375
422
  # @return [Google::Cloud::Dataproc::V1::Job]
376
423
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
377
424
  # @example
378
- # require "google/cloud/dataproc/v1"
425
+ # require "google/cloud/dataproc"
426
+ #
427
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
379
428
  #
380
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
429
+ # # TODO: Initialize +project_id+:
381
430
  # project_id = ''
431
+ #
432
+ # # TODO: Initialize +region+:
382
433
  # region = ''
434
+ #
435
+ # # TODO: Initialize +job_id+:
383
436
  # job_id = ''
437
+ #
438
+ # # TODO: Initialize +job+:
384
439
  # job = {}
440
+ #
441
+ # # TODO: Initialize +update_mask+:
385
442
  # update_mask = {}
386
443
  # response = job_controller_client.update_job(project_id, region, job_id, job, update_mask)
387
444
 
@@ -391,7 +448,8 @@ module Google
391
448
  job_id,
392
449
  job,
393
450
  update_mask,
394
- options: nil
451
+ options: nil,
452
+ &block
395
453
  req = {
396
454
  project_id: project_id,
397
455
  region: region,
@@ -400,7 +458,7 @@ module Google
400
458
  update_mask: update_mask
401
459
  }.delete_if { |_, v| v.nil? }
402
460
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::UpdateJobRequest)
403
- @update_job.call(req, options)
461
+ @update_job.call(req, options, &block)
404
462
  end
405
463
 
406
464
  # Starts a job cancellation request. To access the job resource
@@ -418,14 +476,23 @@ module Google
418
476
  # @param options [Google::Gax::CallOptions]
419
477
  # Overrides the default settings for this call, e.g, timeout,
420
478
  # retries, etc.
479
+ # @yield [result, operation] Access the result along with the RPC operation
480
+ # @yieldparam result [Google::Cloud::Dataproc::V1::Job]
481
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
421
482
  # @return [Google::Cloud::Dataproc::V1::Job]
422
483
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
423
484
  # @example
424
- # require "google/cloud/dataproc/v1"
485
+ # require "google/cloud/dataproc"
486
+ #
487
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
425
488
  #
426
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
489
+ # # TODO: Initialize +project_id+:
427
490
  # project_id = ''
491
+ #
492
+ # # TODO: Initialize +region+:
428
493
  # region = ''
494
+ #
495
+ # # TODO: Initialize +job_id+:
429
496
  # job_id = ''
430
497
  # response = job_controller_client.cancel_job(project_id, region, job_id)
431
498
 
@@ -433,14 +500,15 @@ module Google
433
500
  project_id,
434
501
  region,
435
502
  job_id,
436
- options: nil
503
+ options: nil,
504
+ &block
437
505
  req = {
438
506
  project_id: project_id,
439
507
  region: region,
440
508
  job_id: job_id
441
509
  }.delete_if { |_, v| v.nil? }
442
510
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::CancelJobRequest)
443
- @cancel_job.call(req, options)
511
+ @cancel_job.call(req, options, &block)
444
512
  end
445
513
 
446
514
  # Deletes the job from the project. If the job is active, the delete fails,
@@ -456,13 +524,22 @@ module Google
456
524
  # @param options [Google::Gax::CallOptions]
457
525
  # Overrides the default settings for this call, e.g, timeout,
458
526
  # retries, etc.
527
+ # @yield [result, operation] Access the result along with the RPC operation
528
+ # @yieldparam result []
529
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
459
530
  # @raise [Google::Gax::GaxError] if the RPC is aborted.
460
531
  # @example
461
- # require "google/cloud/dataproc/v1"
532
+ # require "google/cloud/dataproc"
533
+ #
534
+ # job_controller_client = Google::Cloud::Dataproc::JobController.new(version: :v1)
462
535
  #
463
- # job_controller_client = Google::Cloud::Dataproc::V1::JobController.new
536
+ # # TODO: Initialize +project_id+:
464
537
  # project_id = ''
538
+ #
539
+ # # TODO: Initialize +region+:
465
540
  # region = ''
541
+ #
542
+ # # TODO: Initialize +job_id+:
466
543
  # job_id = ''
467
544
  # job_controller_client.delete_job(project_id, region, job_id)
468
545
 
@@ -470,14 +547,15 @@ module Google
470
547
  project_id,
471
548
  region,
472
549
  job_id,
473
- options: nil
550
+ options: nil,
551
+ &block
474
552
  req = {
475
553
  project_id: project_id,
476
554
  region: region,
477
555
  job_id: job_id
478
556
  }.delete_if { |_, v| v.nil? }
479
557
  req = Google::Gax::to_proto(req, Google::Cloud::Dataproc::V1::DeleteJobRequest)
480
- @delete_job.call(req, options)
558
+ @delete_job.call(req, options, &block)
481
559
  nil
482
560
  end
483
561
  end