google-api-client 0.36.0 → 0.37.0

data/generated/google/apis/dataproc_v1beta2/classes.rb

@@ -37,8 +37,8 @@ module Google
         # 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-k80Auto Zone Exception: If
-        # you are using the Cloud Dataproc Auto Zone Placement feature, you must use the
-        # short name of the accelerator type resource, for example, nvidia-tesla-k80.
+        # you are using the Dataproc Auto Zone Placement feature, you must use the short
+        # name of the accelerator type resource, for example, nvidia-tesla-k80.
         # Corresponds to the JSON property `acceleratorTypeUri`
         # @return [String]
         attr_accessor :accelerator_type_uri
@@ -63,8 +63,7 @@ module Google
         # https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[
         # dataproc_region]/autoscalingPolicies/[policy_id]
         # projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[
-        # policy_id]Note that the policy must be in the same project and Cloud Dataproc
-        # region.
+        # policy_id]Note that the policy must be in the same project and Dataproc region.
         # Corresponds to the JSON property `policyUri`
         # @return [String]
         attr_accessor :policy_uri
@@ -226,10 +225,27 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents an expression text. Example:
-        # title: "User account presence"
-        # description: "Determines whether the request has a user account"
-        # expression: "size(request.user) > 0"
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
+        # documented at https://github.com/google/cel-spec.Example (Comparison):
+        # title: "Summary size limit"
+        # description: "Determines if a summary is less than 100 chars"
+        # expression: "document.summary.size() < 100"
+        # Example (Equality):
+        # title: "Requestor is owner"
+        # description: "Determines if requestor is the document owner"
+        # expression: "document.owner == request.auth.claims.email"
+        # Example (Logic):
+        # title: "Public documents"
+        # description: "Determine whether the document should be publicly visible"
+        # expression: "document.type != 'private' && document.type != 'internal'"
+        # Example (Data Manipulation):
+        # title: "Notification string"
+        # description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)"
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service documentation
+        # for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::DataprocV1beta2::Expr]
         attr_accessor :condition
@@ -246,6 +262,22 @@ module Google
         # For example, my-other-app@appspot.gserviceaccount.com.
         # group:`emailid`: An email address that represents a Google group.  For example,
         # admins@example.com.
+        # deleted:user:`emailid`?uid=`uniqueid`: An email address (plus unique
+        # identifier) representing a user that has been recently deleted. For  example,
+        # alice@example.com?uid=123456789012345678901. If the user is  recovered, this
+        # value reverts to user:`emailid` and the recovered user  retains the role in
+        # the binding.
+        # deleted:serviceAccount:`emailid`?uid=`uniqueid`: An email address (plus
+        # unique identifier) representing a service account that has been recently
+        # deleted. For example,  my-other-app@appspot.gserviceaccount.com?uid=
+        # 123456789012345678901.  If the service account is undeleted, this value
+        # reverts to  serviceAccount:`emailid` and the undeleted service account retains
+        # the  role in the binding.
+        # deleted:group:`emailid`?uid=`uniqueid`: An email address (plus unique
+        # identifier) representing a Google group that has been recently  deleted. For
+        # example, admins@example.com?uid=123456789012345678901. If  the group is
+        # recovered, this value reverts to group:`emailid` and the  recovered group
+        # retains the role in the binding.
         # domain:`domain`: The G Suite domain (primary) that represents all the  users
         # of that domain. For example, google.com or example.com.
         # Corresponds to the JSON property `members`
@@ -294,8 +326,8 @@ module Google
         # @return [String]
         attr_accessor :cluster_name
       
-        # Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
-        # generates this value when it creates the cluster.
+        # Output only. A cluster UUID (Unique Universal Identifier). Dataproc generates
+        # this value when it creates the cluster.
         # Corresponds to the JSON property `clusterUuid`
         # @return [String]
         attr_accessor :cluster_uuid
@@ -362,12 +394,12 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::AutoscalingConfig]
         attr_accessor :autoscaling_config
       
-        # Optional. A Google Cloud Storage bucket used to stage job dependencies, config
-        # files, and job driver console output. If you do not specify a staging bucket,
-        # Cloud Dataproc will determine a Cloud Storage location (US, ASIA, or EU) for
-        # your cluster's staging bucket according to the Google Compute Engine zone
-        # where your cluster is deployed, and then create and manage this project-level,
-        # per-location bucket (see Cloud Dataproc staging bucket).
+        # Optional. A Cloud Storage bucket used to stage job dependencies, config files,
+        # and job driver console output. If you do not specify a staging bucket, Cloud
+        # Dataproc will determine a Cloud Storage location (US, ASIA, or EU) for your
+        # cluster's staging bucket according to the Compute Engine zone where your
+        # cluster is deployed, and then create and manage this project-level, per-
+        # location bucket (see Dataproc staging bucket).
         # Corresponds to the JSON property `configBucket`
         # @return [String]
         attr_accessor :config_bucket
@@ -655,7 +687,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Output only. Time when this state was entered.
+        # Output only. Time when this state was entered (see JSON representation of
+        # Timestamp (https://developers.google.com/protocol-buffers/docs/proto3#json)).
         # Corresponds to the JSON property `stateStartTime`
         # @return [String]
         attr_accessor :state_start_time
@@ -816,34 +849,49 @@ module Google
         end
       end
       
-      # Represents an expression text. Example:
-      # title: "User account presence"
-      # description: "Determines whether the request has a user account"
-      # expression: "size(request.user) > 0"
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
+      # documented at https://github.com/google/cel-spec.Example (Comparison):
+      # title: "Summary size limit"
+      # description: "Determines if a summary is less than 100 chars"
+      # expression: "document.summary.size() < 100"
+      # Example (Equality):
+      # title: "Requestor is owner"
+      # description: "Determines if requestor is the document owner"
+      # expression: "document.owner == request.auth.claims.email"
+      # Example (Logic):
+      # title: "Public documents"
+      # description: "Determine whether the document should be publicly visible"
+      # expression: "document.type != 'private' && document.type != 'internal'"
+      # Example (Data Manipulation):
+      # title: "Notification string"
+      # description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)"
+      # The exact variables and functions that may be referenced within an expression
+      # are determined by the service that evaluates it. See the service documentation
+      # for additional information.
       class Expr
         include Google::Apis::Core::Hashable
       
-        # An optional description of the expression. This is a longer text which
-        # describes the expression, e.g. when hovered over it in a UI.
+        # Optional. Description of the expression. This is a longer text which describes
+        # the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
         # Textual representation of an expression in Common Expression Language syntax.
-        # The application context of the containing message determines which well-known
-        # feature set of CEL is supported.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # An optional string indicating the location of the expression for error
-        # reporting, e.g. a file name and a position in the file.
+        # Optional. String indicating the location of the expression for error reporting,
+        # e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # An optional title for the expression, i.e. a short string describing its
-        # purpose. This can be used e.g. in UIs which allow to enter the expression.
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
+        # This can be used e.g. in UIs which allow to enter the expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -902,13 +950,9 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::ReservationAffinity]
         attr_accessor :reservation_affinity
       
-        # Optional. The service account of the instances. Defaults to the default
-        # Compute Engine service account. Custom service accounts need permissions
-        # equivalent to the following IAM roles:
-        # roles/logging.logWriter
-        # roles/storage.objectAdmin(see https://cloud.google.com/compute/docs/access/
-        # service-accounts#custom_service_accounts for more information). Example: [
-        # account_id]@[project_id].iam.gserviceaccount.com
+        # Optional. The Dataproc service account (also see VM Data Plane identity) used
+        # by Dataproc cluster VM instances to access Google Cloud Platform services.If
+        # not specified, the Compute Engine default service account is used.
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
@@ -945,9 +989,9 @@ module Google
       
         # 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 always be
-        # present.A full URL, partial URI, or short name are valid. Examples:
+        # global Dataproc region, the service will pick a zone in the corresponding
+        # Compute Engine region. On a get request, zone will always be present.A full
+        # URL, partial URI, or short name are valid. Examples:
         # https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]
         # projects/[project_id]/zones/[zone]
         # us-central1-f
@@ -1014,8 +1058,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache Hadoop MapReduce (https://hadoop.
-      # apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
+      # A Dataproc job for running Apache Hadoop MapReduce (https://hadoop.apache.org/
+      # docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
       # MapReduceTutorial.html) jobs on Apache Hadoop YARN (https://hadoop.apache.org/
       # docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html).
       class HadoopJob
@@ -1068,7 +1112,7 @@ module Google
         attr_accessor :main_jar_file_uri
       
         # Optional. A mapping of property names to values, used to configure Hadoop.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/hadoop/conf/*-site and classes
         # in user code.
         # Corresponds to the JSON property `properties`
@@ -1092,8 +1136,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache Hive (https://hive.apache.org/)
-      # queries on YARN.
+      # A Dataproc job for running Apache Hive (https://hive.apache.org/) queries on
+      # YARN.
       class HiveJob
         include Google::Apis::Core::Hashable
       
@@ -1112,7 +1156,7 @@ module Google
         attr_accessor :jar_file_uris
       
         # Optional. A mapping of property names and values, used to configure Hive.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, /etc/
         # hive/conf/hive-site.xml, and classes in user code.
         # Corresponds to the JSON property `properties`
@@ -1222,7 +1266,7 @@ module Google
         # @return [String]
         attr_accessor :image_uri
       
-        # Output only. The list of instance names. Cloud Dataproc derives the names from
+        # Output only. The list of instance names. Dataproc derives the names from
         # cluster_name, num_instances, and the instance group.
         # Corresponds to the JSON property `instanceNames`
         # @return [Array<String>]
@@ -1239,9 +1283,9 @@ module Google
         # 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-2Auto Zone Exception: If you are using the Cloud Dataproc Auto
-        # Zone Placement feature, you must use the short name of the machine type
-        # resource, for example, n1-standard-2.
+        # n1-standard-2Auto Zone Exception: If you are using the Dataproc Auto Zone
+        # Placement feature, you must use the short name of the machine type resource,
+        # for example, n1-standard-2.
         # Corresponds to the JSON property `machineTypeUri`
         # @return [String]
         attr_accessor :machine_type_uri
@@ -1251,8 +1295,8 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::ManagedGroupConfig]
         attr_accessor :managed_group_config
       
-        # Specifies the minimum cpu platform for the Instance Group. See Cloud Dataproc&
-        # rarr;Minimum CPU Platform.
+        # Specifies the minimum cpu platform for the Instance Group. See Dataproc&rarr;
+        # Minimum CPU Platform.
         # Corresponds to the JSON property `minCpuPlatform`
         # @return [String]
         attr_accessor :min_cpu_platform
@@ -1327,7 +1371,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job resource.
+      # A Dataproc job resource.
       class Job
         include Google::Apis::Core::Hashable
       
@@ -1344,16 +1388,16 @@ module Google
         # @return [String]
         attr_accessor :driver_output_resource_uri
       
-        # A Cloud Dataproc job for running Apache Hadoop MapReduce (https://hadoop.
-        # apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
+        # A Dataproc job for running Apache Hadoop MapReduce (https://hadoop.apache.org/
+        # docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
         # MapReduceTutorial.html) jobs on Apache Hadoop YARN (https://hadoop.apache.org/
         # docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html).
         # Corresponds to the JSON property `hadoopJob`
         # @return [Google::Apis::DataprocV1beta2::HadoopJob]
         attr_accessor :hadoop_job
       
-        # A Cloud Dataproc job for running Apache Hive (https://hive.apache.org/)
-        # queries on YARN.
+        # A Dataproc job for running Apache Hive (https://hive.apache.org/) queries on
+        # YARN.
         # Corresponds to the JSON property `hiveJob`
         # @return [Google::Apis::DataprocV1beta2::HiveJob]
         attr_accessor :hive_job
@@ -1374,24 +1418,24 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # A Cloud Dataproc job for running Apache Pig (https://pig.apache.org/) queries
-        # on YARN.
+        # A Dataproc job for running Apache Pig (https://pig.apache.org/) queries on
+        # YARN.
         # Corresponds to the JSON property `pigJob`
         # @return [Google::Apis::DataprocV1beta2::PigJob]
         attr_accessor :pig_job
       
-        # Cloud Dataproc job config.
+        # Dataproc job config.
         # Corresponds to the JSON property `placement`
         # @return [Google::Apis::DataprocV1beta2::JobPlacement]
         attr_accessor :placement
       
-        # A Cloud Dataproc job for running Presto (https://prestosql.io/) queries
+        # A Dataproc job for running Presto (https://prestosql.io/) queries
         # Corresponds to the JSON property `prestoJob`
         # @return [Google::Apis::DataprocV1beta2::PrestoJob]
         attr_accessor :presto_job
       
-        # A Cloud Dataproc job for running Apache PySpark (https://spark.apache.org/docs/
-        # 0.9.0/python-programming-guide.html) applications on YARN.
+        # A Dataproc job for running Apache PySpark (https://spark.apache.org/docs/0.9.0/
+        # python-programming-guide.html) applications on YARN.
         # Corresponds to the JSON property `pysparkJob`
         # @return [Google::Apis::DataprocV1beta2::PySparkJob]
         attr_accessor :pyspark_job
@@ -1406,7 +1450,7 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::JobScheduling]
         attr_accessor :scheduling
       
-        # A Cloud Dataproc job for running Apache Spark (http://spark.apache.org/)
+        # A Dataproc job for running Apache Spark (http://spark.apache.org/)
         # applications on YARN. The specification of the main method to call to drive
         # the job. Specify either the jar file that contains the main class or the main
         # class name. To pass both a main jar and a main class in that jar, add the jar
@@ -1415,19 +1459,19 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::SparkJob]
         attr_accessor :spark_job
       
-        # A Cloud Dataproc job for running Apache SparkR (https://spark.apache.org/docs/
-        # latest/sparkr.html) applications on YARN.
+        # A Dataproc job for running Apache SparkR (https://spark.apache.org/docs/latest/
+        # sparkr.html) applications on YARN.
         # Corresponds to the JSON property `sparkRJob`
         # @return [Google::Apis::DataprocV1beta2::SparkRJob]
         attr_accessor :spark_r_job
       
-        # A Cloud Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/
-        # ) queries.
+        # A Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/)
+        # queries.
         # Corresponds to the JSON property `sparkSqlJob`
         # @return [Google::Apis::DataprocV1beta2::SparkSqlJob]
         attr_accessor :spark_sql_job
       
-        # Cloud Dataproc job status.
+        # Dataproc job status.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::DataprocV1beta2::JobStatus]
         attr_accessor :status
@@ -1478,7 +1522,7 @@ module Google
         end
       end
       
-      # Cloud Dataproc job config.
+      # Dataproc job config.
       class JobPlacement
         include Google::Apis::Core::Hashable
       
@@ -1487,8 +1531,8 @@ module Google
         # @return [String]
         attr_accessor :cluster_name
       
-        # Output only. A cluster UUID generated by the Cloud Dataproc service when the
-        # job is submitted.
+        # Output only. A cluster UUID generated by the Dataproc service when the job is
+        # submitted.
         # Corresponds to the JSON property `clusterUuid`
         # @return [String]
         attr_accessor :cluster_uuid
@@ -1508,7 +1552,7 @@ module Google
       class JobReference
         include Google::Apis::Core::Hashable
       
-        # Optional. The job ID, which must be unique within the project.The ID must
+        # Optional. The job ID, which must be unique within the project. The ID must
         # contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or hyphens (-)
         # . The maximum length is 100 characters.If not specified by the caller, the job
         # ID will be provided by the server.
@@ -1554,11 +1598,11 @@ module Google
         end
       end
       
-      # Cloud Dataproc job status.
+      # Dataproc job status.
       class JobStatus
         include Google::Apis::Core::Hashable
       
-        # Output only. Optional job state details, such as an error description if the
+        # Output only. Optional Job state details, such as an error description if the
         # state is <code>ERROR</code>.
         # Corresponds to the JSON property `details`
         # @return [String]
@@ -1718,28 +1762,32 @@ module Google
       class LifecycleConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. The time when cluster will be auto-deleted.
+        # Optional. The time when cluster will be auto-deleted. (see JSON representation
+        # of Timestamp (https://developers.google.com/protocol-buffers/docs/proto3#json))
+        # .
         # Corresponds to the JSON property `autoDeleteTime`
         # @return [String]
         attr_accessor :auto_delete_time
       
         # Optional. The lifetime duration of cluster. The cluster will be auto-deleted
-        # at the end of this period. Valid range: 10m, 14d.Example: "1d", to delete the
-        # cluster 1 day after its creation..
+        # at the end of this period. Minimum value is 10 minutes; maximum value is 14
+        # days (see JSON representation of Duration (https://developers.google.com/
+        # protocol-buffers/docs/proto3#json)).
         # Corresponds to the JSON property `autoDeleteTtl`
         # @return [String]
         attr_accessor :auto_delete_ttl
       
-        # Optional. The duration to keep the cluster alive while idling. Passing this
-        # threshold will cause the cluster to be deleted. Valid range: 10m, 14d.Example:
-        # "10m", the minimum value, to delete the cluster when it has had no jobs
-        # running for 10 minutes.
+        # Optional. The duration to keep the cluster alive while idling (when no jobs
+        # are running). Passing this threshold will cause the cluster to be deleted.
+        # Minimum value is 10 minutes; maximum value is 14 days (see JSON representation
+        # of Duration (https://developers.google.com/protocol-buffers/docs/proto3#json).
         # Corresponds to the JSON property `idleDeleteTtl`
         # @return [String]
         attr_accessor :idle_delete_ttl
       
         # Output only. The time when cluster became idle (most recent job finished) and
-        # became eligible for deletion due to idleness.
+        # became eligible for deletion due to idleness (see JSON representation of
+        # Timestamp (https://developers.google.com/protocol-buffers/docs/proto3#json)).
         # Corresponds to the JSON property `idleStartTime`
         # @return [String]
         attr_accessor :idle_start_time
@@ -1984,10 +2032,12 @@ module Google
         # @return [String]
         attr_accessor :executable_file
       
-        # Optional. Amount of time executable has to complete. Default is 10 minutes.
-        # Cluster creation fails with an explanatory error message (the name of the
-        # executable that caused the error and the exceeded timeout period) if the
-        # executable is not completed at end of the timeout period.
+        # Optional. Amount of time executable has to complete. Default is 10 minutes (
+        # see JSON representation of Duration (https://developers.google.com/protocol-
+        # buffers/docs/proto3#json)).Cluster creation fails with an explanatory error
+        # message (the name of the executable that caused the error and the exceeded
+        # timeout period) if the executable is not completed at end of the timeout
+        # period.
         # Corresponds to the JSON property `executionTimeout`
         # @return [String]
         attr_accessor :execution_timeout
@@ -2069,16 +2119,16 @@ module Google
       class OrderedJob
         include Google::Apis::Core::Hashable
       
-        # A Cloud Dataproc job for running Apache Hadoop MapReduce (https://hadoop.
-        # apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
+        # A Dataproc job for running Apache Hadoop MapReduce (https://hadoop.apache.org/
+        # docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/
         # MapReduceTutorial.html) jobs on Apache Hadoop YARN (https://hadoop.apache.org/
         # docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html).
         # Corresponds to the JSON property `hadoopJob`
         # @return [Google::Apis::DataprocV1beta2::HadoopJob]
         attr_accessor :hadoop_job
       
-        # A Cloud Dataproc job for running Apache Hive (https://hive.apache.org/)
-        # queries on YARN.
+        # A Dataproc job for running Apache Hive (https://hive.apache.org/) queries on
+        # YARN.
         # Corresponds to the JSON property `hiveJob`
         # @return [Google::Apis::DataprocV1beta2::HiveJob]
         attr_accessor :hive_job
@@ -2092,8 +2142,8 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # A Cloud Dataproc job for running Apache Pig (https://pig.apache.org/) queries
-        # on YARN.
+        # A Dataproc job for running Apache Pig (https://pig.apache.org/) queries on
+        # YARN.
         # Corresponds to the JSON property `pigJob`
         # @return [Google::Apis::DataprocV1beta2::PigJob]
         attr_accessor :pig_job
@@ -2104,8 +2154,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :prerequisite_step_ids
       
-        # A Cloud Dataproc job for running Apache PySpark (https://spark.apache.org/docs/
-        # 0.9.0/python-programming-guide.html) applications on YARN.
+        # A Dataproc job for running Apache PySpark (https://spark.apache.org/docs/0.9.0/
+        # python-programming-guide.html) applications on YARN.
         # Corresponds to the JSON property `pysparkJob`
         # @return [Google::Apis::DataprocV1beta2::PySparkJob]
         attr_accessor :pyspark_job
@@ -2115,7 +2165,7 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::JobScheduling]
         attr_accessor :scheduling
       
-        # A Cloud Dataproc job for running Apache Spark (http://spark.apache.org/)
+        # A Dataproc job for running Apache Spark (http://spark.apache.org/)
         # applications on YARN. The specification of the main method to call to drive
         # the job. Specify either the jar file that contains the main class or the main
         # class name. To pass both a main jar and a main class in that jar, add the jar
@@ -2124,8 +2174,8 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::SparkJob]
         attr_accessor :spark_job
       
-        # A Cloud Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/
-        # ) queries.
+        # A Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/)
+        # queries.
         # Corresponds to the JSON property `sparkSqlJob`
         # @return [Google::Apis::DataprocV1beta2::SparkSqlJob]
         attr_accessor :spark_sql_job
@@ -2184,8 +2234,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache Pig (https://pig.apache.org/) queries
-      # on YARN.
+      # A Dataproc job for running Apache Pig (https://pig.apache.org/) queries on
+      # YARN.
       class PigJob
         include Google::Apis::Core::Hashable
       
@@ -2209,7 +2259,7 @@ module Google
         attr_accessor :logging_config
       
         # Optional. A mapping of property names to values, used to configure Pig.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, /etc/
         # pig/conf/pig.properties, and classes in user code.
         # Corresponds to the JSON property `properties`
@@ -2248,14 +2298,15 @@ module Google
         end
       end
       
-      # Defines an Identity and Access Management (IAM) policy. It is used to specify
-      # access control policies for Cloud Platform resources.A Policy is a collection
-      # of bindings. A binding binds one or more members to a single role. Members can
-      # be user accounts, service accounts, Google groups, and domains (such as G
-      # Suite). A role is a named list of permissions (defined by IAM or configured by
-      # users). A binding can optionally specify a condition, which is a logic
-      # expression that further constrains the role binding based on attributes about
-      # the request and/or target resource.JSON Example
+      # An Identity and Access Management (IAM) policy, which specifies access
+      # controls for Google Cloud resources.A Policy is a collection of bindings. A
+      # binding binds one or more members to a single role. Members can be user
+      # accounts, service accounts, Google groups, and domains (such as G Suite). A
+      # role is a named list of permissions; each role can be an IAM predefined role
+      # or a user-created custom role.Optionally, a binding can specify a condition,
+      # which is a logical expression that allows access to a resource only if the
+      # expression evaluates to true. A condition can add constraints based on
+      # attributes of the request, the resource, or both.JSON example:
       # `
       # "bindings": [
       # `
@@ -2273,13 +2324,14 @@ module Google
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time <
-      # timestamp('2020-10-01T00:00:00.000Z')",
+      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
       # `
       # `
-      # ]
+      # ],
+      # "etag": "BwWWja0YfJA=",
+      # "version": 3
       # `
-      # YAML Example
+      # YAML example:
       # bindings:
       # - members:
       # - user:mike@example.com
@@ -2294,14 +2346,16 @@ module Google
       # title: expirable access
       # description: Does not grant access after Sep 2020
       # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # For a description of IAM and its features, see the IAM developer's guide (
-      # https://cloud.google.com/iam/docs).
+      # - etag: BwWWja0YfJA=
+      # - version: 3
+      # For a description of IAM and its features, see the IAM documentation (https://
+      # cloud.google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of members to a role. Optionally may specify a condition
-        # that determines when binding is in effect. bindings with no members will
-        # result in an error.
+        # Associates a list of members to a role. Optionally, may specify a condition
+        # that determines how and when the bindings are applied. Each of the bindings
+        # must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::DataprocV1beta2::Binding>]
         attr_accessor :bindings
@@ -2312,23 +2366,29 @@ module Google
         # perform policy updates in order to avoid race conditions: An etag is returned
         # in the response to getIamPolicy, and systems are expected to put that etag in
         # the request to setIamPolicy to ensure that their change will be applied to the
-        # same version of the policy.If no etag is provided in the call to setIamPolicy,
-        # then the existing policy is overwritten. Due to blind-set semantics of an etag-
-        # less policy, 'setIamPolicy' will not fail even if the incoming policy version
-        # does not meet the requirements for modifying the stored policy.
+        # same version of the policy.Important: If you use IAM Conditions, you must
+        # include the etag field whenever you call setIamPolicy. If you omit this field,
+        # then IAM allows you to overwrite a version 3 policy with a version 1 policy,
+        # and all of the conditions in the version 3 policy are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.Valid values are 0, 1, and 3. Requests
-        # specifying an invalid value will be rejected.Operations affecting conditional
-        # bindings must specify version 3. This can be either setting a conditional
-        # policy, modifying a conditional binding, or removing a binding (conditional or
-        # unconditional) from the stored conditional policy. Operations on non-
-        # conditional policies may specify any valid value or leave the field unset.If
-        # no etag is provided in the call to setIamPolicy, version compliance checks
-        # against the stored policy is skipped.
+        # Specifies the format of the policy.Valid values are 0, 1, and 3. Requests that
+        # specify an invalid value are rejected.Any operation that affects conditional
+        # role bindings must specify version 3. This requirement applies to the
+        # following operations:
+        # Getting a policy that includes a conditional role binding
+        # Adding a conditional role binding to a policy
+        # Changing a conditional role binding in a policy
+        # Removing any role binding, with or without a condition, from a policy  that
+        # includes conditionsImportant: If you use IAM Conditions, you must include the
+        # etag field whenever you call setIamPolicy. If you omit this field, then IAM
+        # allows you to overwrite a version 3 policy with a version 1 policy, and all of
+        # the conditions in the version 3 policy are lost.If a policy does not include
+        # any conditions, operations on that policy may specify any valid version or
+        # leave the field unset.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2345,7 +2405,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Presto (https://prestosql.io/) queries
+      # A Dataproc job for running Presto (https://prestosql.io/) queries
       class PrestoJob
         include Google::Apis::Core::Hashable
       
@@ -2406,8 +2466,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache PySpark (https://spark.apache.org/docs/
-      # 0.9.0/python-programming-guide.html) applications on YARN.
+      # A Dataproc job for running Apache PySpark (https://spark.apache.org/docs/0.9.0/
+      # python-programming-guide.html) applications on YARN.
       class PySparkJob
         include Google::Apis::Core::Hashable
       
@@ -2448,7 +2508,7 @@ module Google
         attr_accessor :main_python_file_uri
       
         # Optional. A mapping of property names to values, used to configure PySpark.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/spark/conf/spark-defaults.conf
         # and classes in user code.
         # Corresponds to the JSON property `properties`
@@ -2584,14 +2644,15 @@ module Google
       class SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
-        # Defines an Identity and Access Management (IAM) policy. It is used to specify
-        # access control policies for Cloud Platform resources.A Policy is a collection
-        # of bindings. A binding binds one or more members to a single role. Members can
-        # be user accounts, service accounts, Google groups, and domains (such as G
-        # Suite). A role is a named list of permissions (defined by IAM or configured by
-        # users). A binding can optionally specify a condition, which is a logic
-        # expression that further constrains the role binding based on attributes about
-        # the request and/or target resource.JSON Example
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.A Policy is a collection of bindings. A
+        # binding binds one or more members to a single role. Members can be user
+        # accounts, service accounts, Google groups, and domains (such as G Suite). A
+        # role is a named list of permissions; each role can be an IAM predefined role
+        # or a user-created custom role.Optionally, a binding can specify a condition,
+        # which is a logical expression that allows access to a resource only if the
+        # expression evaluates to true. A condition can add constraints based on
+        # attributes of the request, the resource, or both.JSON example:
         # `
         # "bindings": [
         # `
@@ -2609,13 +2670,14 @@ module Google
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time <
-        # timestamp('2020-10-01T00:00:00.000Z')",
+        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
         # `
         # `
-        # ]
+        # ],
+        # "etag": "BwWWja0YfJA=",
+        # "version": 3
         # `
-        # YAML Example
+        # YAML example:
         # bindings:
         # - members:
         # - user:mike@example.com
@@ -2630,8 +2692,10 @@ module Google
         # title: expirable access
         # description: Does not grant access after Sep 2020
         # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # For a description of IAM and its features, see the IAM developer's guide (
-        # https://cloud.google.com/iam/docs).
+        # - etag: BwWWja0YfJA=
+        # - version: 3
+        # For a description of IAM and its features, see the IAM documentation (https://
+        # cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DataprocV1beta2::Policy]
         attr_accessor :policy
@@ -2651,9 +2715,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The version of software inside the cluster. It must be one of the
-        # supported Cloud Dataproc Versions, such as "1.2" (including a subminor version,
-        # such as "1.2.29"), or the "preview" version. If unspecified, it defaults to
-        # the latest Debian version.
+        # supported Dataproc Versions, such as "1.2" (including a subminor version, such
+        # as "1.2.29"), or the "preview" version. If unspecified, it defaults to the
+        # latest Debian version.
         # Corresponds to the JSON property `imageVersion`
         # @return [String]
         attr_accessor :image_version
@@ -2691,7 +2755,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache Spark (http://spark.apache.org/)
+      # A Dataproc job for running Apache Spark (http://spark.apache.org/)
       # applications on YARN. The specification of the main method to call to drive
       # the job. Specify either the jar file that contains the main class or the main
       # class name. To pass both a main jar and a main class in that jar, add the jar
@@ -2742,7 +2806,7 @@ module Google
         attr_accessor :main_jar_file_uri
       
         # Optional. A mapping of property names to values, used to configure Spark.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/spark/conf/spark-defaults.conf
         # and classes in user code.
         # Corresponds to the JSON property `properties`
@@ -2766,8 +2830,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache SparkR (https://spark.apache.org/docs/
-      # latest/sparkr.html) applications on YARN.
+      # A Dataproc job for running Apache SparkR (https://spark.apache.org/docs/latest/
+      # sparkr.html) applications on YARN.
       class SparkRJob
         include Google::Apis::Core::Hashable
       
@@ -2803,7 +2867,7 @@ module Google
         attr_accessor :main_r_file_uri
       
         # Optional. A mapping of property names to values, used to configure SparkR.
-        # Properties that conflict with values set by the Cloud Dataproc API may be
+        # Properties that conflict with values set by the Dataproc API may be
         # overwritten. Can include properties set in /etc/spark/conf/spark-defaults.conf
         # and classes in user code.
         # Corresponds to the JSON property `properties`
@@ -2825,8 +2889,8 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/
-      # ) queries.
+      # A Dataproc job for running Apache Spark SQL (http://spark.apache.org/sql/)
+      # queries.
       class SparkSqlJob
         include Google::Apis::Core::Hashable
       
@@ -2841,8 +2905,8 @@ module Google
         attr_accessor :logging_config
       
         # Optional. A mapping of property names to values, used to configure Spark SQL's
-        # SparkConf. Properties that conflict with values set by the Cloud Dataproc API
-        # may be overwritten.
+        # SparkConf. Properties that conflict with values set by the Dataproc API may be
+        # overwritten.
         # Corresponds to the JSON property `properties`
         # @return [Hash<String,String>]
         attr_accessor :properties
@@ -2921,7 +2985,7 @@ module Google
       class SubmitJobRequest
         include Google::Apis::Core::Hashable
       
-        # A Cloud Dataproc job resource.
+        # A Dataproc job resource.
         # Corresponds to the JSON property `job`
         # @return [Google::Apis::DataprocV1beta2::Job]
         attr_accessor :job
@@ -3102,7 +3166,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc workflow template resource.
+      # A Dataproc workflow template resource.
       class WorkflowMetadata
         include Google::Apis::Core::Hashable
       
@@ -3231,7 +3295,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc workflow template resource.
+      # A Dataproc workflow template resource.
       class WorkflowTemplate
         include Google::Apis::Core::Hashable
       
@@ -3369,8 +3433,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Optional. Output only. The HTTP URL of the ApplicationMaster, HistoryServer,
-        # or TimelineServer that provides application-specific information. The URL uses
+        # Output only. The HTTP URL of the ApplicationMaster, HistoryServer, or
+        # TimelineServer that provides application-specific information. The URL uses
         # the internal hostname, and requires a proxy server for resolution and,
         # possibly, access.
         # Corresponds to the JSON property `trackingUrl`