google-cloud-dataproc 0.2.2 → 0.3.0

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -18,7 +18,7 @@ module Google
     module Dataproc
       module V1
         # Describes the identifying information, config, and status of
-        # a cluster of Google Compute Engine instances.
+        # a cluster of Compute Engine instances.
         # @!attribute [rw] project_id
         #   @return [String]
         #     Required. The Google Cloud Platform project ID that the cluster belongs to.
@@ -40,13 +40,13 @@ module Google
         #     No more than 32 labels can be associated with a cluster.
         # @!attribute [rw] status
         #   @return [Google::Cloud::Dataproc::V1::ClusterStatus]
-        #     Output-only. Cluster status.
+        #     Output only. Cluster status.
         # @!attribute [rw] status_history
         #   @return [Array<Google::Cloud::Dataproc::V1::ClusterStatus>]
-        #     Output-only. The previous cluster status.
+        #     Output only. The previous cluster status.
         # @!attribute [rw] cluster_uuid
         #   @return [String]
-        #     Output-only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
+        #     Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
         #     generates this value when it creates the cluster.
         # @!attribute [rw] metrics
         #   @return [Google::Cloud::Dataproc::V1::ClusterMetrics]
@@ -59,7 +59,7 @@ module Google
         # The cluster config.
         # @!attribute [rw] config_bucket
         #   @return [String]
-        #     Optional. A Google Cloud Storage staging bucket used for sharing generated
+        #     Optional. A Cloud Storage staging bucket used for sharing generated
         #     SSH keys and config. If you do not specify a staging bucket, Cloud
         #     Dataproc will determine an appropriate Cloud Storage location (US,
         #     ASIA, or EU) for your cluster's staging bucket according to the Google
@@ -67,19 +67,19 @@ module Google
         #     and manage this project-level, per-location bucket for you.
         # @!attribute [rw] gce_cluster_config
         #   @return [Google::Cloud::Dataproc::V1::GceClusterConfig]
-        #     Required. The shared Google Compute Engine config settings for
+        #     Required. The shared Compute Engine config settings for
         #     all instances in a cluster.
         # @!attribute [rw] master_config
         #   @return [Google::Cloud::Dataproc::V1::InstanceGroupConfig]
-        #     Optional. The Google Compute Engine config settings for
+        #     Optional. The Compute Engine config settings for
         #     the master instance in a cluster.
         # @!attribute [rw] worker_config
         #   @return [Google::Cloud::Dataproc::V1::InstanceGroupConfig]
-        #     Optional. The Google Compute Engine config settings for
+        #     Optional. The Compute Engine config settings for
         #     worker instances in a cluster.
         # @!attribute [rw] secondary_worker_config
         #   @return [Google::Cloud::Dataproc::V1::InstanceGroupConfig]
-        #     Optional. The Google Compute Engine config settings for
+        #     Optional. The Compute Engine config settings for
         #     additional worker instances in a cluster.
         # @!attribute [rw] software_config
         #   @return [Google::Cloud::Dataproc::V1::SoftwareConfig]
@@ -97,13 +97,23 @@ module Google
         #         else
         #           ... worker specific actions ...
         #         fi
+        # @!attribute [rw] encryption_config
+        #   @return [Google::Cloud::Dataproc::V1::EncryptionConfig]
+        #     Optional. Encryption settings for the cluster.
         class ClusterConfig; end
 
-        # Common config settings for resources of Google Compute Engine cluster
+        # Encryption settings for the cluster.
+        # @!attribute [rw] gce_pd_kms_key_name
+        #   @return [String]
+        #     Optional. The Cloud KMS key name to use for PD disk encryption for all
+        #     instances in the cluster.
+        class EncryptionConfig; end
+
+        # Common config settings for resources of Compute Engine cluster
         # instances, applicable to all instances in the cluster.
         # @!attribute [rw] zone_uri
         #   @return [String]
-        #     Optional. The zone where the Google Compute Engine cluster will be located.
+        #     Optional. The zone where the Compute Engine cluster will be located.
         #     On a create request, it is required in the "global" region. If omitted
         #     in a non-global Cloud Dataproc region, the service will pick a zone in the
         #     corresponding Compute Engine region. On a get request, zone will
@@ -116,7 +126,7 @@ module Google
         #     * `us-central1-f`
         # @!attribute [rw] network_uri
         #   @return [String]
-        #     Optional. The Google Compute Engine network to be used for machine
+        #     Optional. The Compute Engine network to be used for machine
         #     communications. Cannot be specified with subnetwork_uri. If neither
         #     `network_uri` nor `subnetwork_uri` is specified, the "default" network of
         #     the project is used, if it exists. Cannot be a "Custom Subnet Network" (see
@@ -129,7 +139,7 @@ module Google
         #     * `default`
         # @!attribute [rw] subnetwork_uri
         #   @return [String]
-        #     Optional. The Google Compute Engine subnetwork to be used for machine
+        #     Optional. The Compute Engine subnetwork to be used for machine
         #     communications. Cannot be specified with network_uri.
         #
         #     A full URL, partial URI, or short name are valid. Examples:
@@ -148,8 +158,8 @@ module Google
         # @!attribute [rw] service_account
         #   @return [String]
         #     Optional. The service account of the instances. Defaults to the default
-        #     Google Compute Engine service account. Custom service accounts need
-        #     permissions equivalent to the folloing IAM roles:
+        #     Compute Engine service account. Custom service accounts need
+        #     permissions equivalent to the following IAM roles:
         #
         #     * roles/logging.logWriter
         #     * roles/storage.objectAdmin
@@ -159,7 +169,7 @@ module Google
         #     Example: `[account_id]@[project_id].iam.gserviceaccount.com`
         # @!attribute [rw] service_account_scopes
         #   @return [Array<String>]
-        #     Optional. The URIs of service account scopes to be included in Google
+        #     Optional. The URIs of service account scopes to be included in
         #     Compute Engine instances. The following base set of scopes is always
         #     included:
         #
@@ -175,15 +185,15 @@ module Google
         #     * https://www.googleapis.com/auth/devstorage.full_control
         # @!attribute [rw] tags
         #   @return [Array<String>]
-        #     The Google Compute Engine tags to add to all instances (see
+        #     The Compute Engine tags to add to all instances (see
         #     [Tagging instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)).
         # @!attribute [rw] metadata
         #   @return [Hash{String => String}]
-        #     The Google Compute Engine metadata entries to add to all instances (see
+        #     The Compute Engine metadata entries to add to all instances (see
         #     [Project and instance metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
         class GceClusterConfig; end
 
-        # Optional. The config settings for Google Compute Engine resources in
+        # Optional. The config settings for Compute Engine resources in
         # an instance group, such as a master or worker group.
         # @!attribute [rw] num_instances
         #   @return [Integer]
@@ -191,22 +201,27 @@ module Google
         #     For master instance groups, must be set to 1.
         # @!attribute [rw] instance_names
         #   @return [Array<String>]
-        #     Optional. The list of instance names. Cloud Dataproc derives the names from
-        #     `cluster_name`, `num_instances`, and the instance group if not set by user
-        #     (recommended practice is to let Cloud Dataproc derive the name).
+        #     Output only. The list of instance names. Cloud Dataproc derives the names
+        #     from `cluster_name`, `num_instances`, and the instance group.
         # @!attribute [rw] image_uri
         #   @return [String]
-        #     Output-only. The Google Compute Engine image resource used for cluster
-        #     instances. Inferred from `SoftwareConfig.image_version`.
+        #     Optional. The Compute Engine image resource used for cluster
+        #     instances. It can be specified or may be inferred from
+        #     `SoftwareConfig.image_version`.
         # @!attribute [rw] machine_type_uri
         #   @return [String]
-        #     Optional. The Google Compute Engine machine type used for cluster instances.
+        #     Optional. The Compute Engine machine type used for cluster instances.
         #
         #     A full URL, partial URI, or short name are valid. Examples:
         #
         #     * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
         #     * `projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
         #     * `n1-standard-2`
+        #
+        #     **Auto Zone Exception**: If you are using the Cloud Dataproc
+        #     [Auto Zone Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
+        #     feature, you must use the short name of the machine type
+        #     resource, for example, `n1-standard-2`.
         # @!attribute [rw] disk_config
         #   @return [Google::Cloud::Dataproc::V1::DiskConfig]
         #     Optional. Disk option config settings.
@@ -215,12 +230,12 @@ module Google
         #     Optional. Specifies that this instance group contains preemptible instances.
         # @!attribute [rw] managed_group_config
         #   @return [Google::Cloud::Dataproc::V1::ManagedGroupConfig]
-        #     Output-only. The config for Google Compute Engine Instance Group
+        #     Output only. The config for Compute Engine Instance Group
         #     Manager that manages this group.
         #     This is only used for preemptible instance groups.
         # @!attribute [rw] accelerators
         #   @return [Array<Google::Cloud::Dataproc::V1::AcceleratorConfig>]
-        #     Optional. The Google Compute Engine accelerator configuration for these
+        #     Optional. The Compute Engine accelerator configuration for these
         #     instances.
         #
         #     **Beta Feature**: This feature is still under development. It may be
@@ -230,31 +245,42 @@ module Google
         # Specifies the resources used to actively manage an instance group.
         # @!attribute [rw] instance_template_name
         #   @return [String]
-        #     Output-only. The name of the Instance Template used for the Managed
+        #     Output only. The name of the Instance Template used for the Managed
         #     Instance Group.
         # @!attribute [rw] instance_group_manager_name
         #   @return [String]
-        #     Output-only. The name of the Instance Group Manager for this group.
+        #     Output only. The name of the Instance Group Manager for this group.
         class ManagedGroupConfig; end
 
         # Specifies the type and number of accelerator cards attached to the instances
-        # of an instance group (see [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus/)).
+        # of an instance. See [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus/).
         # @!attribute [rw] accelerator_type_uri
         #   @return [String]
         #     Full URL, partial URI, or short name of the accelerator type resource to
-        #     expose to this instance. See [Google Compute Engine AcceleratorTypes](
-        #     /compute/docs/reference/beta/acceleratorTypes)
+        #     expose to this instance. See
+        #     [Compute Engine AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes).
+        #
+        #     Examples:
         #
-        #     Examples
         #     * `https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80`
         #     * `projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80`
         #     * `nvidia-tesla-k80`
+        #
+        #     **Auto Zone Exception**: If you are using the Cloud Dataproc
+        #     [Auto Zone Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement)
+        #     feature, you must use the short name of the accelerator type
+        #     resource, for example, `nvidia-tesla-k80`.
         # @!attribute [rw] accelerator_count
         #   @return [Integer]
         #     The number of the accelerator cards of this type exposed to this instance.
         class AcceleratorConfig; end
 
         # Specifies the config of disk options for a group of VM instances.
+        # @!attribute [rw] boot_disk_type
+        #   @return [String]
+        #     Optional. Type of the boot disk (default is "pd-standard").
+        #     Valid values: "pd-ssd" (Persistent Disk Solid State Drive) or
+        #     "pd-standard" (Persistent Disk Hard Disk Drive).
         # @!attribute [rw] boot_disk_size_gb
         #   @return [Integer]
         #     Optional. Size in GB of the boot disk (default is 500GB).
@@ -272,7 +298,7 @@ module Google
         # timeout period for executable completion.
         # @!attribute [rw] executable_file
         #   @return [String]
-        #     Required. Google Cloud Storage URI of executable file.
+        #     Required. Cloud Storage URI of executable file.
         # @!attribute [rw] execution_timeout
         #   @return [Google::Protobuf::Duration]
         #     Optional. Amount of time executable has to complete. Default is
@@ -284,16 +310,16 @@ module Google
         # The status of a cluster and its instances.
         # @!attribute [rw] state
         #   @return [Google::Cloud::Dataproc::V1::ClusterStatus::State]
-        #     Output-only. The cluster's state.
+        #     Output only. The cluster's state.
         # @!attribute [rw] detail
         #   @return [String]
-        #     Output-only. Optional details of cluster's state.
+        #     Output only. Optional details of cluster's state.
         # @!attribute [rw] state_start_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Output-only. Time when this state was entered.
+        #     Output only. Time when this state was entered.
         # @!attribute [rw] substate
         #   @return [Google::Cloud::Dataproc::V1::ClusterStatus::Substate]
-        #     Output-only. Additional state information that includes
+        #     Output only. Additional state information that includes
         #     status reported by the agent.
         class ClusterStatus
           # The cluster state.
@@ -317,7 +343,9 @@ module Google
             UPDATING = 5
           end
 
+          # The cluster substate.
           module Substate
+            # The cluster substate is unknown.
             UNSPECIFIED = 0
 
             # The cluster is known to be in an unhealthy state
@@ -338,9 +366,11 @@ module Google
         # Specifies the selection and config of software inside the cluster.
         # @!attribute [rw] image_version
         #   @return [String]
-        #     Optional. The version of software inside the cluster. It must match the
-        #     regular expression `[0-9]+\.[0-9]+`. If unspecified, it defaults to the
-        #     latest version (see [Cloud Dataproc Versioning](https://cloud.google.com/dataproc/versioning)).
+        #     Optional. The version of software inside the cluster. It must be one of the supported
+        #     [Cloud Dataproc Versions](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions),
+        #     such as "1.2" (including a subminor version, such as "1.2.29"), or the
+        #     ["preview" version](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#other_versions).
+        #     If unspecified, it defaults to the latest version.
         # @!attribute [rw] properties
         #   @return [Hash{String => String}]
         #     Optional. The properties to set on daemon config files.
@@ -386,6 +416,19 @@ module Google
         # @!attribute [rw] cluster
         #   @return [Google::Cloud::Dataproc::V1::Cluster]
         #     Required. The cluster to create.
+        # @!attribute [rw] request_id
+        #   @return [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
+        #     first {Google::Longrunning::Operation} created and stored in the backend
+        #     is returned.
+        #
+        #     It is recommended to always 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.
         class CreateClusterRequest; end
 
         # A request to update a cluster.
@@ -402,6 +445,16 @@ module Google
         # @!attribute [rw] cluster
         #   @return [Google::Cloud::Dataproc::V1::Cluster]
         #     Required. The changes to the cluster.
+        # @!attribute [rw] graceful_decommission_timeout
+        #   @return [Google::Protobuf::Duration]
+        #     Optional. Timeout for graceful YARN decomissioning. Graceful
+        #     decommissioning allows removing nodes from the cluster without
+        #     interrupting jobs in progress. Timeout specifies how long to wait for jobs
+        #     in progress to finish before forcefully removing nodes (and potentially
+        #     interrupting jobs). Default timeout is 0 (for forceful decommission), and
+        #     the maximum allowed timeout is 1 day.
+        #
+        #     Only supported on Dataproc image versions 1.2 and higher.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
         #     Required. Specifies the path, relative to `Cluster`, of
@@ -451,6 +504,19 @@ module Google
         #      </tr>
         #      </tbody>
         #      </table>
+        # @!attribute [rw] request_id
+        #   @return [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
+        #     first {Google::Longrunning::Operation} created and stored in the
+        #     backend is returned.
+        #
+        #     It is recommended to always 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.
         class UpdateClusterRequest; end
 
         # A request to delete a cluster.
@@ -464,6 +530,23 @@ module Google
         # @!attribute [rw] cluster_name
         #   @return [String]
         #     Required. The cluster name.
+        # @!attribute [rw] cluster_uuid
+        #   @return [String]
+        #     Optional. Specifying the `cluster_uuid` means the RPC should fail
+        #     (with error NOT_FOUND) if cluster with specified UUID does not exist.
+        # @!attribute [rw] request_id
+        #   @return [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
+        #     first {Google::Longrunning::Operation} created and stored in the
+        #     backend is returned.
+        #
+        #     It is recommended to always 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.
         class DeleteClusterRequest; end
 
         # Request to get the resource representation for a cluster in a project.
@@ -519,10 +602,10 @@ module Google
         # The list of all clusters in a project.
         # @!attribute [rw] clusters
         #   @return [Array<Google::Cloud::Dataproc::V1::Cluster>]
-        #     Output-only. The clusters in the project.
+        #     Output only. The clusters in the project.
         # @!attribute [rw] next_page_token
         #   @return [String]
-        #     Output-only. This token is included in the response if there are more
+        #     Output only. This token is included in the response if there are more
         #     results to fetch. To fetch additional results, provide this value as the
         #     `page_token` in a subsequent `ListClustersRequest`.
         class ListClustersResponse; end
@@ -543,7 +626,7 @@ module Google
         # The location of diagnostic output.
         # @!attribute [rw] output_uri
         #   @return [String]
-        #     Output-only. The Google Cloud Storage URI of the diagnostic output.
+        #     Output only. The Cloud Storage URI of the diagnostic output.
         #     The output report is a plain text file with a summary of collected
         #     diagnostics.
         class DiagnoseClusterResults; end

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -292,24 +292,24 @@ module Google
         #     Required. The name of the cluster where the job will be submitted.
         # @!attribute [rw] cluster_uuid
         #   @return [String]
-        #     Output-only. A cluster UUID generated by the Cloud Dataproc service when
+        #     Output only. A cluster UUID generated by the Cloud Dataproc service when
         #     the job is submitted.
         class JobPlacement; end
 
         # Cloud Dataproc job status.
         # @!attribute [rw] state
         #   @return [Google::Cloud::Dataproc::V1::JobStatus::State]
-        #     Output-only. A state message specifying the overall job state.
+        #     Output only. A state message specifying the overall job state.
         # @!attribute [rw] details
         #   @return [String]
-        #     Output-only. Optional job state details, such as an error
+        #     Output only. Optional job state details, such as an error
         #     description if the state is <code>ERROR</code>.
         # @!attribute [rw] state_start_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Output-only. The time when this state was entered.
+        #     Output only. The time when this state was entered.
         # @!attribute [rw] substate
         #   @return [Google::Cloud::Dataproc::V1::JobStatus::Substate]
-        #     Output-only. Additional state information, which includes
+        #     Output only. Additional state information, which includes
         #     status reported by the agent.
         class JobStatus
           # The job state.
@@ -350,7 +350,9 @@ module Google
             ATTEMPT_FAILURE = 9
           end
 
+          # The job substate.
           module Substate
+            # The job substate is unknown.
             UNSPECIFIED = 0
 
             # The Job is submitted to the agent.
@@ -472,25 +474,25 @@ module Google
         #     Job is a SparkSql job.
         # @!attribute [rw] status
         #   @return [Google::Cloud::Dataproc::V1::JobStatus]
-        #     Output-only. The job status. Additional application-specific
+        #     Output only. The job status. Additional application-specific
         #     status information may be contained in the <code>type_job</code>
         #     and <code>yarn_applications</code> fields.
         # @!attribute [rw] status_history
         #   @return [Array<Google::Cloud::Dataproc::V1::JobStatus>]
-        #     Output-only. The previous job status.
+        #     Output only. The previous job status.
         # @!attribute [rw] yarn_applications
         #   @return [Array<Google::Cloud::Dataproc::V1::YarnApplication>]
-        #     Output-only. The collection of YARN applications spun up by this job.
+        #     Output only. The collection of YARN applications spun up by this job.
         #
         #     **Beta** Feature: This report is available for testing purposes only. It may
         #     be changed before final release.
         # @!attribute [rw] driver_output_resource_uri
         #   @return [String]
-        #     Output-only. A URI pointing to the location of the stdout of the job's
+        #     Output only. A URI pointing to the location of the stdout of the job's
         #     driver program.
         # @!attribute [rw] driver_control_files_uri
         #   @return [String]
-        #     Output-only. If present, the location of miscellaneous control files
+        #     Output only. If present, the location of miscellaneous control files
         #     which may be used as part of job setup and handling. If not present,
         #     control files may be placed in the same location as `driver_output_uri`.
         # @!attribute [rw] labels
@@ -504,12 +506,14 @@ module Google
         # @!attribute [rw] scheduling
         #   @return [Google::Cloud::Dataproc::V1::JobScheduling]
         #     Optional. Job scheduling configuration.
+        # @!attribute [rw] job_uuid
+        #   @return [String]
+        #     Output only. A UUID that uniquely identifies a job within the project
+        #     over time. This is in contrast to a user-settable reference.job_id that
+        #     may be reused over time.
         class Job; end
 
         # Job scheduling options.
-        #
-        # **Beta Feature**: These options are available for testing purposes only.
-        # They may be changed before final release.
         # @!attribute [rw] max_failures_per_hour
         #   @return [Integer]
         #     Optional. Maximum number of times per hour a driver may be restarted as
@@ -533,6 +537,19 @@ module Google
         # @!attribute [rw] job
         #   @return [Google::Cloud::Dataproc::V1::Job]
         #     Required. The job resource.
+        # @!attribute [rw] request_id
+        #   @return [String]
+        #     Optional. A unique id used to identify the request. If the server
+        #     receives two {Google::Cloud::Dataproc::V1::SubmitJobRequest SubmitJobRequest} requests  with the same
+        #     id, then the second request will be ignored and the
+        #     first {Google::Cloud::Dataproc::V1::Job Job} created and stored in the backend
+        #     is returned.
+        #
+        #     It is recommended to always 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.
         class SubmitJobRequest; end
 
         # A request to get the resource representation for a job in a project.
@@ -631,7 +648,7 @@ module Google
         # A list of jobs in a project.
         # @!attribute [rw] jobs
         #   @return [Array<Google::Cloud::Dataproc::V1::Job>]
-        #     Output-only. Jobs list.
+        #     Output only. Jobs list.
         # @!attribute [rw] next_page_token
         #   @return [String]
         #     Optional. This token is included in the response if there are more results