google-api-client 0.36.0 → 0.37.0

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

@@ -37,8 +37,8 @@ module Google
         # 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-k80Auto Zone Exception: If you are using the Cloud Dataproc Auto
-        # Zone Placement feature, you must use the short name of the accelerator type
+        # nvidia-tesla-k80Auto Zone Exception: If 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]
@@ -64,8 +64,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
@@ -227,10 +226,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::DataprocV1::Expr]
         attr_accessor :condition
@@ -247,6 +263,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`
@@ -295,8 +327,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
@@ -363,12 +395,12 @@ module Google
         # @return [Google::Apis::DataprocV1::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
@@ -404,14 +436,14 @@ module Google
         # @return [Google::Apis::DataprocV1::LifecycleConfig]
         attr_accessor :lifecycle_config
       
-        # Optional. The config settings for Compute Engine resources in an instance
-        # group, such as a master or worker group.
+        # The config settings for Compute Engine resources in an instance group, such as
+        # a master or worker group.
         # Corresponds to the JSON property `masterConfig`
         # @return [Google::Apis::DataprocV1::InstanceGroupConfig]
         attr_accessor :master_config
       
-        # Optional. The config settings for Compute Engine resources in an instance
-        # group, such as a master or worker group.
+        # The config settings for Compute Engine resources in an instance group, such as
+        # a master or worker group.
         # Corresponds to the JSON property `secondaryWorkerConfig`
         # @return [Google::Apis::DataprocV1::InstanceGroupConfig]
         attr_accessor :secondary_worker_config
@@ -426,8 +458,8 @@ module Google
         # @return [Google::Apis::DataprocV1::SoftwareConfig]
         attr_accessor :software_config
       
-        # Optional. The config settings for Compute Engine resources in an instance
-        # group, such as a master or worker group.
+        # The config settings for Compute Engine resources in an instance group, such as
+        # a master or worker group.
         # Corresponds to the JSON property `workerConfig`
         # @return [Google::Apis::DataprocV1::InstanceGroupConfig]
         attr_accessor :worker_config
@@ -650,7 +682,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
@@ -783,34 +816,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
@@ -869,13 +917,9 @@ module Google
         # @return [Google::Apis::DataprocV1::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
@@ -912,9 +956,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
@@ -981,8 +1025,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
@@ -1035,7 +1079,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`
@@ -1059,8 +1103,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
       
@@ -1079,7 +1123,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`
@@ -1168,8 +1212,8 @@ module Google
         end
       end
       
-      # Optional. The config settings for Compute Engine resources in an instance
-      # group, such as a master or worker group.
+      # The config settings for Compute Engine resources in an instance group, such as
+      # a master or worker group.
       class InstanceGroupConfig
         include Google::Apis::Core::Hashable
       
@@ -1189,7 +1233,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>]
@@ -1206,9 +1250,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
@@ -1218,7 +1262,7 @@ module Google
         # @return [Google::Apis::DataprocV1::ManagedGroupConfig]
         attr_accessor :managed_group_config
       
-        # Optional. Specifies the minimum cpu platform for the Instance Group. See Cloud
+        # Optional. Specifies the minimum cpu platform for the Instance Group. See
         # Dataproc&rarr;Minimum CPU Platform.
         # Corresponds to the JSON property `minCpuPlatform`
         # @return [String]
@@ -1288,7 +1332,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc job resource.
+      # A Dataproc job resource.
       class Job
         include Google::Apis::Core::Hashable
       
@@ -1305,16 +1349,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::DataprocV1::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::DataprocV1::HiveJob]
         attr_accessor :hive_job
@@ -1335,19 +1379,19 @@ 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::DataprocV1::PigJob]
         attr_accessor :pig_job
       
-        # Cloud Dataproc job config.
+        # Dataproc job config.
         # Corresponds to the JSON property `placement`
         # @return [Google::Apis::DataprocV1::JobPlacement]
         attr_accessor :placement
       
-        # 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::DataprocV1::PySparkJob]
         attr_accessor :pyspark_job
@@ -1362,25 +1406,25 @@ module Google
         # @return [Google::Apis::DataprocV1::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.
         # Corresponds to the JSON property `sparkJob`
         # @return [Google::Apis::DataprocV1::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::DataprocV1::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::DataprocV1::SparkSqlJob]
         attr_accessor :spark_sql_job
       
-        # Cloud Dataproc job status.
+        # Dataproc job status.
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::DataprocV1::JobStatus]
         attr_accessor :status
@@ -1423,7 +1467,7 @@ module Google
         end
       end
       
-      # Cloud Dataproc job config.
+      # Dataproc job config.
       class JobPlacement
         include Google::Apis::Core::Hashable
       
@@ -1432,8 +1476,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
@@ -1499,7 +1543,7 @@ module Google
         end
       end
       
-      # Cloud Dataproc job status.
+      # Dataproc job status.
       class JobStatus
         include Google::Apis::Core::Hashable
       
@@ -1663,28 +1707,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
@@ -1929,10 +1977,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
@@ -2014,16 +2064,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::DataprocV1::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::DataprocV1::HiveJob]
         attr_accessor :hive_job
@@ -2037,8 +2087,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::DataprocV1::PigJob]
         attr_accessor :pig_job
@@ -2049,8 +2099,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::DataprocV1::PySparkJob]
         attr_accessor :pyspark_job
@@ -2060,14 +2110,14 @@ module Google
         # @return [Google::Apis::DataprocV1::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.
         # Corresponds to the JSON property `sparkJob`
         # @return [Google::Apis::DataprocV1::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::DataprocV1::SparkSqlJob]
         attr_accessor :spark_sql_job
@@ -2126,8 +2176,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
       
@@ -2151,7 +2201,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`
@@ -2190,14 +2240,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": [
       # `
@@ -2215,13 +2266,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
@@ -2236,14 +2288,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::DataprocV1::Binding>]
         attr_accessor :bindings
@@ -2254,23 +2308,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
@@ -2287,8 +2347,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
       
@@ -2329,7 +2389,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`
@@ -2465,14 +2525,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": [
         # `
@@ -2490,13 +2551,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
@@ -2511,8 +2573,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::DataprocV1::Policy]
         attr_accessor :policy
@@ -2532,9 +2596,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
@@ -2572,7 +2636,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.
       class SparkJob
         include Google::Apis::Core::Hashable
@@ -2620,7 +2684,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`
@@ -2644,8 +2708,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
       
@@ -2681,7 +2745,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`
@@ -2703,8 +2767,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
       
@@ -2719,8 +2783,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
@@ -2799,7 +2863,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::DataprocV1::Job]
         attr_accessor :job
@@ -2980,7 +3044,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc workflow template resource.
+      # A Dataproc workflow template resource.
       class WorkflowMetadata
         include Google::Apis::Core::Hashable
       
@@ -3109,7 +3173,7 @@ module Google
         end
       end
       
-      # A Cloud Dataproc workflow template resource.
+      # A Dataproc workflow template resource.
       class WorkflowTemplate
         include Google::Apis::Core::Hashable