google-cloud-dataproc-v1 1.0.2 → 1.2.0

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

@@ -24,7 +24,7 @@ module Google
         # The runtime logging config of the job.
         # @!attribute [rw] driver_log_levels
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dataproc::V1::LoggingConfig::Level}]
-        #     The per-package log levels for the driver. This may include
+        #     The per-package log levels for the driver. This can include
         #     "root" package name to configure rootLogger.
         #     Examples:
         #     - 'com.google = FATAL'
@@ -88,15 +88,19 @@ module Google
         #         'gs://foo-bucket/analytics-binaries/extract-useful-metrics-mr.jar'
         #         'hdfs:/tmp/test-samples/custom-wordcount.jar'
         #         'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar'
+        #
+        #     Note: The following fields are mutually exclusive: `main_jar_file_uri`, `main_class`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] main_class
         #   @return [::String]
         #     The name of the driver's main class. The jar file containing the class
         #     must be in the default CLASSPATH or specified in `jar_file_uris`.
+        #
+        #     Note: The following fields are mutually exclusive: `main_class`, `main_jar_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] args
         #   @return [::Array<::String>]
         #     Optional. The arguments to pass to the driver. Do not
         #     include arguments, such as `-libjars` or `-Dfoo=bar`, that can be set as
-        #     job properties, since a collision may occur that causes an incorrect job
+        #     job properties, since a collision might occur that causes an incorrect job
         #     submission.
         # @!attribute [rw] jar_file_uris
         #   @return [::Array<::String>]
@@ -115,7 +119,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure Hadoop.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in `/etc/hadoop/conf/*-site` and
         #     classes in user code.
         # @!attribute [rw] logging_config
@@ -140,10 +144,15 @@ module Google
         # @!attribute [rw] main_jar_file_uri
         #   @return [::String]
         #     The HCFS URI of the jar file that contains the main class.
+        #
+        #     Note: The following fields are mutually exclusive: `main_jar_file_uri`, `main_class`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] main_class
         #   @return [::String]
         #     The name of the driver's main class. The jar file that contains the class
-        #     must be in the default CLASSPATH or specified in `jar_file_uris`.
+        #     must be in the default CLASSPATH or specified in
+        #     SparkJob.jar_file_uris.
+        #
+        #     Note: The following fields are mutually exclusive: `main_class`, `main_jar_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] args
         #   @return [::Array<::String>]
         #     Optional. The arguments to pass to the driver. Do not include arguments,
@@ -165,7 +174,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure Spark.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in
         #     /etc/spark/conf/spark-defaults.conf and classes in user code.
         # @!attribute [rw] logging_config
@@ -218,7 +227,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure PySpark.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in
         #     /etc/spark/conf/spark-defaults.conf and classes in user code.
         # @!attribute [rw] logging_config
@@ -265,9 +274,13 @@ module Google
         # @!attribute [rw] query_file_uri
         #   @return [::String]
         #     The HCFS URI of the script that contains Hive queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_file_uri`, `query_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_list
         #   @return [::Google::Cloud::Dataproc::V1::QueryList]
         #     A list of queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_list`, `query_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] continue_on_failure
         #   @return [::Boolean]
         #     Optional. Whether to continue executing queries if a query fails.
@@ -280,7 +293,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names and values, used to configure Hive.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in `/etc/hadoop/conf/*-site.xml`,
         #     /etc/hive/conf/hive-site.xml, and classes in user code.
         # @!attribute [rw] jar_file_uris
@@ -316,9 +329,13 @@ module Google
         # @!attribute [rw] query_file_uri
         #   @return [::String]
         #     The HCFS URI of the script that contains SQL queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_file_uri`, `query_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_list
         #   @return [::Google::Cloud::Dataproc::V1::QueryList]
         #     A list of queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_list`, `query_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] script_variables
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Mapping of query variable names to values (equivalent to the
@@ -327,7 +344,7 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure
         #     Spark SQL's SparkConf. Properties that conflict with values set by the
-        #     Dataproc API may be overwritten.
+        #     Dataproc API might be overwritten.
         # @!attribute [rw] jar_file_uris
         #   @return [::Array<::String>]
         #     Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH.
@@ -362,9 +379,13 @@ module Google
         # @!attribute [rw] query_file_uri
         #   @return [::String]
         #     The HCFS URI of the script that contains the Pig queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_file_uri`, `query_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_list
         #   @return [::Google::Cloud::Dataproc::V1::QueryList]
         #     A list of queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_list`, `query_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] continue_on_failure
         #   @return [::Boolean]
         #     Optional. Whether to continue executing queries if a query fails.
@@ -377,7 +398,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure Pig.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in `/etc/hadoop/conf/*-site.xml`,
         #     /etc/pig/conf/pig.properties, and classes in user code.
         # @!attribute [rw] jar_file_uris
@@ -434,7 +455,7 @@ module Google
         # @!attribute [rw] properties
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. A mapping of property names to values, used to configure SparkR.
-        #     Properties that conflict with values set by the Dataproc API may be
+        #     Properties that conflict with values set by the Dataproc API might be
         #     overwritten. Can include properties set in
         #     /etc/spark/conf/spark-defaults.conf and classes in user code.
         # @!attribute [rw] logging_config
@@ -462,9 +483,13 @@ module Google
         # @!attribute [rw] query_file_uri
         #   @return [::String]
         #     The HCFS URI of the script that contains SQL queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_file_uri`, `query_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_list
         #   @return [::Google::Cloud::Dataproc::V1::QueryList]
         #     A list of queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_list`, `query_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] continue_on_failure
         #   @return [::Boolean]
         #     Optional. Whether to continue executing queries if a query fails.
@@ -507,9 +532,13 @@ module Google
         # @!attribute [rw] query_file_uri
         #   @return [::String]
         #     The HCFS URI of the script that contains SQL queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_file_uri`, `query_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_list
         #   @return [::Google::Cloud::Dataproc::V1::QueryList]
         #     A list of queries.
+        #
+        #     Note: The following fields are mutually exclusive: `query_list`, `query_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] continue_on_failure
         #   @return [::Boolean]
         #     Optional. Whether to continue executing queries if a query fails.
@@ -544,6 +573,55 @@ module Google
           end
         end
 
+        # A Dataproc job for running Apache Flink applications on YARN.
+        # @!attribute [rw] main_jar_file_uri
+        #   @return [::String]
+        #     The HCFS URI of the jar file that contains the main class.
+        #
+        #     Note: The following fields are mutually exclusive: `main_jar_file_uri`, `main_class`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] main_class
+        #   @return [::String]
+        #     The name of the driver's main class. The jar file that contains the class
+        #     must be in the default CLASSPATH or specified in
+        #     {::Google::Cloud::Dataproc::V1::FlinkJob#jar_file_uris jarFileUris}.
+        #
+        #     Note: The following fields are mutually exclusive: `main_class`, `main_jar_file_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] args
+        #   @return [::Array<::String>]
+        #     Optional. The arguments to pass to the driver. Do not include arguments,
+        #     such as `--conf`, that can be set as job properties, since a collision
+        #     might occur that causes an incorrect job submission.
+        # @!attribute [rw] jar_file_uris
+        #   @return [::Array<::String>]
+        #     Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+        #     Flink driver and tasks.
+        # @!attribute [rw] savepoint_uri
+        #   @return [::String]
+        #     Optional. HCFS URI of the savepoint, which contains the last saved progress
+        #     for starting the current job.
+        # @!attribute [rw] properties
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. A mapping of property names to values, used to configure Flink.
+        #     Properties that conflict with values set by the Dataproc API might be
+        #     overwritten. Can include properties set in
+        #     `/etc/flink/conf/flink-defaults.conf` and classes in user code.
+        # @!attribute [rw] logging_config
+        #   @return [::Google::Cloud::Dataproc::V1::LoggingConfig]
+        #     Optional. The runtime log config for job execution.
+        class FlinkJob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class PropertiesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Dataproc job config.
         # @!attribute [rw] cluster_name
         #   @return [::String]
@@ -577,7 +655,7 @@ module Google
         # @!attribute [r] details
         #   @return [::String]
         #     Optional. Output only. Job state details, such as an error
-        #     description if the state is <code>ERROR</code>.
+        #     description if the state is `ERROR`.
         # @!attribute [r] state_start_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time when this state was entered.
@@ -637,14 +715,14 @@ module Google
             # Applies to RUNNING state.
             SUBMITTED = 1
 
-            # The Job has been received and is awaiting execution (it may be waiting
+            # The Job has been received and is awaiting execution (it might be waiting
             # for a condition to be met). See the "details" field for the reason for
             # the delay.
             #
             # Applies to RUNNING state.
             QUEUED = 2
 
-            # The agent-reported status is out of date, which may be caused by a
+            # The agent-reported status is out of date, which can be caused by a
             # loss of communication between the agent and Dataproc. If the
             # agent does not send a timely update, the job will fail.
             #
@@ -741,34 +819,57 @@ module Google
         # @!attribute [rw] hadoop_job
         #   @return [::Google::Cloud::Dataproc::V1::HadoopJob]
         #     Optional. Job is a Hadoop job.
+        #
+        #     Note: The following fields are mutually exclusive: `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkJob]
         #     Optional. Job is a Spark job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_job`, `hadoop_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] pyspark_job
         #   @return [::Google::Cloud::Dataproc::V1::PySparkJob]
         #     Optional. Job is a PySpark job.
+        #
+        #     Note: The following fields are mutually exclusive: `pyspark_job`, `hadoop_job`, `spark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] hive_job
         #   @return [::Google::Cloud::Dataproc::V1::HiveJob]
         #     Optional. Job is a Hive job.
+        #
+        #     Note: The following fields are mutually exclusive: `hive_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] pig_job
         #   @return [::Google::Cloud::Dataproc::V1::PigJob]
         #     Optional. Job is a Pig job.
+        #
+        #     Note: The following fields are mutually exclusive: `pig_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_r_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkRJob]
         #     Optional. Job is a SparkR job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_r_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_sql_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkSqlJob]
         #     Optional. Job is a SparkSql job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_sql_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] presto_job
         #   @return [::Google::Cloud::Dataproc::V1::PrestoJob]
         #     Optional. Job is a Presto job.
+        #
+        #     Note: The following fields are mutually exclusive: `presto_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] trino_job
         #   @return [::Google::Cloud::Dataproc::V1::TrinoJob]
         #     Optional. Job is a Trino job.
+        #
+        #     Note: The following fields are mutually exclusive: `trino_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] flink_job
+        #   @return [::Google::Cloud::Dataproc::V1::FlinkJob]
+        #     Optional. Job is a Flink job.
+        #
+        #     Note: The following fields are mutually exclusive: `flink_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] status
         #   @return [::Google::Cloud::Dataproc::V1::JobStatus]
         #     Output only. The job status. Additional application-specific
-        #     status information may be contained in the <code>type_job</code>
+        #     status information might be contained in the <code>type_job</code>
         #     and <code>yarn_applications</code> fields.
         # @!attribute [r] status_history
         #   @return [::Array<::Google::Cloud::Dataproc::V1::JobStatus>]
@@ -778,7 +879,7 @@ module Google
         #     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.
+        #     might be changed before final release.
         # @!attribute [r] driver_output_resource_uri
         #   @return [::String]
         #     Output only. A URI pointing to the location of the stdout of the job's
@@ -786,14 +887,14 @@ module Google
         # @!attribute [r] driver_control_files_uri
         #   @return [::String]
         #     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`.
+        #     which can be used as part of job setup and handling. If not present,
+        #     control files might be placed in the same location as `driver_output_uri`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. The labels to associate with this job.
         #     Label **keys** must contain 1 to 63 characters, and must conform to
         #     [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
-        #     Label **values** may be empty, but, if present, must contain 1 to 63
+        #     Label **values** can be empty, but, if present, must contain 1 to 63
         #     characters, and must conform to [RFC
         #     1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be
         #     associated with a job.
@@ -804,7 +905,7 @@ module Google
         #   @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.
+        #     might be reused over time.
         # @!attribute [r] done
         #   @return [::Boolean]
         #     Output only. Indicates whether the job is completed. If the value is
@@ -843,12 +944,12 @@ module Google
         # Job scheduling options.
         # @!attribute [rw] max_failures_per_hour
         #   @return [::Integer]
-        #     Optional. Maximum number of times per hour a driver may be restarted as
+        #     Optional. Maximum number of times per hour a driver can be restarted as
         #     a result of driver exiting with non-zero code before job is
         #     reported failed.
         #
-        #     A job may be reported as thrashing if the driver exits with a non-zero code
-        #     four times within a 10-minute window.
+        #     A job might be reported as thrashing if the driver exits with a non-zero
+        #     code four times within a 10-minute window.
         #
         #     Maximum value is 10.
         #
@@ -857,7 +958,7 @@ module Google
         #     (https://cloud.google.com/dataproc/docs/concepts/workflows/using-workflows#adding_jobs_to_a_template).
         # @!attribute [rw] max_failures_total
         #   @return [::Integer]
-        #     Optional. Maximum total number of times a driver may be restarted as a
+        #     Optional. Maximum total number of times a driver can be restarted as a
         #     result of the driver exiting with a non-zero code. After the maximum number
         #     is reached, the job will be reported as failed.
         #
@@ -1031,6 +1132,12 @@ module Google
         #     Optional. 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 <code>ListJobsRequest</code>.
+        # @!attribute [r] unreachable
+        #   @return [::Array<::String>]
+        #     Output only. List of jobs with
+        #     {::Google::Cloud::Dataproc::V1::EncryptionConfig#kms_key kms_key}-encrypted
+        #     parameters that could not be decrypted. A response to a `jobs.get` request
+        #     may indicate the reason for the decryption failure for a specific job.
         class ListJobsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -109,6 +109,13 @@ module Google
         # @!attribute [rw] jupyter_session
         #   @return [::Google::Cloud::Dataproc::V1::JupyterConfig]
         #     Optional. Jupyter session config.
+        #
+        #     Note: The following fields are mutually exclusive: `jupyter_session`, `spark_connect_session`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] spark_connect_session
+        #   @return [::Google::Cloud::Dataproc::V1::SparkConnectConfig]
+        #     Optional. Spark Connect session config.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_connect_session`, `jupyter_session`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] creator
         #   @return [::String]
         #     Output only. The email address of the user who created the template.

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

@@ -82,12 +82,13 @@ module Google
         #     A filter is a logical expression constraining the values of various fields
         #     in each session resource. Filters are case sensitive, and may contain
         #     multiple clauses combined with logical operators (AND, OR).
-        #     Supported fields are `session_id`, `session_uuid`, `state`, and
-        #     `create_time`.
+        #     Supported fields are `session_id`, `session_uuid`, `state`, `create_time`,
+        #     and `labels`.
         #
         #     Example: `state = ACTIVE and create_time < "2023-01-01T00:00:00Z"`
         #     is a filter for sessions in an ACTIVE state that were created before
-        #     2023-01-01.
+        #     2023-01-01. `state = ACTIVE and labels.environment=production` is a filter
+        #     for sessions in an ACTIVE state that have a production environment label.
         #
         #     See https://google.aip.dev/assets/misc/ebnf-filtering.txt for a detailed
         #     description of the filter syntax and a list of supported comparators.
@@ -165,6 +166,13 @@ module Google
         # @!attribute [rw] jupyter_session
         #   @return [::Google::Cloud::Dataproc::V1::JupyterConfig]
         #     Optional. Jupyter session config.
+        #
+        #     Note: The following fields are mutually exclusive: `jupyter_session`, `spark_connect_session`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] spark_connect_session
+        #   @return [::Google::Cloud::Dataproc::V1::SparkConnectConfig]
+        #     Optional. Spark Connect session config.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_connect_session`, `jupyter_session`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] runtime_info
         #   @return [::Google::Cloud::Dataproc::V1::RuntimeInfo]
         #     Output only. Runtime information about session execution.
@@ -289,6 +297,12 @@ module Google
             SCALA = 2
           end
         end
+
+        # Spark Connect configuration for an interactive session.
+        class SparkConnectConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -76,9 +76,13 @@ module Google
         # @!attribute [rw] network_uri
         #   @return [::String]
         #     Optional. Network URI to connect workload to.
+        #
+        #     Note: The following fields are mutually exclusive: `network_uri`, `subnetwork_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] subnetwork_uri
         #   @return [::String]
         #     Optional. Subnetwork URI to connect workload to.
+        #
+        #     Note: The following fields are mutually exclusive: `subnetwork_uri`, `network_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] network_tags
         #   @return [::Array<::String>]
         #     Optional. Tags used for network traffic control.
@@ -563,10 +567,11 @@ module Google
           # Unspecified component. Specifying this will cause Cluster creation to fail.
           COMPONENT_UNSPECIFIED = 0
 
-          # The Anaconda python distribution. The Anaconda component is not supported
-          # in the Dataproc [2.0 image]
-          # (/https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-release-2.0).
-          # The 2.0 image is pre-installed with Miniconda.
+          # The Anaconda component is no longer supported or applicable to
+          # [supported Dataproc on Compute Engine image versions]
+          # (https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-version-clusters#supported-dataproc-image-versions).
+          # It cannot be activated on clusters created with supported Dataproc on
+          # Compute Engine image versions.
           ANACONDA = 5
 
           # Docker

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

@@ -90,10 +90,50 @@ module Google
         #     [managed
         #     cluster](/dataproc/docs/concepts/workflows/using-workflows#configuring_or_selecting_a_cluster),
         #     the cluster is deleted.
+        # @!attribute [rw] encryption_config
+        #   @return [::Google::Cloud::Dataproc::V1::WorkflowTemplate::EncryptionConfig]
+        #     Optional. Encryption settings for encrypting workflow template job
+        #     arguments.
         class WorkflowTemplate
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Encryption settings for encrypting workflow template job arguments.
+          # @!attribute [rw] kms_key
+          #   @return [::String]
+          #     Optional. The Cloud KMS key name to use for encrypting
+          #     workflow template job arguments.
+          #
+          #     When this this key is provided, the following workflow template
+          #     [job arguments]
+          #     (https://cloud.google.com/dataproc/docs/concepts/workflows/use-workflows#adding_jobs_to_a_template),
+          #     if present, are
+          #     [CMEK
+          #     encrypted](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/customer-managed-encryption#use_cmek_with_workflow_template_data):
+          #
+          #     * [FlinkJob
+          #     args](https://cloud.google.com/dataproc/docs/reference/rest/v1/FlinkJob)
+          #     * [HadoopJob
+          #     args](https://cloud.google.com/dataproc/docs/reference/rest/v1/HadoopJob)
+          #     * [SparkJob
+          #     args](https://cloud.google.com/dataproc/docs/reference/rest/v1/SparkJob)
+          #     * [SparkRJob
+          #     args](https://cloud.google.com/dataproc/docs/reference/rest/v1/SparkRJob)
+          #     * [PySparkJob
+          #     args](https://cloud.google.com/dataproc/docs/reference/rest/v1/PySparkJob)
+          #     * [SparkSqlJob](https://cloud.google.com/dataproc/docs/reference/rest/v1/SparkSqlJob)
+          #       scriptVariables and queryList.queries
+          #     * [HiveJob](https://cloud.google.com/dataproc/docs/reference/rest/v1/HiveJob)
+          #       scriptVariables and queryList.queries
+          #     * [PigJob](https://cloud.google.com/dataproc/docs/reference/rest/v1/PigJob)
+          #       scriptVariables and queryList.queries
+          #     * [PrestoJob](https://cloud.google.com/dataproc/docs/reference/rest/v1/PrestoJob)
+          #       scriptVariables and queryList.queries
+          class EncryptionConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -110,12 +150,16 @@ module Google
         # @!attribute [rw] managed_cluster
         #   @return [::Google::Cloud::Dataproc::V1::ManagedCluster]
         #     A cluster that is managed by the workflow.
+        #
+        #     Note: The following fields are mutually exclusive: `managed_cluster`, `cluster_selector`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] cluster_selector
         #   @return [::Google::Cloud::Dataproc::V1::ClusterSelector]
         #     Optional. A selector that chooses target cluster for jobs based
         #     on metadata.
         #
         #     The selector is evaluated at the time each job is submitted.
+        #
+        #     Note: The following fields are mutually exclusive: `cluster_selector`, `managed_cluster`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class WorkflowTemplatePlacement
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -202,27 +246,53 @@ module Google
         # @!attribute [rw] hadoop_job
         #   @return [::Google::Cloud::Dataproc::V1::HadoopJob]
         #     Optional. Job is a Hadoop job.
+        #
+        #     Note: The following fields are mutually exclusive: `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkJob]
         #     Optional. Job is a Spark job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_job`, `hadoop_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] pyspark_job
         #   @return [::Google::Cloud::Dataproc::V1::PySparkJob]
         #     Optional. Job is a PySpark job.
+        #
+        #     Note: The following fields are mutually exclusive: `pyspark_job`, `hadoop_job`, `spark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] hive_job
         #   @return [::Google::Cloud::Dataproc::V1::HiveJob]
         #     Optional. Job is a Hive job.
+        #
+        #     Note: The following fields are mutually exclusive: `hive_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] pig_job
         #   @return [::Google::Cloud::Dataproc::V1::PigJob]
         #     Optional. Job is a Pig job.
+        #
+        #     Note: The following fields are mutually exclusive: `pig_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_r_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkRJob]
         #     Optional. Job is a SparkR job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_r_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_sql_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] spark_sql_job
         #   @return [::Google::Cloud::Dataproc::V1::SparkSqlJob]
         #     Optional. Job is a SparkSql job.
+        #
+        #     Note: The following fields are mutually exclusive: `spark_sql_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `presto_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] presto_job
         #   @return [::Google::Cloud::Dataproc::V1::PrestoJob]
         #     Optional. Job is a Presto job.
+        #
+        #     Note: The following fields are mutually exclusive: `presto_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `trino_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] trino_job
+        #   @return [::Google::Cloud::Dataproc::V1::TrinoJob]
+        #     Optional. Job is a Trino job.
+        #
+        #     Note: The following fields are mutually exclusive: `trino_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `flink_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] flink_job
+        #   @return [::Google::Cloud::Dataproc::V1::FlinkJob]
+        #     Optional. Job is a Flink job.
+        #
+        #     Note: The following fields are mutually exclusive: `flink_job`, `hadoop_job`, `spark_job`, `pyspark_job`, `hive_job`, `pig_job`, `spark_r_job`, `spark_sql_job`, `presto_job`, `trino_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. The labels to associate with this job.
@@ -336,9 +406,13 @@ module Google
         # @!attribute [rw] regex
         #   @return [::Google::Cloud::Dataproc::V1::RegexValidation]
         #     Validation based on regular expressions.
+        #
+        #     Note: The following fields are mutually exclusive: `regex`, `values`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] values
         #   @return [::Google::Cloud::Dataproc::V1::ValueValidation]
         #     Validation based on a list of allowed values.
+        #
+        #     Note: The following fields are mutually exclusive: `values`, `regex`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class ParameterValidation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -691,6 +765,11 @@ module Google
         #     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 <code>ListWorkflowTemplatesRequest</code>.
+        # @!attribute [r] unreachable
+        #   @return [::Array<::String>]
+        #     Output only. List of workflow templates that could not be included in the
+        #     response. Attempting to get one of these resources may indicate why it was
+        #     not included in the list response.
         class ListWorkflowTemplatesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods