google-cloud-dataproc-v1 0.14.0 → 0.16.0

data/lib/google/cloud/dataproc/v1/job_controller/client.rb

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/dataproc/v1/jobs_pb"
+require "google/iam/v1"
 
 module Google
   module Cloud
@@ -172,6 +173,12 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @job_controller_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Dataproc::V1::JobController::Stub,
                 credentials:  credentials,
@@ -188,6 +195,13 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the IAMPolicy.
+            #
+            # @return [Google::Iam::V1::IAMPolicy::Client]
+            #
+            attr_reader :iam_policy_client
+
             # Service calls
 
             ##
@@ -355,14 +369,14 @@ module Google
             #   # Call the submit_job_as_operation method.
             #   result = client.submit_job_as_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def submit_job_as_operation request, options = nil
@@ -578,13 +592,11 @@ module Google
             #   # Call the list_jobs method.
             #   result = client.list_jobs request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Dataproc::V1::Job.
-            #     p response
+            #     p item
             #   end
             #
             def list_jobs request, options = nil

data/lib/google/cloud/dataproc/v1/job_controller/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil

data/lib/google/cloud/dataproc/v1/job_controller.rb

@@ -33,7 +33,7 @@ module Google
         ##
         # The JobController provides methods to manage jobs.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dataproc/v1/job_controller"
         #     client = ::Google::Cloud::Dataproc::V1::JobController::Client.new

data/lib/google/cloud/dataproc/v1/jobs_pb.rb

@@ -114,6 +114,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :query_list, :message, 2, "google.cloud.dataproc.v1.QueryList"
       end
     end
+    add_message "google.cloud.dataproc.v1.TrinoJob" do
+      optional :continue_on_failure, :bool, 3
+      optional :output_format, :string, 4
+      repeated :client_tags, :string, 5
+      map :properties, :string, :string, 6
+      optional :logging_config, :message, 7, "google.cloud.dataproc.v1.LoggingConfig"
+      oneof :queries do
+        optional :query_file_uri, :string, 1
+        optional :query_list, :message, 2, "google.cloud.dataproc.v1.QueryList"
+      end
+    end
     add_message "google.cloud.dataproc.v1.JobPlacement" do
       optional :cluster_name, :string, 1
       optional :cluster_uuid, :string, 2
@@ -186,6 +197,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :spark_r_job, :message, 21, "google.cloud.dataproc.v1.SparkRJob"
         optional :spark_sql_job, :message, 12, "google.cloud.dataproc.v1.SparkSqlJob"
         optional :presto_job, :message, 23, "google.cloud.dataproc.v1.PrestoJob"
+        optional :trino_job, :message, 28, "google.cloud.dataproc.v1.TrinoJob"
       end
     end
     add_message "google.cloud.dataproc.v1.DriverSchedulingConfig" do
@@ -266,6 +278,7 @@ module Google
         PigJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.PigJob").msgclass
         SparkRJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.SparkRJob").msgclass
         PrestoJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.PrestoJob").msgclass
+        TrinoJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.TrinoJob").msgclass
         JobPlacement = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.JobPlacement").msgclass
         JobStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.JobStatus").msgclass
         JobStatus::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.JobStatus.State").enummodule

data/lib/google/cloud/dataproc/v1/node_group_controller/client.rb

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/dataproc/v1/node_groups_pb"
+require "google/iam/v1"
 
 module Google
   module Cloud
@@ -140,6 +141,12 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @node_group_controller_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Dataproc::V1::NodeGroupController::Stub,
                 credentials:  credentials,
@@ -156,6 +163,13 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the IAMPolicy.
+            #
+            # @return [Google::Iam::V1::IAMPolicy::Client]
+            #
+            attr_reader :iam_policy_client
+
             # Service calls
 
             ##
@@ -223,14 +237,14 @@ module Google
             #   # Call the create_node_group method.
             #   result = client.create_node_group request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def create_node_group request, options = nil
@@ -317,7 +331,7 @@ module Google
             #     The ID must contain only letters (a-z, A-Z), numbers (0-9),
             #     underscores (_), and hyphens (-). The maximum length is 40 characters.
             #   @param graceful_decommission_timeout [::Google::Protobuf::Duration, ::Hash]
-            #     Optional. Timeout for graceful YARN decommissioning. [Graceful
+            #     Optional. Timeout for graceful YARN decomissioning. [Graceful
             #     decommissioning]
             #     (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters#graceful_decommissioning)
             #     allows the removal of nodes from the Compute Engine node group
@@ -350,14 +364,14 @@ module Google
             #   # Call the resize_node_group method.
             #   result = client.resize_node_group request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def resize_node_group request, options = nil

data/lib/google/cloud/dataproc/v1/node_group_controller/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil

data/lib/google/cloud/dataproc/v1/node_group_controller.rb

@@ -35,7 +35,7 @@ module Google
         # The `NodeGroupControllerService` provides methods to manage node groups
         # of Compute Engine managed instances.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dataproc/v1/node_group_controller"
         #     client = ::Google::Cloud::Dataproc::V1::NodeGroupController::Client.new

data/lib/google/cloud/dataproc/v1/operations_pb.rb

@@ -43,6 +43,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :description, :string, 12
       map :labels, :string, :string, 13
       repeated :warnings, :string, 14
+      repeated :child_operation_ids, :string, 15
     end
     add_message "google.cloud.dataproc.v1.NodeGroupOperationMetadata" do
       optional :node_group_id, :string, 1

data/lib/google/cloud/dataproc/v1/shared_pb.rb

@@ -4,6 +4,9 @@
 require 'google/protobuf'
 
 require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/timestamp_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/dataproc/v1/shared.proto", :syntax => :proto3) do
@@ -20,6 +23,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :service_account, :string, 2
       repeated :network_tags, :string, 6
       optional :kms_key, :string, 7
+      optional :ttl, :message, 9, "google.protobuf.Duration"
+      optional :staging_bucket, :string, 10
       oneof :network do
         optional :network_uri, :string, 4
         optional :subnetwork_uri, :string, 5
@@ -36,6 +41,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :endpoints, :string, :string, 1
       optional :output_uri, :string, 2
       optional :diagnostic_output_uri, :string, 3
+      optional :approximate_usage, :message, 6, "google.cloud.dataproc.v1.UsageMetrics"
+      optional :current_usage, :message, 7, "google.cloud.dataproc.v1.UsageSnapshot"
+    end
+    add_message "google.cloud.dataproc.v1.UsageMetrics" do
+      optional :milli_dcu_seconds, :int64, 1
+      optional :shuffle_storage_gb_seconds, :int64, 2
+    end
+    add_message "google.cloud.dataproc.v1.UsageSnapshot" do
+      optional :milli_dcu, :int64, 1
+      optional :shuffle_storage_gb, :int64, 2
+      optional :snapshot_time, :message, 3, "google.protobuf.Timestamp"
     end
     add_message "google.cloud.dataproc.v1.GkeClusterConfig" do
       optional :gke_cluster_target, :string, 2
@@ -71,14 +87,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodeConfig" do
       optional :machine_type, :string, 1
-      optional :preemptible, :bool, 10
       optional :local_ssd_count, :int32, 7
+      optional :preemptible, :bool, 10
       repeated :accelerators, :message, 11, "google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAcceleratorConfig"
       optional :min_cpu_platform, :string, 13
+      optional :boot_disk_kms_key, :string, 23
+      optional :spot, :bool, 32
     end
     add_message "google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAcceleratorConfig" do
       optional :accelerator_count, :int64, 1
       optional :accelerator_type, :string, 2
+      optional :gpu_partition_size, :string, 3
     end
     add_message "google.cloud.dataproc.v1.GkeNodePoolConfig.GkeNodePoolAutoscalingConfig" do
       optional :min_node_count, :int32, 2
@@ -92,8 +111,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :FLINK, 14
       value :HBASE, 11
       value :HIVE_WEBHCAT, 3
+      value :HUDI, 18
       value :JUPYTER, 1
       value :PRESTO, 6
+      value :TRINO, 17
       value :RANGER, 12
       value :SOLR, 10
       value :ZEPPELIN, 4
@@ -117,6 +138,8 @@ module Google
         SparkHistoryServerConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.SparkHistoryServerConfig").msgclass
         PeripheralsConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.PeripheralsConfig").msgclass
         RuntimeInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.RuntimeInfo").msgclass
+        UsageMetrics = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.UsageMetrics").msgclass
+        UsageSnapshot = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.UsageSnapshot").msgclass
         GkeClusterConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.GkeClusterConfig").msgclass
         KubernetesClusterConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.KubernetesClusterConfig").msgclass
         KubernetesSoftwareConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.KubernetesSoftwareConfig").msgclass

data/lib/google/cloud/dataproc/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dataproc
       module V1
-        VERSION = "0.14.0"
+        VERSION = "0.16.0"
       end
     end
   end

data/lib/google/cloud/dataproc/v1/workflow_template_service/client.rb

@@ -18,6 +18,7 @@
 
 require "google/cloud/errors"
 require "google/cloud/dataproc/v1/workflow_templates_pb"
+require "google/iam/v1"
 
 module Google
   module Cloud
@@ -175,6 +176,12 @@ module Google
                 config.endpoint = @config.endpoint
               end
 
+              @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @workflow_template_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Stub,
                 credentials:  credentials,
@@ -191,6 +198,13 @@ module Google
             #
             attr_reader :operations_client
 
+            ##
+            # Get the associated client for mix-in of the IAMPolicy.
+            #
+            # @return [Google::Iam::V1::IAMPolicy::Client]
+            #
+            attr_reader :iam_policy_client
+
             # Service calls
 
             ##
@@ -480,14 +494,14 @@ module Google
             #   # Call the instantiate_workflow_template method.
             #   result = client.instantiate_workflow_template request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def instantiate_workflow_template request, options = nil
@@ -536,7 +550,8 @@ module Google
             # Instantiates a template and begins execution.
             #
             # This method is equivalent to executing the sequence
-            # {::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client#create_workflow_template CreateWorkflowTemplate}, {::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client#instantiate_workflow_template InstantiateWorkflowTemplate},
+            # {::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client#create_workflow_template CreateWorkflowTemplate},
+            # {::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client#instantiate_workflow_template InstantiateWorkflowTemplate},
             # {::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client#delete_workflow_template DeleteWorkflowTemplate}.
             #
             # The returned Operation can be used to track execution of
@@ -617,14 +632,14 @@ module Google
             #   # Call the instantiate_inline_workflow_template method.
             #   result = client.instantiate_inline_workflow_template request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def instantiate_inline_workflow_template request, options = nil
@@ -812,13 +827,11 @@ module Google
             #   # Call the list_workflow_templates method.
             #   result = client.list_workflow_templates request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Dataproc::V1::WorkflowTemplate.
-            #     p response
+            #     p item
             #   end
             #
             def list_workflow_templates request, options = nil

data/lib/google/cloud/dataproc/v1/workflow_template_service/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil

data/lib/google/cloud/dataproc/v1/workflow_template_service.rb

@@ -35,7 +35,7 @@ module Google
         # The API interface for managing Workflow Templates in the
         # Dataproc API.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dataproc/v1/workflow_template_service"
         #     client = ::Google::Cloud::Dataproc::V1::WorkflowTemplateService::Client.new

data/lib/google/cloud/dataproc/v1/workflow_templates_services_pb.rb

@@ -65,7 +65,8 @@ module Google
             # Instantiates a template and begins execution.
             #
             # This method is equivalent to executing the sequence
-            # [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate],
+            # [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate],
+            # [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate],
             # [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate].
             #
             # The returned Operation can be used to track execution of

data/lib/google/cloud/dataproc/v1.rb

@@ -20,17 +20,17 @@ require "google/cloud/dataproc/v1/autoscaling_policy_service"
 require "google/cloud/dataproc/v1/batch_controller"
 require "google/cloud/dataproc/v1/cluster_controller"
 require "google/cloud/dataproc/v1/job_controller"
-require "google/cloud/dataproc/v1/workflow_template_service"
 require "google/cloud/dataproc/v1/node_group_controller"
+require "google/cloud/dataproc/v1/workflow_template_service"
 require "google/cloud/dataproc/v1/version"
 
 module Google
   module Cloud
     module Dataproc
       ##
-      # To load this package, including all its services, and instantiate a client:
+      # API client module.
       #
-      # @example
+      # @example Load this package, including all its services, and instantiate a gRPC client
       #
       #     require "google/cloud/dataproc/v1"
       #     client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new

data/proto_docs/google/cloud/dataproc/v1/autoscaling_policies.rb

@@ -98,20 +98,20 @@ module Google
         #     Bounds: [0s, 1d].
         # @!attribute [rw] scale_up_factor
         #   @return [::Float]
-        #     Required. Fraction of average YARN pending memory in the last cooldown period
-        #     for which to add workers. A scale-up factor of 1.0 will result in scaling
-        #     up so that there is no pending memory remaining after the update (more
-        #     aggressive scaling). A scale-up factor closer to 0 will result in a smaller
-        #     magnitude of scaling up (less aggressive scaling).
-        #     See [How autoscaling
+        #     Required. Fraction of average YARN pending memory in the last cooldown
+        #     period for which to add workers. A scale-up factor of 1.0 will result in
+        #     scaling up so that there is no pending memory remaining after the update
+        #     (more aggressive scaling). A scale-up factor closer to 0 will result in a
+        #     smaller magnitude of scaling up (less aggressive scaling). See [How
+        #     autoscaling
         #     works](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/autoscaling#how_autoscaling_works)
         #     for more information.
         #
         #     Bounds: [0.0, 1.0].
         # @!attribute [rw] scale_down_factor
         #   @return [::Float]
-        #     Required. Fraction of average YARN pending memory in the last cooldown period
-        #     for which to remove workers. A scale-down factor of 1 will result in
+        #     Required. Fraction of average YARN pending memory in the last cooldown
+        #     period for which to remove workers. A scale-down factor of 1 will result in
         #     scaling down so that there is no available memory remaining after the
         #     update (more aggressive scaling). A scale-down factor of 0 disables
         #     removing workers, which can be beneficial for autoscaling a single job.