google-api-client 0.28.4 → 0.28.5

data/generated/google/apis/dataflow_v1b3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataflow
     module DataflowV1b3
       VERSION = 'V1b3'
-      REVISION = '20190126'
+      REVISION = '20190131'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -736,7 +736,9 @@ module Google
         # @return [String]
         attr_accessor :job_name
       
-        # The location to which to direct the request.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        # which to direct the request.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -1121,6 +1123,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :experiments
       
+        # Which Flexible Resource Scheduling mode to run in.
+        # Corresponds to the JSON property `flexResourceSchedulingGoal`
+        # @return [String]
+        attr_accessor :flex_resource_scheduling_goal
+      
         # Experimental settings.
         # Corresponds to the JSON property `internalExperiments`
         # @return [Hash<String,Object>]
@@ -1180,6 +1187,7 @@ module Google
           @cluster_manager_api_service = args[:cluster_manager_api_service] if args.key?(:cluster_manager_api_service)
           @dataset = args[:dataset] if args.key?(:dataset)
           @experiments = args[:experiments] if args.key?(:experiments)
+          @flex_resource_scheduling_goal = args[:flex_resource_scheduling_goal] if args.key?(:flex_resource_scheduling_goal)
           @internal_experiments = args[:internal_experiments] if args.key?(:internal_experiments)
           @sdk_pipeline_options = args[:sdk_pipeline_options] if args.key?(:sdk_pipeline_options)
           @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
@@ -1278,11 +1286,15 @@ module Google
         end
       end
       
-      # Indicates which location failed to respond to a request for data.
+      # Indicates which [regional endpoint]
+      # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) failed
+      # to respond to a request for data.
       class FailedLocation
         include Google::Apis::Core::Hashable
       
-        # The name of the failed location.
+        # The name of the [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # failed to respond.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1390,7 +1402,9 @@ module Google
         # @return [String]
         attr_accessor :component_id
       
-        # The location which contains the job specified by job_id.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains the job specified by job_id.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -1748,7 +1762,7 @@ module Google
         attr_accessor :id
       
         # Metadata available primarily for filtering jobs. Will be included in the
-        # ListJob response and Job SUMMARY view+.
+        # ListJob response and Job SUMMARY view.
         # Corresponds to the JSON property `jobMetadata`
         # @return [Google::Apis::DataflowV1b3::JobMetadata]
         attr_accessor :job_metadata
@@ -1764,7 +1778,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The location that contains this job.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains this job.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -1782,7 +1798,7 @@ module Google
       
         # A descriptive representation of submitted pipeline as well as the executed
         # form.  This data is provided by the Dataflow service for ease of visualizing
-        # the pipeline and interpretting Dataflow provided metrics.
+        # the pipeline and interpreting Dataflow provided metrics.
         # Corresponds to the JSON property `pipelineDescription`
         # @return [Google::Apis::DataflowV1b3::PipelineDescription]
         attr_accessor :pipeline_description
@@ -1981,7 +1997,7 @@ module Google
       end
       
       # Metadata available primarily for filtering jobs. Will be included in the
-      # ListJob response and Job SUMMARY view+.
+      # ListJob response and Job SUMMARY view.
       class JobMetadata
         include Google::Apis::Core::Hashable
       
@@ -2010,7 +2026,7 @@ module Google
         # @return [Array<Google::Apis::DataflowV1b3::PubSubIoDetails>]
         attr_accessor :pubsub_details
       
-        # The version of the SDK used to run the jobl
+        # The version of the SDK used to run the job.
         # Corresponds to the JSON property `sdkVersion`
         # @return [Google::Apis::DataflowV1b3::SdkVersion]
         attr_accessor :sdk_version
@@ -2036,7 +2052,7 @@ module Google
         end
       end
       
-      # JobMetrics contains a collection of metrics descibing the detailed progress
+      # JobMetrics contains a collection of metrics describing the detailed progress
       # of a Dataflow job. Metrics correspond to user-defined and system-defined
       # metrics in the job.
       # This resource captures only the most recent values of each metric;
@@ -2212,7 +2228,9 @@ module Google
         # @return [String]
         attr_accessor :current_worker_time
       
-        # The location which contains the WorkItem's job.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains the WorkItem's job.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -2321,7 +2339,9 @@ module Google
       class ListJobsResponse
         include Google::Apis::Core::Hashable
       
-        # Zero or more messages describing locations that failed to respond.
+        # Zero or more messages describing the [regional endpoints]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # failed to respond.
         # Corresponds to the JSON property `failedLocation`
         # @return [Array<Google::Apis::DataflowV1b3::FailedLocation>]
         attr_accessor :failed_location
@@ -2906,7 +2926,7 @@ module Google
       
       # A descriptive representation of submitted pipeline as well as the executed
       # form.  This data is provided by the Dataflow service for ease of visualizing
-      # the pipeline and interpretting Dataflow provided metrics.
+      # the pipeline and interpreting Dataflow provided metrics.
       class PipelineDescription
         include Google::Apis::Core::Hashable
       
@@ -3110,7 +3130,9 @@ module Google
         # @return [String]
         attr_accessor :current_worker_time
       
-        # The location which contains the WorkItem's job.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains the WorkItem's job.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -3331,7 +3353,7 @@ module Google
         end
       end
       
-      # The version of the SDK used to run the jobl
+      # The version of the SDK used to run the job.
       class SdkVersion
         include Google::Apis::Core::Hashable
       
@@ -3345,7 +3367,7 @@ module Google
         # @return [String]
         attr_accessor :version
       
-        # A readable string describing the version of the sdk.
+        # A readable string describing the version of the SDK.
         # Corresponds to the JSON property `versionDisplayName`
         # @return [String]
         attr_accessor :version_display_name
@@ -3376,7 +3398,9 @@ module Google
         # @return [String]
         attr_accessor :data
       
-        # The location which contains the job specified by job_id.
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains the job specified by job_id.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -3417,7 +3441,9 @@ module Google
       class SendWorkerMessagesRequest
         include Google::Apis::Core::Hashable
       
-        # The location which contains the job
+        # The [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        # contains the job.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -4501,6 +4527,11 @@ module Google
       class StreamingConfigTask
         include Google::Apis::Core::Hashable
       
+        # Maximum size for work item commit supported windmill storage layer.
+        # Corresponds to the JSON property `maxWorkItemCommitBytes`
+        # @return [Fixnum]
+        attr_accessor :max_work_item_commit_bytes
+      
         # Set of computation configuration information.
         # Corresponds to the JSON property `streamingComputationConfigs`
         # @return [Array<Google::Apis::DataflowV1b3::StreamingComputationConfig>]
@@ -4531,6 +4562,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @max_work_item_commit_bytes = args[:max_work_item_commit_bytes] if args.key?(:max_work_item_commit_bytes)
           @streaming_computation_configs = args[:streaming_computation_configs] if args.key?(:streaming_computation_configs)
           @user_step_to_state_family_name_map = args[:user_step_to_state_family_name_map] if args.key?(:user_step_to_state_family_name_map)
           @windmill_service_endpoint = args[:windmill_service_endpoint] if args.key?(:windmill_service_endpoint)
@@ -4656,7 +4688,7 @@ module Google
       class StructuredMessage
         include Google::Apis::Core::Hashable
       
-        # Idenfier for this message type.  Used by external systems to
+        # Identifier for this message type.  Used by external systems to
         # internationalize or personalize message.
         # Corresponds to the JSON property `messageKey`
         # @return [String]

data/generated/google/apis/dataflow_v1b3/representations.rb

@@ -1146,6 +1146,7 @@ module Google
           property :cluster_manager_api_service, as: 'clusterManagerApiService'
           property :dataset, as: 'dataset'
           collection :experiments, as: 'experiments'
+          property :flex_resource_scheduling_goal, as: 'flexResourceSchedulingGoal'
           hash :internal_experiments, as: 'internalExperiments'
           hash :sdk_pipeline_options, as: 'sdkPipelineOptions'
           property :service_account_email, as: 'serviceAccountEmail'
@@ -2065,6 +2066,7 @@ module Google
       class StreamingConfigTask
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_work_item_commit_bytes, :numeric_string => true, as: 'maxWorkItemCommitBytes'
           collection :streaming_computation_configs, as: 'streamingComputationConfigs', class: Google::Apis::DataflowV1b3::StreamingComputationConfig, decorator: Google::Apis::DataflowV1b3::StreamingComputationConfig::Representation
       
           hash :user_step_to_state_family_name_map, as: 'userStepToStateFamilyNameMap'

data/generated/google/apis/dataflow_v1b3/service.rb

@@ -86,7 +86,9 @@ module Google
         # @param [String] filter
         #   The kind of filter to use.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [Fixnum] page_size
         #   If there are many jobs, limit response to at most this many.
         #   The actual number of jobs returned will be the lesser of max_responses
@@ -129,11 +131,18 @@ module Google
         end
         
         # Creates a Cloud Dataflow job.
+        # To create a job, we recommend using `projects.locations.jobs.create` with a
+        # [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.create` is not recommended, as your job will always start
+        # in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [Google::Apis::DataflowV1b3::Job] job_object
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] replace_job_id
         #   Deprecated. This field is now in the Job message.
         # @param [String] view
@@ -171,12 +180,19 @@ module Google
         end
         
         # Gets the state of the specified Cloud Dataflow job.
+        # To get the state of a job, we recommend using `projects.locations.jobs.get`
+        # with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.get` is not recommended, as you can only get the state of
+        # jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [String] job_id
         #   The job ID.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] view
         #   The level of information requested in response.
         # @param [String] fields
@@ -210,12 +226,19 @@ module Google
         end
         
         # Request the job status.
+        # To request the status of a job, we recommend using
+        # `projects.locations.jobs.getMetrics` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.getMetrics` is not recommended, as you can only request the
+        # status of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   A project id.
         # @param [String] job_id
         #   The job to get messages for.
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] start_time
         #   Return only metric data that has changed since this time.
         #   Default is to return all information about all metrics for the job.
@@ -249,13 +272,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List the jobs of a project in a given region.
+        # List the jobs of a project.
+        # To list the jobs of a project in a region, we recommend using
+        # `projects.locations.jobs.get` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To
+        # list the all jobs across all regions, use `projects.jobs.aggregated`. Using
+        # `projects.jobs.list` is not recommended, as you can only get the list of
+        # jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The project which owns the jobs.
         # @param [String] filter
         #   The kind of filter to use.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [Fixnum] page_size
         #   If there are many jobs, limit response to at most this many.
         #   The actual number of jobs returned will be the lesser of max_responses
@@ -334,13 +365,20 @@ module Google
         end
         
         # Updates the state of an existing Cloud Dataflow job.
+        # To update the state of an existing job, we recommend using
+        # `projects.locations.jobs.update` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.update` is not recommended, as you can only update the state
+        # of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [String] job_id
         #   The job ID.
         # @param [Google::Apis::DataflowV1b3::Job] job_object
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -445,6 +483,11 @@ module Google
         end
         
         # Request the job status.
+        # To request the status of a job, we recommend using
+        # `projects.locations.jobs.messages.list` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.messages.list` is not recommended, as you can only request
+        # the status of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   A project id.
         # @param [String] job_id
@@ -453,7 +496,9 @@ module Google
         #   Return only messages with timestamps < end_time. The default is now
         #   (i.e. return up to the latest messages available).
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] minimum_importance
         #   Filter to only get messages with importance >= level
         # @param [Fixnum] page_size
@@ -577,7 +622,9 @@ module Google
         # @param [String] project_id
         #   The project to send the WorkerMessages to.
         # @param [String] location
-        #   The location which contains the job
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job.
         # @param [Google::Apis::DataflowV1b3::SendWorkerMessagesRequest] send_worker_messages_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -610,10 +657,17 @@ module Google
         end
         
         # Creates a Cloud Dataflow job.
+        # To create a job, we recommend using `projects.locations.jobs.create` with a
+        # [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.create` is not recommended, as your job will always start
+        # in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [Google::Apis::DataflowV1b3::Job] job_object
         # @param [String] replace_job_id
         #   Deprecated. This field is now in the Job message.
@@ -652,10 +706,17 @@ module Google
         end
         
         # Gets the state of the specified Cloud Dataflow job.
+        # To get the state of a job, we recommend using `projects.locations.jobs.get`
+        # with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.get` is not recommended, as you can only get the state of
+        # jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] job_id
         #   The job ID.
         # @param [String] view
@@ -691,10 +752,17 @@ module Google
         end
         
         # Request the job status.
+        # To request the status of a job, we recommend using
+        # `projects.locations.jobs.getMetrics` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.getMetrics` is not recommended, as you can only request the
+        # status of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   A project id.
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] job_id
         #   The job to get messages for.
         # @param [String] start_time
@@ -730,11 +798,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List the jobs of a project in a given region.
+        # List the jobs of a project.
+        # To list the jobs of a project in a region, we recommend using
+        # `projects.locations.jobs.get` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). To
+        # list the all jobs across all regions, use `projects.jobs.aggregated`. Using
+        # `projects.jobs.list` is not recommended, as you can only get the list of
+        # jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The project which owns the jobs.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] filter
         #   The kind of filter to use.
         # @param [Fixnum] page_size
@@ -818,10 +894,17 @@ module Google
         end
         
         # Updates the state of an existing Cloud Dataflow job.
+        # To update the state of an existing job, we recommend using
+        # `projects.locations.jobs.update` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.update` is not recommended, as you can only update the state
+        # of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location that contains this job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains this job.
         # @param [String] job_id
         #   The job ID.
         # @param [Google::Apis::DataflowV1b3::Job] job_object
@@ -860,7 +943,9 @@ module Google
         # @param [String] project_id
         #   The project id.
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] job_id
         #   The job id.
         # @param [Google::Apis::DataflowV1b3::GetDebugConfigRequest] get_debug_config_request_object
@@ -899,7 +984,9 @@ module Google
         # @param [String] project_id
         #   The project id.
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] job_id
         #   The job id.
         # @param [Google::Apis::DataflowV1b3::SendDebugCaptureRequest] send_debug_capture_request_object
@@ -935,10 +1022,17 @@ module Google
         end
         
         # Request the job status.
+        # To request the status of a job, we recommend using
+        # `projects.locations.jobs.messages.list` with a [regional endpoint]
+        # (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using
+        # `projects.jobs.messages.list` is not recommended, as you can only request
+        # the status of jobs that are running in `us-central1`.
         # @param [String] project_id
         #   A project id.
         # @param [String] location
-        #   The location which contains the job specified by job_id.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the job specified by job_id.
         # @param [String] job_id
         #   The job to get messages about.
         # @param [String] end_time
@@ -995,7 +1089,9 @@ module Google
         # @param [String] project_id
         #   Identifies the project this worker belongs to.
         # @param [String] location
-        #   The location which contains the WorkItem's job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the WorkItem's job.
         # @param [String] job_id
         #   Identifies the workflow job this worker belongs to.
         # @param [Google::Apis::DataflowV1b3::LeaseWorkItemRequest] lease_work_item_request_object
@@ -1034,7 +1130,9 @@ module Google
         # @param [String] project_id
         #   The project which owns the WorkItem's job.
         # @param [String] location
-        #   The location which contains the WorkItem's job.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) that
+        #   contains the WorkItem's job.
         # @param [String] job_id
         #   The job which the WorkItem is part of.
         # @param [Google::Apis::DataflowV1b3::ReportWorkItemStatusRequest] report_work_item_status_request_object
@@ -1073,7 +1171,9 @@ module Google
         # @param [String] project_id
         #   Required. The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location to which to direct the request.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        #   which to direct the request.
         # @param [Google::Apis::DataflowV1b3::CreateJobFromTemplateRequest] create_job_from_template_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1109,7 +1209,9 @@ module Google
         # @param [String] project_id
         #   Required. The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location to which to direct the request.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        #   which to direct the request.
         # @param [String] gcs_path
         #   Required. A Cloud Storage path to the template from which to
         #   create the job.
@@ -1150,7 +1252,9 @@ module Google
         # @param [String] project_id
         #   Required. The ID of the Cloud Platform project that the job belongs to.
         # @param [String] location
-        #   The location to which to direct the request.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        #   which to direct the request.
         # @param [Google::Apis::DataflowV1b3::LaunchTemplateParameters] launch_template_parameters_object
         # @param [String] dynamic_template_gcs_path
         #   Path to dynamic template spec file on GCS.
@@ -1240,7 +1344,9 @@ module Google
         #   create the job.
         #   Must be valid Cloud Storage URL, beginning with 'gs://'.
         # @param [String] location
-        #   The location to which to direct the request.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        #   which to direct the request.
         # @param [String] view
         #   The view to retrieve. Defaults to METADATA_ONLY.
         # @param [String] fields
@@ -1288,7 +1394,9 @@ module Google
         #   the job.
         #   Must be valid Cloud Storage URL, beginning with 'gs://'.
         # @param [String] location
-        #   The location to which to direct the request.
+        #   The [regional endpoint]
+        #   (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) to
+        #   which to direct the request.
         # @param [Boolean] validate_only
         #   If true, the request is validated but not actually executed.
         #   Defaults to false.