google-cloud-dataproc 0.5.1 → 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/AUTHENTICATION.md +3 -3
  3. data/lib/google/cloud/dataproc/v1/autoscaling_policies_pb.rb +80 -0
  4. data/lib/google/cloud/dataproc/v1/autoscaling_policies_services_pb.rb +60 -0
  5. data/lib/google/cloud/dataproc/v1/cluster_controller_client.rb +20 -6
  6. data/lib/google/cloud/dataproc/v1/clusters_pb.rb +31 -0
  7. data/lib/google/cloud/dataproc/v1/clusters_services_pb.rb +16 -6
  8. data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/autoscaling_policies.rb +23 -0
  9. data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/clusters.rb +107 -5
  10. data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/jobs.rb +1 -1
  11. data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/workflow_templates.rb +84 -31
  12. data/lib/google/cloud/dataproc/v1/doc/google/protobuf/timestamp.rb +6 -4
  13. data/lib/google/cloud/dataproc/v1/jobs_pb.rb +2 -0
  14. data/lib/google/cloud/dataproc/v1/operations_pb.rb +2 -1
  15. data/lib/google/cloud/dataproc/v1/workflow_template_service_client.rb +67 -21
  16. data/lib/google/cloud/dataproc/v1/workflow_templates_pb.rb +3 -0
  17. data/lib/google/cloud/dataproc/v1/workflow_templates_services_pb.rb +6 -2
  18. data/lib/google/cloud/dataproc/v1beta2/autoscaling_policies_pb.rb +3 -4
  19. data/lib/google/cloud/dataproc/v1beta2/autoscaling_policy_service_client.rb +39 -11
  20. data/lib/google/cloud/dataproc/v1beta2/cluster_controller_client.rb +17 -7
  21. data/lib/google/cloud/dataproc/v1beta2/clusters_pb.rb +4 -0
  22. data/lib/google/cloud/dataproc/v1beta2/clusters_services_pb.rb +16 -6
  23. data/lib/google/cloud/dataproc/v1beta2/doc/google/cloud/dataproc/v1beta2/autoscaling_policies.rb +50 -14
  24. data/lib/google/cloud/dataproc/v1beta2/doc/google/cloud/dataproc/v1beta2/clusters.rb +12 -7
  25. data/lib/google/cloud/dataproc/v1beta2/doc/google/cloud/dataproc/v1beta2/jobs.rb +9 -4
  26. data/lib/google/cloud/dataproc/v1beta2/doc/google/cloud/dataproc/v1beta2/workflow_templates.rb +82 -24
  27. data/lib/google/cloud/dataproc/v1beta2/doc/google/protobuf/timestamp.rb +6 -4
  28. data/lib/google/cloud/dataproc/v1beta2/jobs_pb.rb +2 -0
  29. data/lib/google/cloud/dataproc/v1beta2/operations_pb.rb +1 -1
  30. data/lib/google/cloud/dataproc/v1beta2/workflow_template_service_client.rb +67 -21
  31. data/lib/google/cloud/dataproc/v1beta2/workflow_templates_pb.rb +3 -0
  32. data/lib/google/cloud/dataproc/v1beta2/workflow_templates_services_pb.rb +6 -2
  33. data/lib/google/cloud/dataproc/version.rb +1 -1
  34. metadata +6 -3
@@ -231,7 +231,9 @@ module Google
231
231
 
232
232
  # Service calls
233
233
 
234
- # Creates a cluster in a project.
234
+ # Creates a cluster in a project. The returned
235
+ # {Google::Longrunning::Operation#metadata Operation#metadata} will be
236
+ # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
235
237
  #
236
238
  # @param project_id [String]
237
239
  # Required. The ID of the Google Cloud Platform project that the cluster
@@ -324,7 +326,9 @@ module Google
324
326
  operation
325
327
  end
326
328
 
327
- # Updates a cluster in a project.
329
+ # Updates a cluster in a project. The returned
330
+ # {Google::Longrunning::Operation#metadata Operation#metadata} will be
331
+ # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
328
332
  #
329
333
  # @param project_id [String]
330
334
  # Required. The ID of the Google Cloud Platform project the
@@ -505,7 +509,9 @@ module Google
505
509
  operation
506
510
  end
507
511
 
508
- # Deletes a cluster in a project.
512
+ # Deletes a cluster in a project. The returned
513
+ # {Google::Longrunning::Operation#metadata Operation#metadata} will be
514
+ # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
509
515
  #
510
516
  # @param project_id [String]
511
517
  # Required. The ID of the Google Cloud Platform project that the cluster
@@ -656,7 +662,7 @@ module Google
656
662
  # @param region [String]
657
663
  # Required. The Cloud Dataproc region in which to handle the request.
658
664
  # @param filter [String]
659
- # Optional. A filter constraining the clusters to list. Filters are
665
+ # Optional. A filter constraining the clusters to list. Filters are
660
666
  # case-sensitive and have the following syntax:
661
667
  #
662
668
  # field = value [AND [field = value]] ...
@@ -734,9 +740,13 @@ module Google
734
740
  @list_clusters.call(req, options, &block)
735
741
  end
736
742
 
737
- # Gets cluster diagnostic information.
738
- # After the operation completes, the Operation.response field
739
- # contains `DiagnoseClusterOutputLocation`.
743
+ # Gets cluster diagnostic information. The returned
744
+ # {Google::Longrunning::Operation#metadata Operation#metadata} will be
745
+ # [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
746
+ # After the operation completes,
747
+ # {Google::Longrunning::Operation#response Operation#response}
748
+ # contains
749
+ # [Empty](https://cloud.google.comgoogle.protobuf.Empty).
740
750
  #
741
751
  # @param project_id [String]
742
752
  # Required. The ID of the Google Cloud Platform project that the cluster
@@ -5,6 +5,8 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
8
10
  require 'google/cloud/dataproc/v1beta2/operations_pb'
9
11
  require 'google/cloud/dataproc/v1beta2/shared_pb'
10
12
  require 'google/longrunning/operations_pb'
@@ -83,6 +85,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
83
85
  end
84
86
  add_message "google.cloud.dataproc.v1beta2.LifecycleConfig" do
85
87
  optional :idle_delete_ttl, :message, 1, "google.protobuf.Duration"
88
+ optional :idle_start_time, :message, 4, "google.protobuf.Timestamp"
86
89
  oneof :ttl do
87
90
  optional :auto_delete_time, :message, 2, "google.protobuf.Timestamp"
88
91
  optional :auto_delete_ttl, :message, 3, "google.protobuf.Duration"
@@ -106,6 +109,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
106
109
  optional :cross_realm_trust_shared_password_uri, :string, 12
107
110
  optional :kdc_db_key_uri, :string, 13
108
111
  optional :tgt_lifetime_hours, :int32, 14
112
+ optional :realm, :string, 15
109
113
  end
110
114
  add_message "google.cloud.dataproc.v1beta2.NodeInitializationAction" do
111
115
  optional :executable_file, :string, 1
@@ -36,19 +36,29 @@ module Google
36
36
  self.unmarshal_class_method = :decode
37
37
  self.service_name = 'google.cloud.dataproc.v1beta2.ClusterController'
38
38
 
39
- # Creates a cluster in a project.
39
+ # Creates a cluster in a project. The returned
40
+ # [Operation.metadata][google.longrunning.Operation.metadata] will be
41
+ # [ClusterOperationMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
40
42
  rpc :CreateCluster, CreateClusterRequest, Google::Longrunning::Operation
41
- # Updates a cluster in a project.
43
+ # Updates a cluster in a project. The returned
44
+ # [Operation.metadata][google.longrunning.Operation.metadata] will be
45
+ # [ClusterOperationMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
42
46
  rpc :UpdateCluster, UpdateClusterRequest, Google::Longrunning::Operation
43
- # Deletes a cluster in a project.
47
+ # Deletes a cluster in a project. The returned
48
+ # [Operation.metadata][google.longrunning.Operation.metadata] will be
49
+ # [ClusterOperationMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
44
50
  rpc :DeleteCluster, DeleteClusterRequest, Google::Longrunning::Operation
45
51
  # Gets the resource representation for a cluster in a project.
46
52
  rpc :GetCluster, GetClusterRequest, Cluster
47
53
  # Lists all regions/\\{region}/clusters in a project.
48
54
  rpc :ListClusters, ListClustersRequest, ListClustersResponse
49
- # Gets cluster diagnostic information.
50
- # After the operation completes, the Operation.response field
51
- # contains `DiagnoseClusterOutputLocation`.
55
+ # Gets cluster diagnostic information. The returned
56
+ # [Operation.metadata][google.longrunning.Operation.metadata] will be
57
+ # [ClusterOperationMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata).
58
+ # After the operation completes,
59
+ # [Operation.response][google.longrunning.Operation.response]
60
+ # contains
61
+ # [Empty](google.protobuf.Empty).
52
62
  rpc :DiagnoseCluster, DiagnoseClusterRequest, Google::Longrunning::Operation
53
63
  end
54
64
 
@@ -27,9 +27,16 @@ module Google
27
27
  # or hyphen. Must consist of between 3 and 50 characters.
28
28
  # @!attribute [rw] name
29
29
  # @return [String]
30
- # Output only. The "resource name" of the policy, as described
31
- # in https://cloud.google.com/apis/design/resource_names of the form
32
- # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
30
+ # Output only. The "resource name" of the autoscaling policy, as described
31
+ # in https://cloud.google.com/apis/design/resource_names.
32
+ #
33
+ # * For `projects.regions.autoscalingPolicies`, the resource name of the
34
+ # policy has the following format:
35
+ # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`
36
+ #
37
+ # * For `projects.locations.autoscalingPolicies`, the resource name of the
38
+ # policy has the following format:
39
+ # `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}`
33
40
  # @!attribute [rw] basic_algorithm
34
41
  # @return [Google::Cloud::Dataproc::V1beta2::BasicAutoscalingAlgorithm]
35
42
  # @!attribute [rw] worker_config
@@ -140,20 +147,34 @@ module Google
140
147
  # A request to create an autoscaling policy.
141
148
  # @!attribute [rw] parent
142
149
  # @return [String]
143
- # Required. The "resource name" of the region, as described
144
- # in https://cloud.google.com/apis/design/resource_names of the form
145
- # `projects/{project_id}/regions/{region}`.
150
+ # Required. The "resource name" of the region or location, as described
151
+ # in https://cloud.google.com/apis/design/resource_names.
152
+ #
153
+ # * For `projects.regions.autoscalingPolicies.create`, the resource name
154
+ # has the following format:
155
+ # `projects/{project_id}/regions/{region}`
156
+ #
157
+ # * For `projects.locations.autoscalingPolicies.create`, the resource name
158
+ # has the following format:
159
+ # `projects/{project_id}/locations/{location}`
146
160
  # @!attribute [rw] policy
147
161
  # @return [Google::Cloud::Dataproc::V1beta2::AutoscalingPolicy]
148
- # The autoscaling policy to create.
162
+ # Required. The autoscaling policy to create.
149
163
  class CreateAutoscalingPolicyRequest; end
150
164
 
151
165
  # A request to fetch an autoscaling policy.
152
166
  # @!attribute [rw] name
153
167
  # @return [String]
154
168
  # Required. The "resource name" of the autoscaling policy, as described
155
- # in https://cloud.google.com/apis/design/resource_names of the form
156
- # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
169
+ # in https://cloud.google.com/apis/design/resource_names.
170
+ #
171
+ # * For `projects.regions.autoscalingPolicies.get`, the resource name
172
+ # of the policy has the following format:
173
+ # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`
174
+ #
175
+ # * For `projects.locations.autoscalingPolicies.get`, the resource name
176
+ # of the policy has the following format:
177
+ # `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}`
157
178
  class GetAutoscalingPolicyRequest; end
158
179
 
159
180
  # A request to update an autoscaling policy.
@@ -168,19 +189,34 @@ module Google
168
189
  # @!attribute [rw] name
169
190
  # @return [String]
170
191
  # Required. The "resource name" of the autoscaling policy, as described
171
- # in https://cloud.google.com/apis/design/resource_names of the form
172
- # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
192
+ # in https://cloud.google.com/apis/design/resource_names.
193
+ #
194
+ # * For `projects.regions.autoscalingPolicies.delete`, the resource name
195
+ # of the policy has the following format:
196
+ # `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`
197
+ #
198
+ # * For `projects.locations.autoscalingPolicies.delete`, the resource name
199
+ # of the policy has the following format:
200
+ # `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}`
173
201
  class DeleteAutoscalingPolicyRequest; end
174
202
 
175
203
  # A request to list autoscaling policies in a project.
176
204
  # @!attribute [rw] parent
177
205
  # @return [String]
178
- # Required. The "resource name" of the region, as described
179
- # in https://cloud.google.com/apis/design/resource_names of the form
180
- # `projects/{project_id}/regions/{region}`
206
+ # Required. The "resource name" of the region or location, as described
207
+ # in https://cloud.google.com/apis/design/resource_names.
208
+ #
209
+ # * For `projects.regions.autoscalingPolicies.list`, the resource name
210
+ # of the region has the following format:
211
+ # `projects/{project_id}/regions/{region}`
212
+ #
213
+ # * For `projects.locations.autoscalingPolicies.list`, the resource name
214
+ # of the location has the following format:
215
+ # `projects/{project_id}/locations/{location}`
181
216
  # @!attribute [rw] page_size
182
217
  # @return [Integer]
183
218
  # Optional. The maximum number of results to return in each response.
219
+ # Must be less than or equal to 1000. Defaults to 100.
184
220
  # @!attribute [rw] page_token
185
221
  # @return [String]
186
222
  # Optional. The page token, returned by a previous call, to request the
@@ -242,7 +242,7 @@ module Google
242
242
  # Optional. Reservation Affinity for consuming Zonal reservation.
243
243
  class GceClusterConfig; end
244
244
 
245
- # Optional. The config settings for Compute Engine resources in
245
+ # The config settings for Compute Engine resources in
246
246
  # an instance group, such as a master or worker group.
247
247
  # @!attribute [rw] num_instances
248
248
  # @return [Integer]
@@ -288,12 +288,9 @@ module Google
288
288
  # @return [Array<Google::Cloud::Dataproc::V1beta2::AcceleratorConfig>]
289
289
  # Optional. The Compute Engine accelerator configuration for these
290
290
  # instances.
291
- #
292
- # **Beta Feature**: This feature is still under development. It may be
293
- # changed before final release.
294
291
  # @!attribute [rw] min_cpu_platform
295
292
  # @return [String]
296
- # Optional. Specifies the minimum cpu platform for the Instance Group.
293
+ # Specifies the minimum cpu platform for the Instance Group.
297
294
  # See [Cloud Dataproc&rarr;Minimum CPU Platform]
298
295
  # (/dataproc/docs/concepts/compute/dataproc-min-cpu).
299
296
  class InstanceGroupConfig; end
@@ -343,7 +340,7 @@ module Google
343
340
  # Optional. Size in GB of the boot disk (default is 500GB).
344
341
  # @!attribute [rw] num_local_ssds
345
342
  # @return [Integer]
346
- # Optional. Number of attached SSDs, from 0 to 4 (default is 0).
343
+ # Number of attached SSDs, from 0 to 4 (default is 0).
347
344
  # If SSDs are not attached, the boot disk is used to store runtime logs and
348
345
  # [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data.
349
346
  # If one or more SSDs are attached, this runtime bulk
@@ -369,6 +366,10 @@ module Google
369
366
  # auto-deleted at the end of this period. Valid range: **[10m, 14d]**.
370
367
  #
371
368
  # Example: **"1d"**, to delete the cluster 1 day after its creation..
369
+ # @!attribute [rw] idle_start_time
370
+ # @return [Google::Protobuf::Timestamp]
371
+ # Output only. The time when cluster became idle (most recent job finished)
372
+ # and became eligible for deletion due to idleness.
372
373
  class LifecycleConfig; end
373
374
 
374
375
  # Security related configuration, including encryption, Kerberos, etc.
@@ -440,6 +441,10 @@ module Google
440
441
  # Optional. The lifetime of the ticket granting ticket, in hours.
441
442
  # If not specified, or user specifies 0, then default value 10
442
443
  # will be used.
444
+ # @!attribute [rw] realm
445
+ # @return [String]
446
+ # Optional. The name of the on-cluster Kerberos realm.
447
+ # If not specified, the uppercased domain of hostnames will be the realm.
443
448
  class KerberosConfig; end
444
449
 
445
450
  # Specifies an executable to run on a fully configured node and a
@@ -738,7 +743,7 @@ module Google
738
743
  # Required. The Cloud Dataproc region in which to handle the request.
739
744
  # @!attribute [rw] filter
740
745
  # @return [String]
741
- # Optional. A filter constraining the clusters to list. Filters are
746
+ # Optional. A filter constraining the clusters to list. Filters are
742
747
  # case-sensitive and have the following syntax:
743
748
  #
744
749
  # field = value [AND [field = value]] ...
@@ -107,6 +107,11 @@ module Google
107
107
 
108
108
  # A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/)
109
109
  # applications on YARN.
110
+ # The specification of the main method to call to drive the job.
111
+ # Specify either the jar file that contains the main class or the main class
112
+ # name. To pass both a main jar and a main class in that jar, add the jar to
113
+ # `CommonJob.jar_file_uris`, and then specify the main class name in
114
+ # `main_class`.
110
115
  # @!attribute [rw] main_jar_file_uri
111
116
  # @return [String]
112
117
  # The HCFS URI of the jar file that contains the main class.
@@ -433,16 +438,16 @@ module Google
433
438
  # be changed before final release.
434
439
  # @!attribute [rw] name
435
440
  # @return [String]
436
- # Required. The application name.
441
+ # Output only. The application name.
437
442
  # @!attribute [rw] state
438
443
  # @return [Google::Cloud::Dataproc::V1beta2::YarnApplication::State]
439
- # Required. The application state.
444
+ # Output only. The application state.
440
445
  # @!attribute [rw] progress
441
446
  # @return [Float]
442
- # Required. The numerical progress of the application, from 1 to 100.
447
+ # Output only. The numerical progress of the application, from 1 to 100.
443
448
  # @!attribute [rw] tracking_url
444
449
  # @return [String]
445
- # Optional. The HTTP URL of the ApplicationMaster, HistoryServer, or
450
+ # Optional. Output only. The HTTP URL of the ApplicationMaster, HistoryServer, or
446
451
  # TimelineServer that provides application-specific information. The URL uses
447
452
  # the internal hostname, and requires a proxy server for resolution and,
448
453
  # possibly, access.
@@ -29,9 +29,16 @@ module Google
29
29
  # .
30
30
  # @!attribute [rw] name
31
31
  # @return [String]
32
- # Output only. The "resource name" of the template, as described
33
- # in https://cloud.google.com/apis/design/resource_names of the form
34
- # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
32
+ # Output only. The resource name of the workflow template, as described
33
+ # in https://cloud.google.com/apis/design/resource_names.
34
+ #
35
+ # * For `projects.regions.workflowTemplates`, the resource name of the
36
+ # template has the following format:
37
+ # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
38
+ #
39
+ # * For `projects.locations.workflowTemplates`, the resource name of the
40
+ # template has the following format:
41
+ # `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
35
42
  # @!attribute [rw] version
36
43
  # @return [Integer]
37
44
  # Optional. Used to perform a consistent read-modify-write.
@@ -194,7 +201,7 @@ module Google
194
201
  # * Zone (in ClusterSelector)
195
202
  # @!attribute [rw] name
196
203
  # @return [String]
197
- # Required. Parameter name.
204
+ # Required. Parameter name.
198
205
  # The parameter name is used as the key, and paired with the
199
206
  # parameter value, which are passed to the template when the template
200
207
  # is instantiated.
@@ -282,7 +289,16 @@ module Google
282
289
  # A Cloud Dataproc workflow template resource.
283
290
  # @!attribute [rw] template
284
291
  # @return [String]
285
- # Output only. The "resource name" of the template.
292
+ # Output only. The resource name of the workflow template as described
293
+ # in https://cloud.google.com/apis/design/resource_names.
294
+ #
295
+ # * For `projects.regions.workflowTemplates`, the resource name of the
296
+ # template has the following format:
297
+ # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
298
+ #
299
+ # * For `projects.locations.workflowTemplates`, the resource name of the
300
+ # template has the following format:
301
+ # `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
286
302
  # @!attribute [rw] version
287
303
  # @return [Integer]
288
304
  # Output only. The version of template at the time of
@@ -392,9 +408,16 @@ module Google
392
408
  # A request to create a workflow template.
393
409
  # @!attribute [rw] parent
394
410
  # @return [String]
395
- # Required. The "resource name" of the region, as described
396
- # in https://cloud.google.com/apis/design/resource_names of the form
397
- # `projects/{project_id}/regions/{region}`
411
+ # Required. The resource name of the region or location, as described
412
+ # in https://cloud.google.com/apis/design/resource_names.
413
+ #
414
+ # * For `projects.regions.workflowTemplates,create`, the resource name of the
415
+ # region has the following format:
416
+ # `projects/{project_id}/regions/{region}`
417
+ #
418
+ # * For `projects.locations.workflowTemplates.create`, the resource name of
419
+ # the location has the following format:
420
+ # `projects/{project_id}/locations/{location}`
398
421
  # @!attribute [rw] template
399
422
  # @return [Google::Cloud::Dataproc::V1beta2::WorkflowTemplate]
400
423
  # Required. The Dataproc workflow template to create.
@@ -403,13 +426,20 @@ module Google
403
426
  # A request to fetch a workflow template.
404
427
  # @!attribute [rw] name
405
428
  # @return [String]
406
- # Required. The "resource name" of the workflow template, as described
407
- # in https://cloud.google.com/apis/design/resource_names of the form
408
- # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
429
+ # Required. The resource name of the workflow template, as described
430
+ # in https://cloud.google.com/apis/design/resource_names.
431
+ #
432
+ # * For `projects.regions.workflowTemplates.get`, the resource name of the
433
+ # template has the following format:
434
+ # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
435
+ #
436
+ # * For `projects.locations.workflowTemplates.get`, the resource name of the
437
+ # template has the following format:
438
+ # `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
409
439
  # @!attribute [rw] version
410
440
  # @return [Integer]
411
441
  # Optional. The version of workflow template to retrieve. Only previously
412
- # instatiated versions can be retrieved.
442
+ # instantiated versions can be retrieved.
413
443
  #
414
444
  # If unspecified, retrieves the current version.
415
445
  class GetWorkflowTemplateRequest; end
@@ -417,9 +447,16 @@ module Google
417
447
  # A request to instantiate a workflow template.
418
448
  # @!attribute [rw] name
419
449
  # @return [String]
420
- # Required. The "resource name" of the workflow template, as described
421
- # in https://cloud.google.com/apis/design/resource_names of the form
422
- # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
450
+ # Required. The resource name of the workflow template, as described
451
+ # in https://cloud.google.com/apis/design/resource_names.
452
+ #
453
+ # * For `projects.regions.workflowTemplates.instantiate`, the resource name
454
+ # of the template has the following format:
455
+ # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
456
+ #
457
+ # * For `projects.locations.workflowTemplates.instantiate`, the resource name
458
+ # of the template has the following format:
459
+ # `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
423
460
  # @!attribute [rw] version
424
461
  # @return [Integer]
425
462
  # Optional. The version of workflow template to instantiate. If specified,
@@ -451,9 +488,16 @@ module Google
451
488
  # A request to instantiate an inline workflow template.
452
489
  # @!attribute [rw] parent
453
490
  # @return [String]
454
- # Required. The "resource name" of the workflow template region, as described
455
- # in https://cloud.google.com/apis/design/resource_names of the form
456
- # `projects/{project_id}/regions/{region}`
491
+ # Required. The resource name of the region or location, as described
492
+ # in https://cloud.google.com/apis/design/resource_names.
493
+ #
494
+ # * For `projects.regions.workflowTemplates,instantiateinline`, the resource
495
+ # name of the region has the following format:
496
+ # `projects/{project_id}/regions/{region}`
497
+ #
498
+ # * For `projects.locations.workflowTemplates.instantiateinline`, the
499
+ # resource name of the location has the following format:
500
+ # `projects/{project_id}/locations/{location}`
457
501
  # @!attribute [rw] template
458
502
  # @return [Google::Cloud::Dataproc::V1beta2::WorkflowTemplate]
459
503
  # Required. The workflow template to instantiate.
@@ -484,9 +528,16 @@ module Google
484
528
  # A request to list workflow templates in a project.
485
529
  # @!attribute [rw] parent
486
530
  # @return [String]
487
- # Required. The "resource name" of the region, as described
488
- # in https://cloud.google.com/apis/design/resource_names of the form
489
- # `projects/{project_id}/regions/{region}`
531
+ # Required. The resource name of the region or location, as described
532
+ # in https://cloud.google.com/apis/design/resource_names.
533
+ #
534
+ # * For `projects.regions.workflowTemplates,list`, the resource
535
+ # name of the region has the following format:
536
+ # `projects/{project_id}/regions/{region}`
537
+ #
538
+ # * For `projects.locations.workflowTemplates.list`, the
539
+ # resource name of the location has the following format:
540
+ # `projects/{project_id}/locations/{location}`
490
541
  # @!attribute [rw] page_size
491
542
  # @return [Integer]
492
543
  # Optional. The maximum number of results to return in each response.
@@ -512,9 +563,16 @@ module Google
512
563
  # Currently started workflows will remain running.
513
564
  # @!attribute [rw] name
514
565
  # @return [String]
515
- # Required. The "resource name" of the workflow template, as described
516
- # in https://cloud.google.com/apis/design/resource_names of the form
517
- # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
566
+ # Required. The resource name of the workflow template, as described
567
+ # in https://cloud.google.com/apis/design/resource_names.
568
+ #
569
+ # * For `projects.regions.workflowTemplates.delete`, the resource name
570
+ # of the template has the following format:
571
+ # `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
572
+ #
573
+ # * For `projects.locations.workflowTemplates.instantiate`, the resource name
574
+ # of the template has the following format:
575
+ # `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
518
576
  # @!attribute [rw] version
519
577
  # @return [Integer]
520
578
  # Optional. The version of workflow template to delete. If specified,