google-cloud-dataproc-v1 0.13.0 → 0.15.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 (31) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/dataproc/v1/autoscaling_policy_service.rb +1 -1
  4. data/lib/google/cloud/dataproc/v1/batch_controller.rb +1 -1
  5. data/lib/google/cloud/dataproc/v1/cluster_controller/client.rb +14 -12
  6. data/lib/google/cloud/dataproc/v1/cluster_controller/paths.rb +21 -0
  7. data/lib/google/cloud/dataproc/v1/cluster_controller.rb +1 -1
  8. data/lib/google/cloud/dataproc/v1/clusters_pb.rb +19 -0
  9. data/lib/google/cloud/dataproc/v1/clusters_services_pb.rb +2 -1
  10. data/lib/google/cloud/dataproc/v1/job_controller.rb +1 -1
  11. data/lib/google/cloud/dataproc/v1/jobs_pb.rb +6 -0
  12. data/lib/google/cloud/dataproc/v1/node_group_controller/client.rb +662 -0
  13. data/lib/google/cloud/dataproc/v1/node_group_controller/credentials.rb +51 -0
  14. data/lib/google/cloud/dataproc/v1/node_group_controller/operations.rb +770 -0
  15. data/lib/google/cloud/dataproc/v1/node_group_controller/paths.rb +73 -0
  16. data/lib/google/cloud/dataproc/v1/node_group_controller.rb +51 -0
  17. data/lib/google/cloud/dataproc/v1/node_groups_pb.rb +44 -0
  18. data/lib/google/cloud/dataproc/v1/node_groups_services_pb.rb +55 -0
  19. data/lib/google/cloud/dataproc/v1/operations_pb.rb +19 -0
  20. data/lib/google/cloud/dataproc/v1/version.rb +1 -1
  21. data/lib/google/cloud/dataproc/v1/workflow_template_service/paths.rb +21 -0
  22. data/lib/google/cloud/dataproc/v1/workflow_template_service.rb +1 -1
  23. data/lib/google/cloud/dataproc/v1.rb +3 -2
  24. data/proto_docs/google/api/client.rb +318 -0
  25. data/proto_docs/google/api/launch_stage.rb +71 -0
  26. data/proto_docs/google/cloud/dataproc/v1/clusters.rb +131 -46
  27. data/proto_docs/google/cloud/dataproc/v1/jobs.rb +33 -18
  28. data/proto_docs/google/cloud/dataproc/v1/node_groups.rb +115 -0
  29. data/proto_docs/google/cloud/dataproc/v1/operations.rb +57 -0
  30. data/proto_docs/google/rpc/status.rb +4 -2
  31. metadata +15 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8e75c2e5bee163cd428a8155406d32438bdeedaeec28b7710008ce7df4a7da25
4
- data.tar.gz: d5bd45a016c39f8b9d01ebcb4a93d6c4c1359ebba133b6c0b9c4a99fb73f6e92
3
+ metadata.gz: 845bd25567ac1183e380bc1a633116e1e211b0b8683673ae3a26bc4ea68dcfbd
4
+ data.tar.gz: 58c166d6d8e3727386eebacffac347b102a661179e12d37b3a3ac73f5903a350
5
5
  SHA512:
6
- metadata.gz: '0681451488f7689d38c141c2c3384250f6fc0fa791a855e1c87db4f61d7e7180cf3ab639fc7637c60837353bc4e0c1b3e1c67fed32078524f6c48c35f8b11528'
7
- data.tar.gz: 2d411b612573a8e075f67ac0544dc5358b6fd7a1be5f294560e9877b675affdb0c7c3848256faa462b5bf55d3e9755901d9eb57658707ae688af7acdc7b07a06
6
+ metadata.gz: c33304f5a779b7d54b74c08efe4c5388bc249c1b0be5ce535c925a2c2b0e5e293317d8d9bc077d1402ff392a455673cae0f559eb037fc831f9b46d0bfb1681ce
7
+ data.tar.gz: 3ae99ffbcd72427fcd1121502208525821f42003c040de76264e8923753fcb5bf0c22c1db7d897e662e45ca8d7722eeb01efdde2cd747c7133f3dd002083c405
data/README.md CHANGED
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -34,7 +34,7 @@ module Google
34
34
  # The API interface for managing autoscaling policies in the
35
35
  # Dataproc API.
36
36
  #
37
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
38
38
  #
39
39
  # require "google/cloud/dataproc/v1/autoscaling_policy_service"
40
40
  # client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new
@@ -34,7 +34,7 @@ module Google
34
34
  ##
35
35
  # The BatchController provides methods to manage batch workloads.
36
36
  #
37
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
38
38
  #
39
39
  # require "google/cloud/dataproc/v1/batch_controller"
40
40
  # client = ::Google::Cloud::Dataproc::V1::BatchController::Client.new
@@ -216,11 +216,12 @@ module Google
216
216
  # @param cluster [::Google::Cloud::Dataproc::V1::Cluster, ::Hash]
217
217
  # Required. The cluster to create.
218
218
  # @param request_id [::String]
219
- # Optional. A unique ID used to identify the request. If the server receives two
219
+ # Optional. A unique ID used to identify the request. If the server receives
220
+ # two
220
221
  # [CreateClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.CreateClusterRequest)s
221
222
  # with the same id, then the second request will be ignored and the
222
- # first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the backend
223
- # is returned.
223
+ # first {::Google::Longrunning::Operation google.longrunning.Operation} created
224
+ # and stored in the backend is returned.
224
225
  #
225
226
  # It is recommended to always set this value to a
226
227
  # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -309,7 +310,8 @@ module Google
309
310
  # Updates a cluster in a project. The returned
310
311
  # {::Google::Longrunning::Operation#metadata Operation.metadata} will be
311
312
  # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
312
- # The cluster must be in a {::Google::Cloud::Dataproc::V1::ClusterStatus::State `RUNNING`} state or an error
313
+ # The cluster must be in a
314
+ # {::Google::Cloud::Dataproc::V1::ClusterStatus::State `RUNNING`} state or an error
313
315
  # is returned.
314
316
  #
315
317
  # @overload update_cluster(request, options = nil)
@@ -403,8 +405,8 @@ module Google
403
405
  # receives two
404
406
  # [UpdateClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.UpdateClusterRequest)s
405
407
  # with the same id, then the second request will be ignored and the
406
- # first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
407
- # backend is returned.
408
+ # first {::Google::Longrunning::Operation google.longrunning.Operation} created
409
+ # and stored in the backend is returned.
408
410
  #
409
411
  # It is recommended to always set this value to a
410
412
  # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -523,8 +525,8 @@ module Google
523
525
  # receives two
524
526
  # [StopClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.StopClusterRequest)s
525
527
  # with the same id, then the second request will be ignored and the
526
- # first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
527
- # backend is returned.
528
+ # first {::Google::Longrunning::Operation google.longrunning.Operation} created
529
+ # and stored in the backend is returned.
528
530
  #
529
531
  # Recommendation: Set this value to a
530
532
  # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -643,8 +645,8 @@ module Google
643
645
  # receives two
644
646
  # [StartClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.StartClusterRequest)s
645
647
  # with the same id, then the second request will be ignored and the
646
- # first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
647
- # backend is returned.
648
+ # first {::Google::Longrunning::Operation google.longrunning.Operation} created
649
+ # and stored in the backend is returned.
648
650
  #
649
651
  # Recommendation: Set this value to a
650
652
  # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -765,8 +767,8 @@ module Google
765
767
  # receives two
766
768
  # [DeleteClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.DeleteClusterRequest)s
767
769
  # with the same id, then the second request will be ignored and the
768
- # first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
769
- # backend is returned.
770
+ # first {::Google::Longrunning::Operation google.longrunning.Operation} created
771
+ # and stored in the backend is returned.
770
772
  #
771
773
  # It is recommended to always set this value to a
772
774
  # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
@@ -24,6 +24,27 @@ module Google
24
24
  module ClusterController
25
25
  # Path helper methods for the ClusterController API.
26
26
  module Paths
27
+ ##
28
+ # Create a fully-qualified NodeGroup resource string.
29
+ #
30
+ # The resource will be in the following format:
31
+ #
32
+ # `projects/{project}/regions/{region}/clusters/{cluster}/nodeGroups/{node_group}`
33
+ #
34
+ # @param project [String]
35
+ # @param region [String]
36
+ # @param cluster [String]
37
+ # @param node_group [String]
38
+ #
39
+ # @return [::String]
40
+ def node_group_path project:, region:, cluster:, node_group:
41
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
42
+ raise ::ArgumentError, "region cannot contain /" if region.to_s.include? "/"
43
+ raise ::ArgumentError, "cluster cannot contain /" if cluster.to_s.include? "/"
44
+
45
+ "projects/#{project}/regions/#{region}/clusters/#{cluster}/nodeGroups/#{node_group}"
46
+ end
47
+
27
48
  ##
28
49
  # Create a fully-qualified Service resource string.
29
50
  #
@@ -35,7 +35,7 @@ module Google
35
35
  # The ClusterControllerService provides methods to manage clusters
36
36
  # of Compute Engine instances.
37
37
  #
38
- # To load this service and instantiate a client:
38
+ # @example Load this service and instantiate a gRPC client
39
39
  #
40
40
  # require "google/cloud/dataproc/v1/cluster_controller"
41
41
  # client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new
@@ -42,6 +42,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
42
42
  optional :endpoint_config, :message, 19, "google.cloud.dataproc.v1.EndpointConfig"
43
43
  optional :metastore_config, :message, 20, "google.cloud.dataproc.v1.MetastoreConfig"
44
44
  optional :dataproc_metric_config, :message, 23, "google.cloud.dataproc.v1.DataprocMetricConfig"
45
+ repeated :auxiliary_node_groups, :message, 25, "google.cloud.dataproc.v1.AuxiliaryNodeGroup"
45
46
  end
46
47
  add_message "google.cloud.dataproc.v1.VirtualClusterConfig" do
47
48
  optional :staging_bucket, :string, 1
@@ -112,6 +113,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
112
113
  value :PREEMPTIBILITY_UNSPECIFIED, 0
113
114
  value :NON_PREEMPTIBLE, 1
114
115
  value :PREEMPTIBLE, 2
116
+ value :SPOT, 3
115
117
  end
116
118
  add_message "google.cloud.dataproc.v1.ManagedGroupConfig" do
117
119
  optional :instance_template_name, :string, 1
@@ -127,6 +129,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
127
129
  optional :num_local_ssds, :int32, 2
128
130
  optional :local_ssd_interface, :string, 4
129
131
  end
132
+ add_message "google.cloud.dataproc.v1.AuxiliaryNodeGroup" do
133
+ optional :node_group, :message, 1, "google.cloud.dataproc.v1.NodeGroup"
134
+ optional :node_group_id, :string, 2
135
+ end
136
+ add_message "google.cloud.dataproc.v1.NodeGroup" do
137
+ optional :name, :string, 1
138
+ repeated :roles, :enum, 2, "google.cloud.dataproc.v1.NodeGroup.Role"
139
+ optional :node_group_config, :message, 3, "google.cloud.dataproc.v1.InstanceGroupConfig"
140
+ map :labels, :string, :string, 4
141
+ end
142
+ add_enum "google.cloud.dataproc.v1.NodeGroup.Role" do
143
+ value :ROLE_UNSPECIFIED, 0
144
+ value :DRIVER, 1
145
+ end
130
146
  add_message "google.cloud.dataproc.v1.NodeInitializationAction" do
131
147
  optional :executable_file, :string, 1
132
148
  optional :execution_timeout, :message, 2, "google.protobuf.Duration"
@@ -310,6 +326,9 @@ module Google
310
326
  ManagedGroupConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.ManagedGroupConfig").msgclass
311
327
  AcceleratorConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.AcceleratorConfig").msgclass
312
328
  DiskConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.DiskConfig").msgclass
329
+ AuxiliaryNodeGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.AuxiliaryNodeGroup").msgclass
330
+ NodeGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.NodeGroup").msgclass
331
+ NodeGroup::Role = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.NodeGroup.Role").enummodule
313
332
  NodeInitializationAction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.NodeInitializationAction").msgclass
314
333
  ClusterStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.ClusterStatus").msgclass
315
334
  ClusterStatus::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.ClusterStatus.State").enummodule
@@ -41,7 +41,8 @@ module Google
41
41
  # Updates a cluster in a project. The returned
42
42
  # [Operation.metadata][google.longrunning.Operation.metadata] will be
43
43
  # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
44
- # The cluster must be in a [`RUNNING`][google.cloud.dataproc.v1.ClusterStatus.State] state or an error
44
+ # The cluster must be in a
45
+ # [`RUNNING`][google.cloud.dataproc.v1.ClusterStatus.State] state or an error
45
46
  # is returned.
46
47
  rpc :UpdateCluster, ::Google::Cloud::Dataproc::V1::UpdateClusterRequest, ::Google::Longrunning::Operation
47
48
  # Stops a cluster in a project.
@@ -33,7 +33,7 @@ module Google
33
33
  ##
34
34
  # The JobController provides methods to manage jobs.
35
35
  #
36
- # To load this service and instantiate a client:
36
+ # @example Load this service and instantiate a gRPC client
37
37
  #
38
38
  # require "google/cloud/dataproc/v1/job_controller"
39
39
  # client = ::Google::Cloud::Dataproc::V1::JobController::Client.new
@@ -176,6 +176,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
176
176
  optional :scheduling, :message, 20, "google.cloud.dataproc.v1.JobScheduling"
177
177
  optional :job_uuid, :string, 22
178
178
  optional :done, :bool, 24
179
+ optional :driver_scheduling_config, :message, 27, "google.cloud.dataproc.v1.DriverSchedulingConfig"
179
180
  oneof :type_job do
180
181
  optional :hadoop_job, :message, 3, "google.cloud.dataproc.v1.HadoopJob"
181
182
  optional :spark_job, :message, 4, "google.cloud.dataproc.v1.SparkJob"
@@ -187,6 +188,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
187
188
  optional :presto_job, :message, 23, "google.cloud.dataproc.v1.PrestoJob"
188
189
  end
189
190
  end
191
+ add_message "google.cloud.dataproc.v1.DriverSchedulingConfig" do
192
+ optional :memory_mb, :int32, 1
193
+ optional :vcores, :int32, 2
194
+ end
190
195
  add_message "google.cloud.dataproc.v1.JobScheduling" do
191
196
  optional :max_failures_per_hour, :int32, 1
192
197
  optional :max_failures_total, :int32, 2
@@ -269,6 +274,7 @@ module Google
269
274
  YarnApplication = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.YarnApplication").msgclass
270
275
  YarnApplication::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.YarnApplication.State").enummodule
271
276
  Job = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.Job").msgclass
277
+ DriverSchedulingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.DriverSchedulingConfig").msgclass
272
278
  JobScheduling = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.JobScheduling").msgclass
273
279
  SubmitJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.SubmitJobRequest").msgclass
274
280
  JobMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.JobMetadata").msgclass