google-cloud-dataproc-v1 0.5.0 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8f513311372852777147dc4acadea0053ab1c1b49f8005ec4fe4176016a58aa
-  data.tar.gz: 1028ed0af3f6035b7b3ff5bfcfee9546e563ab8154ce13b46c371d5787e473ff
+  metadata.gz: 9df93f6bd1d83e69b00a66aafaac208f41268c4e426556242014353c6acfcc80
+  data.tar.gz: 8034f237fcfff16df053a9c5dd26e8b52bacc26f23d8ee4a4ddafe639b716fa4
 SHA512:
-  metadata.gz: f2a9885f4e2b1ced87eab958361b137a33f9528885e4cfe6882bdfbe5a0902d0f5aa8c8e2efa7f7264936900e94b752459b9d2315a474febe4e02b311fdd8cab
-  data.tar.gz: a1cf6046ba3c50b12518073fa76b7df496449ba505ccf580f1233d59b0779d01cd139d798c6567a782269771f8a55690e4627d3fd18167ab143e04459cf6022a
+  metadata.gz: 2007015632c66ae71352f90689f23ca1ccee4f6c0aa45c7c20ce214f3a9cb6e896d3c57654737135de2d42d1a74969dbef4aa8f041e20a20b352e4792958eaec
+  data.tar.gz: 2d88207eb2471725760b0ef449f8f58fdca93432190a806486e05ffcf27d705ceeb6a069f147b65cbca68dae645aa451e512e7a36625c706f1e9a7912a85f8ba

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-dataproc-v1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Credentials}):
 
-1. `DATAPROC_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `DATAPROC_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `DATAPROC_CREDENTIALS` - Path to JSON file, or JSON contents
+* `DATAPROC_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/dataproc/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/dataproc/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new do
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/dataproc/v1"

data/README.md

@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/dataproc/v1"
 
 client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new
-request = my_create_request
+request = ::Google::Cloud::Dataproc::V1::CreateAutoscalingPolicyRequest.new # (request fields as keyword arguments...)
 response = client.create_autoscaling_policy request
 ```
 

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

@@ -42,13 +42,12 @@ module Google
             # See {::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all AutoscalingPolicyService clients:
-            #
-            #     ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all AutoscalingPolicyService clients
+            #   ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -70,26 +69,17 @@ module Google
 
                 default_config.rpcs.update_autoscaling_policy.timeout = 600.0
                 default_config.rpcs.update_autoscaling_policy.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                 }
 
                 default_config.rpcs.get_autoscaling_policy.timeout = 600.0
                 default_config.rpcs.get_autoscaling_policy.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                 }
 
                 default_config.rpcs.list_autoscaling_policies.timeout = 600.0
                 default_config.rpcs.list_autoscaling_policies.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [4, 14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                 }
 
                 default_config.rpcs.delete_autoscaling_policy.timeout = 600.0
@@ -123,19 +113,15 @@ module Google
             ##
             # Create a new AutoscalingPolicyService client object.
             #
-            # ## Examples
-            #
-            # To create a new AutoscalingPolicyService client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new
+            # @example
             #
-            # To create a new AutoscalingPolicyService client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new
             #
-            #     client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the AutoscalingPolicyService client.
             # @yieldparam config [Client::Configuration]
@@ -155,14 +141,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -245,7 +230,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_autoscaling_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_autoscaling_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @autoscaling_policy_service_stub.call_rpc :create_autoscaling_policy, request, options: options do |response, operation|
@@ -314,7 +301,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_autoscaling_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_autoscaling_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @autoscaling_policy_service_stub.call_rpc :update_autoscaling_policy, request, options: options do |response, operation|
@@ -389,7 +378,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_autoscaling_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_autoscaling_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @autoscaling_policy_service_stub.call_rpc :get_autoscaling_policy, request, options: options do |response, operation|
@@ -470,7 +461,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_autoscaling_policies.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_autoscaling_policies.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @autoscaling_policy_service_stub.call_rpc :list_autoscaling_policies, request, options: options do |response, operation|
@@ -547,7 +540,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_autoscaling_policy.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_autoscaling_policy.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @autoscaling_policy_service_stub.call_rpc :delete_autoscaling_policy, request, options: options do |response, operation|
@@ -571,22 +566,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for create_autoscaling_policy
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_autoscaling_policy.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_autoscaling_policy.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # create_autoscaling_policy to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_autoscaling_policy.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Dataproc::V1::AutoscalingPolicyService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_autoscaling_policy.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

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

@@ -23,6 +23,7 @@ require "gapic/config/method"
 require "google/cloud/dataproc/v1/version"
 
 require "google/cloud/dataproc/v1/cluster_controller/credentials"
+require "google/cloud/dataproc/v1/cluster_controller/paths"
 require "google/cloud/dataproc/v1/cluster_controller/operations"
 require "google/cloud/dataproc/v1/cluster_controller/client"
 

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

@@ -31,6 +31,8 @@ module Google
           # of Compute Engine instances.
           #
           class Client
+            include Paths
+
             # @private
             attr_reader :cluster_controller_stub
 
@@ -40,13 +42,12 @@ module Google
             # See {::Google::Cloud::Dataproc::V1::ClusterController::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
-            #
-            # To modify the configuration for all ClusterController clients:
+            # @example
             #
-            #     ::Google::Cloud::Dataproc::V1::ClusterController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all ClusterController clients
+            #   ::Google::Cloud::Dataproc::V1::ClusterController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -66,50 +67,32 @@ module Google
 
                 default_config.rpcs.create_cluster.timeout = 300.0
                 default_config.rpcs.create_cluster.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.update_cluster.timeout = 300.0
                 default_config.rpcs.update_cluster.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.delete_cluster.timeout = 300.0
                 default_config.rpcs.delete_cluster.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config.rpcs.get_cluster.timeout = 300.0
                 default_config.rpcs.get_cluster.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [13, 4, 14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [13, 4, 14]
                 }
 
                 default_config.rpcs.list_clusters.timeout = 300.0
                 default_config.rpcs.list_clusters.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [13, 4, 14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [13, 4, 14]
                 }
 
                 default_config.rpcs.diagnose_cluster.timeout = 300.0
                 default_config.rpcs.diagnose_cluster.retry_policy = {
-                  initial_delay: 0.1,
-              max_delay: 60.0,
-              multiplier: 1.3,
-              retry_codes: [14]
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
                 }
 
                 default_config
@@ -141,19 +124,15 @@ module Google
             ##
             # Create a new ClusterController client object.
             #
-            # ## Examples
-            #
-            # To create a new ClusterController client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new
             #
-            # To create a new ClusterController client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the ClusterController client.
             # @yieldparam config [Client::Configuration]
@@ -173,14 +152,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(String) || credentials.is_a?(Hash)
+              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
               @quota_project_id = @config.quota_project
@@ -237,9 +215,9 @@ module Google
             #   @param cluster [::Google::Cloud::Dataproc::V1::Cluster, ::Hash]
             #     Required. The cluster to create.
             #   @param request_id [::String]
-            #     Optional. A unique id used to identify the request. If the server
-            #     receives two {::Google::Cloud::Dataproc::V1::CreateClusterRequest CreateClusterRequest} requests  with the same
-            #     id, then the second request will be ignored and the
+            #     Optional. A unique id used to identify the request. If the server receives two
+            #     [CreateClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.CreateClusterRequest)s
+            #     with the same id, then the second request will be ignored and the
             #     first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the backend
             #     is returned.
             #
@@ -284,7 +262,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.create_cluster.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_cluster.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :create_cluster, request, options: options do |response, operation|
@@ -389,8 +369,9 @@ module Google
             #      </table>
             #   @param request_id [::String]
             #     Optional. A unique id used to identify the request. If the server
-            #     receives two {::Google::Cloud::Dataproc::V1::UpdateClusterRequest UpdateClusterRequest} requests  with the same
-            #     id, then the second request will be ignored and the
+            #     receives two
+            #     [UpdateClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.UpdateClusterRequest)s
+            #     with the same id, then the second request will be ignored and the
             #     first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
             #     backend is returned.
             #
@@ -436,7 +417,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.update_cluster.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_cluster.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :update_cluster, request, options: options do |response, operation|
@@ -448,6 +431,190 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Stops a cluster in a project.
+            #
+            # @overload stop_cluster(request, options = nil)
+            #   Pass arguments to `stop_cluster` via a request object, either of type
+            #   {::Google::Cloud::Dataproc::V1::StopClusterRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dataproc::V1::StopClusterRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload stop_cluster(project_id: nil, region: nil, cluster_name: nil, cluster_uuid: nil, request_id: nil)
+            #   Pass arguments to `stop_cluster` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param project_id [::String]
+            #     Required. The ID of the Google Cloud Platform project the
+            #     cluster belongs to.
+            #   @param region [::String]
+            #     Required. The Dataproc region in which to handle the request.
+            #   @param cluster_name [::String]
+            #     Required. The cluster name.
+            #   @param cluster_uuid [::String]
+            #     Optional. Specifying the `cluster_uuid` means the RPC will fail
+            #     (with error NOT_FOUND) if a cluster with the specified UUID does not exist.
+            #   @param request_id [::String]
+            #     Optional. A unique id used to identify the request. If the server
+            #     receives two
+            #     [StopClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.StopClusterRequest)s
+            #     with the same id, then the second request will be ignored and the
+            #     first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
+            #     backend is returned.
+            #
+            #     Recommendation: Set this value to a
+            #     [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+            #
+            #     The id must contain only letters (a-z, A-Z), numbers (0-9),
+            #     underscores (_), and hyphens (-). The maximum length is 40 characters.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def stop_cluster request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataproc::V1::StopClusterRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.stop_cluster.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dataproc::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "project_id" => request.project_id,
+                "region" => request.region,
+                "cluster_name" => request.cluster_name
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.stop_cluster.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.stop_cluster.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @cluster_controller_stub.call_rpc :stop_cluster, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Starts a cluster in a project.
+            #
+            # @overload start_cluster(request, options = nil)
+            #   Pass arguments to `start_cluster` via a request object, either of type
+            #   {::Google::Cloud::Dataproc::V1::StartClusterRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dataproc::V1::StartClusterRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload start_cluster(project_id: nil, region: nil, cluster_name: nil, cluster_uuid: nil, request_id: nil)
+            #   Pass arguments to `start_cluster` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param project_id [::String]
+            #     Required. The ID of the Google Cloud Platform project the
+            #     cluster belongs to.
+            #   @param region [::String]
+            #     Required. The Dataproc region in which to handle the request.
+            #   @param cluster_name [::String]
+            #     Required. The cluster name.
+            #   @param cluster_uuid [::String]
+            #     Optional. Specifying the `cluster_uuid` means the RPC will fail
+            #     (with error NOT_FOUND) if a cluster with the specified UUID does not exist.
+            #   @param request_id [::String]
+            #     Optional. A unique id used to identify the request. If the server
+            #     receives two
+            #     [StartClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.StartClusterRequest)s
+            #     with the same id, then the second request will be ignored and the
+            #     first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
+            #     backend is returned.
+            #
+            #     Recommendation: Set this value to a
+            #     [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+            #
+            #     The id must contain only letters (a-z, A-Z), numbers (0-9),
+            #     underscores (_), and hyphens (-). The maximum length is 40 characters.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def start_cluster request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataproc::V1::StartClusterRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.start_cluster.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dataproc::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "project_id" => request.project_id,
+                "region" => request.region,
+                "cluster_name" => request.cluster_name
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.start_cluster.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.start_cluster.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @cluster_controller_stub.call_rpc :start_cluster, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Deletes a cluster in a project. The returned
             # {::Google::Longrunning::Operation#metadata Operation.metadata} will be
@@ -480,8 +647,9 @@ module Google
             #     (with error NOT_FOUND) if cluster with specified UUID does not exist.
             #   @param request_id [::String]
             #     Optional. A unique id used to identify the request. If the server
-            #     receives two {::Google::Cloud::Dataproc::V1::DeleteClusterRequest DeleteClusterRequest} requests  with the same
-            #     id, then the second request will be ignored and the
+            #     receives two
+            #     [DeleteClusterRequest](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#google.cloud.dataproc.v1.DeleteClusterRequest)s
+            #     with the same id, then the second request will be ignored and the
             #     first {::Google::Longrunning::Operation google.longrunning.Operation} created and stored in the
             #     backend is returned.
             #
@@ -527,7 +695,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.delete_cluster.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_cluster.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :delete_cluster, request, options: options do |response, operation|
@@ -601,7 +771,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.get_cluster.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_cluster.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :get_cluster, request, options: options do |response, operation|
@@ -695,7 +867,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_clusters.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_clusters.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :list_clusters, request, options: options do |response, operation|
@@ -775,7 +949,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.diagnose_cluster.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.diagnose_cluster.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @cluster_controller_stub.call_rpc :diagnose_cluster, request, options: options do |response, operation|
@@ -800,22 +976,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for create_cluster
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
+            # @example
             #
-            #     ::Google::Cloud::Dataproc::V1::ClusterController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_cluster.timeout = 20.0
-            #     end
+            #   # Modify the global config, setting the timeout for
+            #   # create_cluster to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Dataproc::V1::ClusterController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_cluster.timeout = 20.0
+            #   end
             #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.create_cluster.timeout = 20.0
-            #     end
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Dataproc::V1::ClusterController::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.create_cluster.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.
@@ -934,6 +1109,16 @@ module Google
                 #
                 attr_reader :update_cluster
                 ##
+                # RPC-specific configuration for `stop_cluster`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :stop_cluster
+                ##
+                # RPC-specific configuration for `start_cluster`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :start_cluster
+                ##
                 # RPC-specific configuration for `delete_cluster`
                 # @return [::Gapic::Config::Method]
                 #
@@ -960,6 +1145,10 @@ module Google
                   @create_cluster = ::Gapic::Config::Method.new create_cluster_config
                   update_cluster_config = parent_rpcs.update_cluster if parent_rpcs.respond_to? :update_cluster
                   @update_cluster = ::Gapic::Config::Method.new update_cluster_config
+                  stop_cluster_config = parent_rpcs.stop_cluster if parent_rpcs.respond_to? :stop_cluster
+                  @stop_cluster = ::Gapic::Config::Method.new stop_cluster_config
+                  start_cluster_config = parent_rpcs.start_cluster if parent_rpcs.respond_to? :start_cluster
+                  @start_cluster = ::Gapic::Config::Method.new start_cluster_config
                   delete_cluster_config = parent_rpcs.delete_cluster if parent_rpcs.respond_to? :delete_cluster
                   @delete_cluster = ::Gapic::Config::Method.new delete_cluster_config
                   get_cluster_config = parent_rpcs.get_cluster if parent_rpcs.respond_to? :get_cluster