google-cloud-dataproc-v1 0.3.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 (34) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE.md +188 -190
  3. data/README.md +66 -2
  4. data/lib/google/cloud/dataproc/v1.rb +3 -0
  5. data/lib/google/cloud/dataproc/v1/autoscaling_policies_services_pb.rb +5 -5
  6. data/lib/google/cloud/dataproc/v1/autoscaling_policy_service/client.rb +26 -20
  7. data/lib/google/cloud/dataproc/v1/autoscaling_policy_service/paths.rb +1 -1
  8. data/lib/google/cloud/dataproc/v1/cluster_controller.rb +1 -0
  9. data/lib/google/cloud/dataproc/v1/cluster_controller/client.rb +251 -47
  10. data/lib/google/cloud/dataproc/v1/cluster_controller/operations.rb +96 -11
  11. data/lib/google/cloud/dataproc/v1/cluster_controller/paths.rb +71 -0
  12. data/lib/google/cloud/dataproc/v1/clusters_pb.rb +60 -0
  13. data/lib/google/cloud/dataproc/v1/clusters_services_pb.rb +10 -6
  14. data/lib/google/cloud/dataproc/v1/job_controller/client.rb +57 -49
  15. data/lib/google/cloud/dataproc/v1/job_controller/operations.rb +96 -11
  16. data/lib/google/cloud/dataproc/v1/jobs_pb.rb +2 -0
  17. data/lib/google/cloud/dataproc/v1/jobs_services_pb.rb +7 -7
  18. data/lib/google/cloud/dataproc/v1/shared_pb.rb +7 -0
  19. data/lib/google/cloud/dataproc/v1/version.rb +1 -1
  20. data/lib/google/cloud/dataproc/v1/workflow_template_service/client.rb +43 -36
  21. data/lib/google/cloud/dataproc/v1/workflow_template_service/operations.rb +96 -11
  22. data/lib/google/cloud/dataproc/v1/workflow_template_service/paths.rb +39 -1
  23. data/lib/google/cloud/dataproc/v1/workflow_templates_pb.rb +5 -0
  24. data/lib/google/cloud/dataproc/v1/workflow_templates_services_pb.rb +9 -8
  25. data/proto_docs/google/api/field_behavior.rb +6 -0
  26. data/proto_docs/google/api/resource.rb +50 -14
  27. data/proto_docs/google/cloud/dataproc/v1/clusters.rb +240 -16
  28. data/proto_docs/google/cloud/dataproc/v1/jobs.rb +29 -10
  29. data/proto_docs/google/cloud/dataproc/v1/shared.rb +24 -1
  30. data/proto_docs/google/cloud/dataproc/v1/workflow_templates.rb +34 -7
  31. data/proto_docs/google/longrunning/operations.rb +17 -3
  32. data/proto_docs/google/protobuf/any.rb +5 -2
  33. data/proto_docs/google/protobuf/timestamp.rb +10 -1
  34. metadata +13 -9
@@ -239,9 +239,9 @@ module Google
239
239
  # A list of queries to run on a cluster.
240
240
  # @!attribute [rw] queries
241
241
  # @return [::Array<::String>]
242
- # Required. The queries to execute. You do not need to terminate a query
243
- # with a semicolon. Multiple queries can be specified in one string
244
- # by separating each with a semicolon. Here is an example of an Cloud
242
+ # Required. The queries to execute. You do not need to end a query expression
243
+ # with a semicolon. Multiple queries can be specified in one
244
+ # string by separating each with a semicolon. Here is an example of a
245
245
  # Dataproc API snippet that uses a QueryList to specify a HiveJob:
246
246
  #
247
247
  # "hiveJob": {
@@ -505,9 +505,22 @@ module Google
505
505
  # @return [::String]
506
506
  # Output only. A cluster UUID generated by the Dataproc service when
507
507
  # the job is submitted.
508
+ # @!attribute [rw] cluster_labels
509
+ # @return [::Google::Protobuf::Map{::String => ::String}]
510
+ # Optional. Cluster labels to identify a cluster where the job will be
511
+ # submitted.
508
512
  class JobPlacement
509
513
  include ::Google::Protobuf::MessageExts
510
514
  extend ::Google::Protobuf::MessageExts::ClassMethods
515
+
516
+ # @!attribute [rw] key
517
+ # @return [::String]
518
+ # @!attribute [rw] value
519
+ # @return [::String]
520
+ class ClusterLabelsEntry
521
+ include ::Google::Protobuf::MessageExts
522
+ extend ::Google::Protobuf::MessageExts::ClassMethods
523
+ end
511
524
  end
512
525
 
513
526
  # Dataproc job status.
@@ -596,8 +609,8 @@ module Google
596
609
  # Encapsulates the full scoping used to reference a job.
597
610
  # @!attribute [rw] project_id
598
611
  # @return [::String]
599
- # Optional. The ID of the Google Cloud Platform project that the job belongs to. If
600
- # specified, must match the request project ID.
612
+ # Optional. The ID of the Google Cloud Platform project that the job belongs
613
+ # to. If specified, must match the request project ID.
601
614
  # @!attribute [rw] job_id
602
615
  # @return [::String]
603
616
  # Optional. The job ID, which must be unique within the project.
@@ -744,8 +757,8 @@ module Google
744
757
  # may be reused over time.
745
758
  # @!attribute [r] done
746
759
  # @return [::Boolean]
747
- # Output only. Indicates whether the job is completed. If the value is `false`,
748
- # the job is still in progress. If `true`, the job is completed, and
760
+ # Output only. Indicates whether the job is completed. If the value is
761
+ # `false`, the job is still in progress. If `true`, the job is completed, and
749
762
  # `status.state` field will indicate if it was successful, failed,
750
763
  # or cancelled.
751
764
  class Job
@@ -766,13 +779,18 @@ module Google
766
779
  # @!attribute [rw] max_failures_per_hour
767
780
  # @return [::Integer]
768
781
  # Optional. Maximum number of times per hour a driver may be restarted as
769
- # a result of driver terminating with non-zero code before job is
782
+ # a result of driver exiting with non-zero code before job is
770
783
  # reported failed.
771
784
  #
772
785
  # A job may be reported as thrashing if driver exits with non-zero code
773
786
  # 4 times within 10 minute window.
774
787
  #
775
788
  # Maximum value is 10.
789
+ # @!attribute [rw] max_failures_total
790
+ # @return [::Integer]
791
+ # Optional. Maximum number of times in total a driver may be restarted as a
792
+ # result of driver exiting with non-zero code before job is reported failed.
793
+ # Maximum value is 240.
776
794
  class JobScheduling
777
795
  include ::Google::Protobuf::MessageExts
778
796
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -792,8 +810,9 @@ module Google
792
810
  # @!attribute [rw] request_id
793
811
  # @return [::String]
794
812
  # Optional. A unique id used to identify the request. If the server
795
- # receives two {::Google::Cloud::Dataproc::V1::SubmitJobRequest SubmitJobRequest} requests with the same
796
- # id, then the second request will be ignored and the
813
+ # receives two
814
+ # [SubmitJobRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.SubmitJobRequest)s
815
+ # with the same id, then the second request will be ignored and the
797
816
  # first {::Google::Cloud::Dataproc::V1::Job Job} created and stored in the backend
798
817
  # is returned.
799
818
  #
@@ -22,13 +22,30 @@ module Google
22
22
  module Dataproc
23
23
  module V1
24
24
  # Cluster components that can be activated.
25
+ # Next ID: 16.
25
26
  module Component
26
27
  # Unspecified component. Specifying this will cause Cluster creation to fail.
27
28
  COMPONENT_UNSPECIFIED = 0
28
29
 
29
- # The Anaconda python distribution.
30
+ # The Anaconda python distribution. The Anaconda component is not supported
31
+ # in the Dataproc
32
+ # <a
33
+ # href="/dataproc/docs/concepts/versioning/dataproc-release-2.0">2.0
34
+ # image</a>. The 2.0 image is pre-installed with Miniconda.
30
35
  ANACONDA = 5
31
36
 
37
+ # Docker
38
+ DOCKER = 13
39
+
40
+ # The Druid query engine. (alpha)
41
+ DRUID = 9
42
+
43
+ # Flink
44
+ FLINK = 14
45
+
46
+ # HBase. (beta)
47
+ HBASE = 11
48
+
32
49
  # The Hive Web HCatalog (the REST service for accessing HCatalog).
33
50
  HIVE_WEBHCAT = 3
34
51
 
@@ -38,6 +55,12 @@ module Google
38
55
  # The Presto query engine.
39
56
  PRESTO = 6
40
57
 
58
+ # The Ranger service.
59
+ RANGER = 12
60
+
61
+ # The Solr service.
62
+ SOLR = 10
63
+
41
64
  # The Zeppelin notebook.
42
65
  ZEPPELIN = 4
43
66
 
@@ -78,6 +78,18 @@ module Google
78
78
  # Optional. Template parameters whose values are substituted into the
79
79
  # template. Values for parameters must be provided when the template is
80
80
  # instantiated.
81
+ # @!attribute [rw] dag_timeout
82
+ # @return [::Google::Protobuf::Duration]
83
+ # Optional. Timeout duration for the DAG of jobs, expressed in seconds (see
84
+ # [JSON representation of
85
+ # duration](https://developers.google.com/protocol-buffers/docs/proto3#json)).
86
+ # The timeout duration must be from 10 minutes ("600s") to 24 hours
87
+ # ("86400s"). The timer begins when the first job is submitted. If the
88
+ # workflow is running at the end of the timeout period, any remaining jobs
89
+ # are cancelled, the workflow is ended, and if the workflow was running on a
90
+ # [managed
91
+ # cluster](/dataproc/docs/concepts/workflows/using-workflows#configuring_or_selecting_a_cluster),
92
+ # the cluster is deleted.
81
93
  class WorkflowTemplate
82
94
  include ::Google::Protobuf::MessageExts
83
95
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -181,8 +193,8 @@ module Google
181
193
  #
182
194
  # The step id is used as prefix for job id, as job
183
195
  # `goog-dataproc-workflow-step-id` label, and in
184
- # {::Google::Cloud::Dataproc::V1::OrderedJob#prerequisite_step_ids prerequisiteStepIds} field from other
185
- # steps.
196
+ # {::Google::Cloud::Dataproc::V1::OrderedJob#prerequisite_step_ids prerequisiteStepIds}
197
+ # field from other steps.
186
198
  #
187
199
  # The id must contain only letters (a-z, A-Z), numbers (0-9),
188
200
  # underscores (_), and hyphens (-). Cannot begin or end with underscore
@@ -268,10 +280,10 @@ module Google
268
280
  # A field is allowed to appear in at most one parameter's list of field
269
281
  # paths.
270
282
  #
271
- # A field path is similar in syntax to a {::Google::Protobuf::FieldMask google.protobuf.FieldMask}.
272
- # For example, a field path that references the zone field of a workflow
273
- # template's cluster selector would be specified as
274
- # `placement.clusterSelector.zone`.
283
+ # A field path is similar in syntax to a
284
+ # {::Google::Protobuf::FieldMask google.protobuf.FieldMask}. For example, a
285
+ # field path that references the zone field of a workflow template's cluster
286
+ # selector would be specified as `placement.clusterSelector.zone`.
275
287
  #
276
288
  # Also, field paths can reference fields using the following syntax:
277
289
  #
@@ -396,6 +408,21 @@ module Google
396
408
  # @!attribute [r] cluster_uuid
397
409
  # @return [::String]
398
410
  # Output only. The UUID of target cluster.
411
+ # @!attribute [r] dag_timeout
412
+ # @return [::Google::Protobuf::Duration]
413
+ # Output only. The timeout duration for the DAG of jobs, expressed in seconds
414
+ # (see [JSON representation of
415
+ # duration](https://developers.google.com/protocol-buffers/docs/proto3#json)).
416
+ # @!attribute [r] dag_start_time
417
+ # @return [::Google::Protobuf::Timestamp]
418
+ # Output only. DAG start time, only set for workflows with
419
+ # {::Google::Cloud::Dataproc::V1::WorkflowMetadata#dag_timeout dag_timeout} when
420
+ # DAG begins.
421
+ # @!attribute [r] dag_end_time
422
+ # @return [::Google::Protobuf::Timestamp]
423
+ # Output only. DAG end time, only set for workflows with
424
+ # {::Google::Cloud::Dataproc::V1::WorkflowMetadata#dag_timeout dag_timeout} when
425
+ # DAG ends.
399
426
  class WorkflowMetadata
400
427
  include ::Google::Protobuf::MessageExts
401
428
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -572,7 +599,7 @@ module Google
572
599
  # @!attribute [rw] parameters
573
600
  # @return [::Google::Protobuf::Map{::String => ::String}]
574
601
  # Optional. Map from parameter names to values that should be used for those
575
- # parameters. Values may not exceed 100 characters.
602
+ # parameters. Values may not exceed 1000 characters.
576
603
  class InstantiateWorkflowTemplateRequest
577
604
  include ::Google::Protobuf::MessageExts
578
605
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -25,7 +25,7 @@ module Google
25
25
  # @return [::String]
26
26
  # The server-assigned name, which is only unique within the same service that
27
27
  # originally returns it. If you use the default HTTP mapping, the
28
- # `name` should have the format of `operations/some/unique/name`.
28
+ # `name` should be a resource name ending with `operations/{unique_id}`.
29
29
  # @!attribute [rw] metadata
30
30
  # @return [::Google::Protobuf::Any]
31
31
  # Service-specific metadata associated with the operation. It typically
@@ -35,7 +35,7 @@ module Google
35
35
  # @!attribute [rw] done
36
36
  # @return [::Boolean]
37
37
  # If the value is `false`, it means the operation is still in progress.
38
- # If true, the operation is completed, and either `error` or `response` is
38
+ # If `true`, the operation is completed, and either `error` or `response` is
39
39
  # available.
40
40
  # @!attribute [rw] error
41
41
  # @return [::Google::Rpc::Status]
@@ -67,7 +67,7 @@ module Google
67
67
  # The request message for Operations.ListOperations.
68
68
  # @!attribute [rw] name
69
69
  # @return [::String]
70
- # The name of the operation collection.
70
+ # The name of the operation's parent resource.
71
71
  # @!attribute [rw] filter
72
72
  # @return [::String]
73
73
  # The standard list filter.
@@ -112,6 +112,20 @@ module Google
112
112
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
113
  end
114
114
 
115
+ # The request message for Operations.WaitOperation.
116
+ # @!attribute [rw] name
117
+ # @return [::String]
118
+ # The name of the operation resource to wait on.
119
+ # @!attribute [rw] timeout
120
+ # @return [::Google::Protobuf::Duration]
121
+ # The maximum duration to wait before timing out. If left blank, the wait
122
+ # will be at most the time permitted by the underlying HTTP/RPC protocol.
123
+ # If RPC context deadline is also specified, the shorter one will be used.
124
+ class WaitOperationRequest
125
+ include ::Google::Protobuf::MessageExts
126
+ extend ::Google::Protobuf::MessageExts::ClassMethods
127
+ end
128
+
115
129
  # A message representing the message types used by a long-running operation.
116
130
  #
117
131
  # Example:
@@ -57,10 +57,13 @@ module Google
57
57
  # Example 4: Pack and unpack a message in Go
58
58
  #
59
59
  # foo := &pb.Foo{...}
60
- # any, err := ptypes.MarshalAny(foo)
60
+ # any, err := anypb.New(foo)
61
+ # if err != nil {
62
+ # ...
63
+ # }
61
64
  # ...
62
65
  # foo := &pb.Foo{}
63
- # if err := ptypes.UnmarshalAny(any, foo); err != nil {
66
+ # if err := any.UnmarshalTo(foo); err != nil {
64
67
  # ...
65
68
  # }
66
69
  #
@@ -70,7 +70,16 @@ module Google
70
70
  # .setNanos((int) ((millis % 1000) * 1000000)).build();
71
71
  #
72
72
  #
73
- # Example 5: Compute Timestamp from current time in Python.
73
+ # Example 5: Compute Timestamp from Java `Instant.now()`.
74
+ #
75
+ # Instant now = Instant.now();
76
+ #
77
+ # Timestamp timestamp =
78
+ # Timestamp.newBuilder().setSeconds(now.getEpochSecond())
79
+ # .setNanos(now.getNano()).build();
80
+ #
81
+ #
82
+ # Example 6: Compute Timestamp from current time in Python.
74
83
  #
75
84
  # timestamp = Timestamp()
76
85
  # timestamp.GetCurrentTime()
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-dataproc-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.0
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-08-06 00:00:00.000000000 Z
11
+ date: 2021-04-26 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '0.3'
19
+ version: '0.4'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '0.3'
26
+ version: '0.4'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: google-cloud-errors
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -44,14 +44,14 @@ dependencies:
44
44
  requirements:
45
45
  - - "~>"
46
46
  - !ruby/object:Gem::Version
47
- version: 1.24.0
47
+ version: 1.25.1
48
48
  type: :development
49
49
  prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
52
  - - "~>"
53
53
  - !ruby/object:Gem::Version
54
- version: 1.24.0
54
+ version: 1.25.1
55
55
  - !ruby/object:Gem::Dependency
56
56
  name: minitest
57
57
  requirement: !ruby/object:Gem::Requirement
@@ -150,7 +150,10 @@ dependencies:
150
150
  - - "~>"
151
151
  - !ruby/object:Gem::Version
152
152
  version: '0.9'
153
- description: Manages Hadoop-based clusters and jobs on Google Cloud Platform.
153
+ description: Manages Hadoop-based clusters and jobs on Google Cloud Platform. Note
154
+ that google-cloud-dataproc-v1 is a version-specific client library. For most uses,
155
+ we recommend installing the main client library google-cloud-dataproc instead. See
156
+ the readme for more details.
154
157
  email: googleapis-packages@google.com
155
158
  executables: []
156
159
  extensions: []
@@ -172,6 +175,7 @@ files:
172
175
  - lib/google/cloud/dataproc/v1/cluster_controller/client.rb
173
176
  - lib/google/cloud/dataproc/v1/cluster_controller/credentials.rb
174
177
  - lib/google/cloud/dataproc/v1/cluster_controller/operations.rb
178
+ - lib/google/cloud/dataproc/v1/cluster_controller/paths.rb
175
179
  - lib/google/cloud/dataproc/v1/clusters_pb.rb
176
180
  - lib/google/cloud/dataproc/v1/clusters_services_pb.rb
177
181
  - lib/google/cloud/dataproc/v1/job_controller.rb
@@ -218,14 +222,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
218
222
  requirements:
219
223
  - - ">="
220
224
  - !ruby/object:Gem::Version
221
- version: '2.4'
225
+ version: '2.5'
222
226
  required_rubygems_version: !ruby/object:Gem::Requirement
223
227
  requirements:
224
228
  - - ">="
225
229
  - !ruby/object:Gem::Version
226
230
  version: '0'
227
231
  requirements: []
228
- rubygems_version: 3.1.3
232
+ rubygems_version: 3.2.13
229
233
  signing_key:
230
234
  specification_version: 4
231
235
  summary: API Client library for the Cloud Dataproc V1 API