Class Job.Builder (0.28.0)

public static final class Job.Builder extends GeneratedMessageV3.Builder<Job.Builder> implements JobOrBuilder

Defines a job to be run by the Cloud Dataflow service.

Protobuf type google.dataflow.v1beta3.Job

Implements

JobOrBuilder

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addAllStageStates(Iterable<? extends ExecutionStageState> values)

public Job.Builder addAllStageStates(Iterable<? extends ExecutionStageState> values)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
valuesIterable<? extends com.google.dataflow.v1beta3.ExecutionStageState>
Returns
TypeDescription
Job.Builder

addAllSteps(Iterable<? extends Step> values)

public Job.Builder addAllSteps(Iterable<? extends Step> values)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
valuesIterable<? extends com.google.dataflow.v1beta3.Step>
Returns
TypeDescription
Job.Builder

addAllTempFiles(Iterable<String> values)

public Job.Builder addAllTempFiles(Iterable<String> values)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameter
NameDescription
valuesIterable<String>

The tempFiles to add.

Returns
TypeDescription
Job.Builder

This builder for chaining.

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public Job.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
Job.Builder
Overrides

addStageStates(ExecutionStageState value)

public Job.Builder addStageStates(ExecutionStageState value)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
valueExecutionStageState
Returns
TypeDescription
Job.Builder

addStageStates(ExecutionStageState.Builder builderForValue)

public Job.Builder addStageStates(ExecutionStageState.Builder builderForValue)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
builderForValueExecutionStageState.Builder
Returns
TypeDescription
Job.Builder

addStageStates(int index, ExecutionStageState value)

public Job.Builder addStageStates(int index, ExecutionStageState value)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameters
NameDescription
indexint
valueExecutionStageState
Returns
TypeDescription
Job.Builder

addStageStates(int index, ExecutionStageState.Builder builderForValue)

public Job.Builder addStageStates(int index, ExecutionStageState.Builder builderForValue)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameters
NameDescription
indexint
builderForValueExecutionStageState.Builder
Returns
TypeDescription
Job.Builder

addStageStatesBuilder()

public ExecutionStageState.Builder addStageStatesBuilder()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
ExecutionStageState.Builder

addStageStatesBuilder(int index)

public ExecutionStageState.Builder addStageStatesBuilder(int index)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
indexint
Returns
TypeDescription
ExecutionStageState.Builder

addSteps(Step value)

public Job.Builder addSteps(Step value)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
valueStep
Returns
TypeDescription
Job.Builder

addSteps(Step.Builder builderForValue)

public Job.Builder addSteps(Step.Builder builderForValue)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
builderForValueStep.Builder
Returns
TypeDescription
Job.Builder

addSteps(int index, Step value)

public Job.Builder addSteps(int index, Step value)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameters
NameDescription
indexint
valueStep
Returns
TypeDescription
Job.Builder

addSteps(int index, Step.Builder builderForValue)

public Job.Builder addSteps(int index, Step.Builder builderForValue)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameters
NameDescription
indexint
builderForValueStep.Builder
Returns
TypeDescription
Job.Builder

addStepsBuilder()

public Step.Builder addStepsBuilder()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
Step.Builder

addStepsBuilder(int index)

public Step.Builder addStepsBuilder(int index)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
indexint
Returns
TypeDescription
Step.Builder

addTempFiles(String value)

public Job.Builder addTempFiles(String value)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameter
NameDescription
valueString

The tempFiles to add.

Returns
TypeDescription
Job.Builder

This builder for chaining.

addTempFilesBytes(ByteString value)

public Job.Builder addTempFilesBytes(ByteString value)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameter
NameDescription
valueByteString

The bytes of the tempFiles to add.

Returns
TypeDescription
Job.Builder

This builder for chaining.

build()

public Job build()
Returns
TypeDescription
Job

buildPartial()

public Job buildPartial()
Returns
TypeDescription
Job

clear()

public Job.Builder clear()
Returns
TypeDescription
Job.Builder
Overrides

clearClientRequestId()

public Job.Builder clearClientRequestId()

The client's unique identifier of the job, re-used across retried attempts. If this field is set, the service will ensure its uniqueness. The request to create a job will fail if the service has knowledge of a previously submitted job with the same client's ID and job name. The caller may use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.

string client_request_id = 14;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearCreateTime()

public Job.Builder clearCreateTime()

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Returns
TypeDescription
Job.Builder

clearCreatedFromSnapshotId()

public Job.Builder clearCreatedFromSnapshotId()

If this is specified, the job's initial state is populated from the given snapshot.

string created_from_snapshot_id = 23;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearCurrentState()

public Job.Builder clearCurrentState()

The current state of the job.

Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified.

A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made.

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

.google.dataflow.v1beta3.JobState current_state = 7;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearCurrentStateTime()

public Job.Builder clearCurrentStateTime()

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Returns
TypeDescription
Job.Builder

clearEnvironment()

public Job.Builder clearEnvironment()

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Returns
TypeDescription
Job.Builder

clearExecutionInfo()

public Job.Builder clearExecutionInfo()

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Returns
TypeDescription
Job.Builder

clearField(Descriptors.FieldDescriptor field)

public Job.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
Job.Builder
Overrides

clearId()

public Job.Builder clearId()

The unique ID of this job.

This field is set by the Cloud Dataflow service when the Job is created, and is immutable for the life of the job.

string id = 1;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearJobMetadata()

public Job.Builder clearJobMetadata()

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Returns
TypeDescription
Job.Builder

clearLabels()

public Job.Builder clearLabels()
Returns
TypeDescription
Job.Builder

clearLocation()

public Job.Builder clearLocation()

The regional endpoint that contains this job.

string location = 18;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearName()

public Job.Builder clearName()

The user-specified Cloud Dataflow job name.

Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt returns the existing Job.

The name must match the regular expression a-z?

string name = 3;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public Job.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
Job.Builder
Overrides

clearPipelineDescription()

public Job.Builder clearPipelineDescription()

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Returns
TypeDescription
Job.Builder

clearProjectId()

public Job.Builder clearProjectId()

The ID of the Cloud Platform project that the job belongs to.

string project_id = 2;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearReplaceJobId()

public Job.Builder clearReplaceJobId()

If this job is an update of an existing job, this field is the job ID of the job it replaced.

When sending a CreateJobRequest, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job.

string replace_job_id = 12;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearReplacedByJobId()

public Job.Builder clearReplacedByJobId()

If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field contains the ID of that job.

string replaced_by_job_id = 15;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearRequestedState()

public Job.Builder clearRequestedState()

The job's requested state.

UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.

.google.dataflow.v1beta3.JobState requested_state = 9;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearSatisfiesPzs()

public Job.Builder clearSatisfiesPzs()

Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.

bool satisfies_pzs = 25;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearStageStates()

public Job.Builder clearStageStates()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
Job.Builder

clearStartTime()

public Job.Builder clearStartTime()

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Returns
TypeDescription
Job.Builder

clearSteps()

public Job.Builder clearSteps()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
Job.Builder

clearStepsLocation()

public Job.Builder clearStepsLocation()

The Cloud Storage location where the steps are stored.

string steps_location = 24;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearTempFiles()

public Job.Builder clearTempFiles()

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clearTransformNameMapping()

public Job.Builder clearTransformNameMapping()
Returns
TypeDescription
Job.Builder

clearType()

public Job.Builder clearType()

The type of Cloud Dataflow job.

.google.dataflow.v1beta3.JobType type = 4;

Returns
TypeDescription
Job.Builder

This builder for chaining.

clone()

public Job.Builder clone()
Returns
TypeDescription
Job.Builder
Overrides

containsLabels(String key)

public boolean containsLabels(String key)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameter
NameDescription
keyString
Returns
TypeDescription
boolean

containsTransformNameMapping(String key)

public boolean containsTransformNameMapping(String key)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameter
NameDescription
keyString
Returns
TypeDescription
boolean

getClientRequestId()

public String getClientRequestId()

The client's unique identifier of the job, re-used across retried attempts. If this field is set, the service will ensure its uniqueness. The request to create a job will fail if the service has knowledge of a previously submitted job with the same client's ID and job name. The caller may use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.

string client_request_id = 14;

Returns
TypeDescription
String

The clientRequestId.

getClientRequestIdBytes()

public ByteString getClientRequestIdBytes()

The client's unique identifier of the job, re-used across retried attempts. If this field is set, the service will ensure its uniqueness. The request to create a job will fail if the service has knowledge of a previously submitted job with the same client's ID and job name. The caller may use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.

string client_request_id = 14;

Returns
TypeDescription
ByteString

The bytes for clientRequestId.

getCreateTime()

public Timestamp getCreateTime()

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Returns
TypeDescription
Timestamp

The createTime.

getCreateTimeBuilder()

public Timestamp.Builder getCreateTimeBuilder()

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Returns
TypeDescription
Builder

getCreateTimeOrBuilder()

public TimestampOrBuilder getCreateTimeOrBuilder()

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Returns
TypeDescription
TimestampOrBuilder

getCreatedFromSnapshotId()

public String getCreatedFromSnapshotId()

If this is specified, the job's initial state is populated from the given snapshot.

string created_from_snapshot_id = 23;

Returns
TypeDescription
String

The createdFromSnapshotId.

getCreatedFromSnapshotIdBytes()

public ByteString getCreatedFromSnapshotIdBytes()

If this is specified, the job's initial state is populated from the given snapshot.

string created_from_snapshot_id = 23;

Returns
TypeDescription
ByteString

The bytes for createdFromSnapshotId.

getCurrentState()

public JobState getCurrentState()

The current state of the job.

Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified.

A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made.

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

.google.dataflow.v1beta3.JobState current_state = 7;

Returns
TypeDescription
JobState

The currentState.

getCurrentStateTime()

public Timestamp getCurrentStateTime()

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Returns
TypeDescription
Timestamp

The currentStateTime.

getCurrentStateTimeBuilder()

public Timestamp.Builder getCurrentStateTimeBuilder()

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Returns
TypeDescription
Builder

getCurrentStateTimeOrBuilder()

public TimestampOrBuilder getCurrentStateTimeOrBuilder()

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Returns
TypeDescription
TimestampOrBuilder

getCurrentStateValue()

public int getCurrentStateValue()

The current state of the job.

Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified.

A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made.

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

.google.dataflow.v1beta3.JobState current_state = 7;

Returns
TypeDescription
int

The enum numeric value on the wire for currentState.

getDefaultInstanceForType()

public Job getDefaultInstanceForType()
Returns
TypeDescription
Job

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getEnvironment()

public Environment getEnvironment()

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Returns
TypeDescription
Environment

The environment.

getEnvironmentBuilder()

public Environment.Builder getEnvironmentBuilder()

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Returns
TypeDescription
Environment.Builder

getEnvironmentOrBuilder()

public EnvironmentOrBuilder getEnvironmentOrBuilder()

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Returns
TypeDescription
EnvironmentOrBuilder

getExecutionInfo()

public JobExecutionInfo getExecutionInfo()

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Returns
TypeDescription
JobExecutionInfo

The executionInfo.

getExecutionInfoBuilder()

public JobExecutionInfo.Builder getExecutionInfoBuilder()

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Returns
TypeDescription
JobExecutionInfo.Builder

getExecutionInfoOrBuilder()

public JobExecutionInfoOrBuilder getExecutionInfoOrBuilder()

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Returns
TypeDescription
JobExecutionInfoOrBuilder

getId()

public String getId()

The unique ID of this job.

This field is set by the Cloud Dataflow service when the Job is created, and is immutable for the life of the job.

string id = 1;

Returns
TypeDescription
String

The id.

getIdBytes()

public ByteString getIdBytes()

The unique ID of this job.

This field is set by the Cloud Dataflow service when the Job is created, and is immutable for the life of the job.

string id = 1;

Returns
TypeDescription
ByteString

The bytes for id.

getJobMetadata()

public JobMetadata getJobMetadata()

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Returns
TypeDescription
JobMetadata

The jobMetadata.

getJobMetadataBuilder()

public JobMetadata.Builder getJobMetadataBuilder()

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Returns
TypeDescription
JobMetadata.Builder

getJobMetadataOrBuilder()

public JobMetadataOrBuilder getJobMetadataOrBuilder()

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Returns
TypeDescription
JobMetadataOrBuilder

getLabels()

public Map<String,String> getLabels()

Use #getLabelsMap() instead.

Returns
TypeDescription
Map<String,String>

getLabelsCount()

public int getLabelsCount()

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Returns
TypeDescription
int

getLabelsMap()

public Map<String,String> getLabelsMap()

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Returns
TypeDescription
Map<String,String>

getLabelsOrDefault(String key, String defaultValue)

public String getLabelsOrDefault(String key, String defaultValue)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameters
NameDescription
keyString
defaultValueString
Returns
TypeDescription
String

getLabelsOrThrow(String key)

public String getLabelsOrThrow(String key)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameter
NameDescription
keyString
Returns
TypeDescription
String

getLocation()

public String getLocation()

The regional endpoint that contains this job.

string location = 18;

Returns
TypeDescription
String

The location.

getLocationBytes()

public ByteString getLocationBytes()

The regional endpoint that contains this job.

string location = 18;

Returns
TypeDescription
ByteString

The bytes for location.

getMutableLabels()

public Map<String,String> getMutableLabels()

Use alternate mutation accessors instead.

Returns
TypeDescription
Map<String,String>

getMutableTransformNameMapping()

public Map<String,String> getMutableTransformNameMapping()

Use alternate mutation accessors instead.

Returns
TypeDescription
Map<String,String>

getName()

public String getName()

The user-specified Cloud Dataflow job name.

Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt returns the existing Job.

The name must match the regular expression a-z?

string name = 3;

Returns
TypeDescription
String

The name.

getNameBytes()

public ByteString getNameBytes()

The user-specified Cloud Dataflow job name.

Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt returns the existing Job.

The name must match the regular expression a-z?

string name = 3;

Returns
TypeDescription
ByteString

The bytes for name.

getPipelineDescription()

public PipelineDescription getPipelineDescription()

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Returns
TypeDescription
PipelineDescription

The pipelineDescription.

getPipelineDescriptionBuilder()

public PipelineDescription.Builder getPipelineDescriptionBuilder()

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Returns
TypeDescription
PipelineDescription.Builder

getPipelineDescriptionOrBuilder()

public PipelineDescriptionOrBuilder getPipelineDescriptionOrBuilder()

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Returns
TypeDescription
PipelineDescriptionOrBuilder

getProjectId()

public String getProjectId()

The ID of the Cloud Platform project that the job belongs to.

string project_id = 2;

Returns
TypeDescription
String

The projectId.

getProjectIdBytes()

public ByteString getProjectIdBytes()

The ID of the Cloud Platform project that the job belongs to.

string project_id = 2;

Returns
TypeDescription
ByteString

The bytes for projectId.

getReplaceJobId()

public String getReplaceJobId()

If this job is an update of an existing job, this field is the job ID of the job it replaced.

When sending a CreateJobRequest, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job.

string replace_job_id = 12;

Returns
TypeDescription
String

The replaceJobId.

getReplaceJobIdBytes()

public ByteString getReplaceJobIdBytes()

If this job is an update of an existing job, this field is the job ID of the job it replaced.

When sending a CreateJobRequest, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job.

string replace_job_id = 12;

Returns
TypeDescription
ByteString

The bytes for replaceJobId.

getReplacedByJobId()

public String getReplacedByJobId()

If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field contains the ID of that job.

string replaced_by_job_id = 15;

Returns
TypeDescription
String

The replacedByJobId.

getReplacedByJobIdBytes()

public ByteString getReplacedByJobIdBytes()

If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field contains the ID of that job.

string replaced_by_job_id = 15;

Returns
TypeDescription
ByteString

The bytes for replacedByJobId.

getRequestedState()

public JobState getRequestedState()

The job's requested state.

UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.

.google.dataflow.v1beta3.JobState requested_state = 9;

Returns
TypeDescription
JobState

The requestedState.

getRequestedStateValue()

public int getRequestedStateValue()

The job's requested state.

UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.

.google.dataflow.v1beta3.JobState requested_state = 9;

Returns
TypeDescription
int

The enum numeric value on the wire for requestedState.

getSatisfiesPzs()

public boolean getSatisfiesPzs()

Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.

bool satisfies_pzs = 25;

Returns
TypeDescription
boolean

The satisfiesPzs.

getStageStates(int index)

public ExecutionStageState getStageStates(int index)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
indexint
Returns
TypeDescription
ExecutionStageState

getStageStatesBuilder(int index)

public ExecutionStageState.Builder getStageStatesBuilder(int index)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
indexint
Returns
TypeDescription
ExecutionStageState.Builder

getStageStatesBuilderList()

public List<ExecutionStageState.Builder> getStageStatesBuilderList()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
List<Builder>

getStageStatesCount()

public int getStageStatesCount()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
int

getStageStatesList()

public List<ExecutionStageState> getStageStatesList()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
List<ExecutionStageState>

getStageStatesOrBuilder(int index)

public ExecutionStageStateOrBuilder getStageStatesOrBuilder(int index)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
indexint
Returns
TypeDescription
ExecutionStageStateOrBuilder

getStageStatesOrBuilderList()

public List<? extends ExecutionStageStateOrBuilder> getStageStatesOrBuilderList()

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Returns
TypeDescription
List<? extends com.google.dataflow.v1beta3.ExecutionStageStateOrBuilder>

getStartTime()

public Timestamp getStartTime()

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Returns
TypeDescription
Timestamp

The startTime.

getStartTimeBuilder()

public Timestamp.Builder getStartTimeBuilder()

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Returns
TypeDescription
Builder

getStartTimeOrBuilder()

public TimestampOrBuilder getStartTimeOrBuilder()

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Returns
TypeDescription
TimestampOrBuilder

getSteps(int index)

public Step getSteps(int index)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
indexint
Returns
TypeDescription
Step

getStepsBuilder(int index)

public Step.Builder getStepsBuilder(int index)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
indexint
Returns
TypeDescription
Step.Builder

getStepsBuilderList()

public List<Step.Builder> getStepsBuilderList()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
List<Builder>

getStepsCount()

public int getStepsCount()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
int

getStepsList()

public List<Step> getStepsList()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
List<Step>

getStepsLocation()

public String getStepsLocation()

The Cloud Storage location where the steps are stored.

string steps_location = 24;

Returns
TypeDescription
String

The stepsLocation.

getStepsLocationBytes()

public ByteString getStepsLocationBytes()

The Cloud Storage location where the steps are stored.

string steps_location = 24;

Returns
TypeDescription
ByteString

The bytes for stepsLocation.

getStepsOrBuilder(int index)

public StepOrBuilder getStepsOrBuilder(int index)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
indexint
Returns
TypeDescription
StepOrBuilder

getStepsOrBuilderList()

public List<? extends StepOrBuilder> getStepsOrBuilderList()

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Returns
TypeDescription
List<? extends com.google.dataflow.v1beta3.StepOrBuilder>

getTempFiles(int index)

public String getTempFiles(int index)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The tempFiles at the given index.

getTempFilesBytes(int index)

public ByteString getTempFilesBytes(int index)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the tempFiles at the given index.

getTempFilesCount()

public int getTempFilesCount()

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Returns
TypeDescription
int

The count of tempFiles.

getTempFilesList()

public ProtocolStringList getTempFilesList()

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Returns
TypeDescription
ProtocolStringList

A list containing the tempFiles.

getTransformNameMapping()

public Map<String,String> getTransformNameMapping()
Returns
TypeDescription
Map<String,String>

getTransformNameMappingCount()

public int getTransformNameMappingCount()

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Returns
TypeDescription
int

getTransformNameMappingMap()

public Map<String,String> getTransformNameMappingMap()

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Returns
TypeDescription
Map<String,String>

getTransformNameMappingOrDefault(String key, String defaultValue)

public String getTransformNameMappingOrDefault(String key, String defaultValue)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameters
NameDescription
keyString
defaultValueString
Returns
TypeDescription
String

getTransformNameMappingOrThrow(String key)

public String getTransformNameMappingOrThrow(String key)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameter
NameDescription
keyString
Returns
TypeDescription
String

getType()

public JobType getType()

The type of Cloud Dataflow job.

.google.dataflow.v1beta3.JobType type = 4;

Returns
TypeDescription
JobType

The type.

getTypeValue()

public int getTypeValue()

The type of Cloud Dataflow job.

.google.dataflow.v1beta3.JobType type = 4;

Returns
TypeDescription
int

The enum numeric value on the wire for type.

hasCreateTime()

public boolean hasCreateTime()

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Returns
TypeDescription
boolean

Whether the createTime field is set.

hasCurrentStateTime()

public boolean hasCurrentStateTime()

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Returns
TypeDescription
boolean

Whether the currentStateTime field is set.

hasEnvironment()

public boolean hasEnvironment()

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Returns
TypeDescription
boolean

Whether the environment field is set.

hasExecutionInfo()

public boolean hasExecutionInfo()

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Returns
TypeDescription
boolean

Whether the executionInfo field is set.

hasJobMetadata()

public boolean hasJobMetadata()

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Returns
TypeDescription
boolean

Whether the jobMetadata field is set.

hasPipelineDescription()

public boolean hasPipelineDescription()

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Returns
TypeDescription
boolean

Whether the pipelineDescription field is set.

hasStartTime()

public boolean hasStartTime()

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Returns
TypeDescription
boolean

Whether the startTime field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

internalGetMapField(int number)

protected MapField internalGetMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

internalGetMutableMapField(int number)

protected MapField internalGetMutableMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeCreateTime(Timestamp value)

public Job.Builder mergeCreateTime(Timestamp value)

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

mergeCurrentStateTime(Timestamp value)

public Job.Builder mergeCurrentStateTime(Timestamp value)

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

mergeEnvironment(Environment value)

public Job.Builder mergeEnvironment(Environment value)

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Parameter
NameDescription
valueEnvironment
Returns
TypeDescription
Job.Builder

mergeExecutionInfo(JobExecutionInfo value)

public Job.Builder mergeExecutionInfo(JobExecutionInfo value)

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Parameter
NameDescription
valueJobExecutionInfo
Returns
TypeDescription
Job.Builder

mergeFrom(Job other)

public Job.Builder mergeFrom(Job other)
Parameter
NameDescription
otherJob
Returns
TypeDescription
Job.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public Job.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Job.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public Job.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
Job.Builder
Overrides

mergeJobMetadata(JobMetadata value)

public Job.Builder mergeJobMetadata(JobMetadata value)

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Parameter
NameDescription
valueJobMetadata
Returns
TypeDescription
Job.Builder

mergePipelineDescription(PipelineDescription value)

public Job.Builder mergePipelineDescription(PipelineDescription value)

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Parameter
NameDescription
valuePipelineDescription
Returns
TypeDescription
Job.Builder

mergeStartTime(Timestamp value)

public Job.Builder mergeStartTime(Timestamp value)

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final Job.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
Job.Builder
Overrides

putAllLabels(Map<String,String> values)

public Job.Builder putAllLabels(Map<String,String> values)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameter
NameDescription
valuesMap<String,String>
Returns
TypeDescription
Job.Builder

putAllTransformNameMapping(Map<String,String> values)

public Job.Builder putAllTransformNameMapping(Map<String,String> values)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameter
NameDescription
valuesMap<String,String>
Returns
TypeDescription
Job.Builder

putLabels(String key, String value)

public Job.Builder putLabels(String key, String value)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameters
NameDescription
keyString
valueString
Returns
TypeDescription
Job.Builder

putTransformNameMapping(String key, String value)

public Job.Builder putTransformNameMapping(String key, String value)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameters
NameDescription
keyString
valueString
Returns
TypeDescription
Job.Builder

removeLabels(String key)

public Job.Builder removeLabels(String key)

User-defined labels for this job.

The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions:

  • Keys must conform to regexp: \p{Ll}\p{Lo}{0,62}
  • Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
  • Both keys and values are additionally constrained to be <= 128 bytes in size.

map<string, string> labels = 17;

Parameter
NameDescription
keyString
Returns
TypeDescription
Job.Builder

removeStageStates(int index)

public Job.Builder removeStageStates(int index)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameter
NameDescription
indexint
Returns
TypeDescription
Job.Builder

removeSteps(int index)

public Job.Builder removeSteps(int index)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameter
NameDescription
indexint
Returns
TypeDescription
Job.Builder

removeTransformNameMapping(String key)

public Job.Builder removeTransformNameMapping(String key)

The map of transform name prefixes of the job to be replaced to the corresponding name prefixes of the new job.

map<string, string> transform_name_mapping = 13;

Parameter
NameDescription
keyString
Returns
TypeDescription
Job.Builder

setClientRequestId(String value)

public Job.Builder setClientRequestId(String value)

The client's unique identifier of the job, re-used across retried attempts. If this field is set, the service will ensure its uniqueness. The request to create a job will fail if the service has knowledge of a previously submitted job with the same client's ID and job name. The caller may use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.

string client_request_id = 14;

Parameter
NameDescription
valueString

The clientRequestId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setClientRequestIdBytes(ByteString value)

public Job.Builder setClientRequestIdBytes(ByteString value)

The client's unique identifier of the job, re-used across retried attempts. If this field is set, the service will ensure its uniqueness. The request to create a job will fail if the service has knowledge of a previously submitted job with the same client's ID and job name. The caller may use this field to ensure idempotence of job creation across retried attempts to create a job. By default, the field is empty and, in that case, the service ignores it.

string client_request_id = 14;

Parameter
NameDescription
valueByteString

The bytes for clientRequestId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setCreateTime(Timestamp value)

public Job.Builder setCreateTime(Timestamp value)

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

setCreateTime(Timestamp.Builder builderForValue)

public Job.Builder setCreateTime(Timestamp.Builder builderForValue)

The timestamp when the job was initially created. Immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp create_time = 11;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
Job.Builder

setCreatedFromSnapshotId(String value)

public Job.Builder setCreatedFromSnapshotId(String value)

If this is specified, the job's initial state is populated from the given snapshot.

string created_from_snapshot_id = 23;

Parameter
NameDescription
valueString

The createdFromSnapshotId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setCreatedFromSnapshotIdBytes(ByteString value)

public Job.Builder setCreatedFromSnapshotIdBytes(ByteString value)

If this is specified, the job's initial state is populated from the given snapshot.

string created_from_snapshot_id = 23;

Parameter
NameDescription
valueByteString

The bytes for createdFromSnapshotId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setCurrentState(JobState value)

public Job.Builder setCurrentState(JobState value)

The current state of the job.

Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified.

A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made.

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

.google.dataflow.v1beta3.JobState current_state = 7;

Parameter
NameDescription
valueJobState

The currentState to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setCurrentStateTime(Timestamp value)

public Job.Builder setCurrentStateTime(Timestamp value)

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

setCurrentStateTime(Timestamp.Builder builderForValue)

public Job.Builder setCurrentStateTime(Timestamp.Builder builderForValue)

The timestamp associated with the current state.

.google.protobuf.Timestamp current_state_time = 8;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
Job.Builder

setCurrentStateValue(int value)

public Job.Builder setCurrentStateValue(int value)

The current state of the job.

Jobs are created in the JOB_STATE_STOPPED state unless otherwise specified.

A job in the JOB_STATE_RUNNING state may asynchronously enter a terminal state. After a job has reached a terminal state, no further state updates may be made.

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

.google.dataflow.v1beta3.JobState current_state = 7;

Parameter
NameDescription
valueint

The enum numeric value on the wire for currentState to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setEnvironment(Environment value)

public Job.Builder setEnvironment(Environment value)

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Parameter
NameDescription
valueEnvironment
Returns
TypeDescription
Job.Builder

setEnvironment(Environment.Builder builderForValue)

public Job.Builder setEnvironment(Environment.Builder builderForValue)

The environment for the job.

.google.dataflow.v1beta3.Environment environment = 5;

Parameter
NameDescription
builderForValueEnvironment.Builder
Returns
TypeDescription
Job.Builder

setExecutionInfo(JobExecutionInfo value)

public Job.Builder setExecutionInfo(JobExecutionInfo value)

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Parameter
NameDescription
valueJobExecutionInfo
Returns
TypeDescription
Job.Builder

setExecutionInfo(JobExecutionInfo.Builder builderForValue)

public Job.Builder setExecutionInfo(JobExecutionInfo.Builder builderForValue)

Deprecated.

.google.dataflow.v1beta3.JobExecutionInfo execution_info = 10;

Parameter
NameDescription
builderForValueJobExecutionInfo.Builder
Returns
TypeDescription
Job.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public Job.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
Job.Builder
Overrides

setId(String value)

public Job.Builder setId(String value)

The unique ID of this job.

This field is set by the Cloud Dataflow service when the Job is created, and is immutable for the life of the job.

string id = 1;

Parameter
NameDescription
valueString

The id to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setIdBytes(ByteString value)

public Job.Builder setIdBytes(ByteString value)

The unique ID of this job.

This field is set by the Cloud Dataflow service when the Job is created, and is immutable for the life of the job.

string id = 1;

Parameter
NameDescription
valueByteString

The bytes for id to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setJobMetadata(JobMetadata value)

public Job.Builder setJobMetadata(JobMetadata value)

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Parameter
NameDescription
valueJobMetadata
Returns
TypeDescription
Job.Builder

setJobMetadata(JobMetadata.Builder builderForValue)

public Job.Builder setJobMetadata(JobMetadata.Builder builderForValue)

This field is populated by the Dataflow service to support filtering jobs by the metadata values provided here. Populated for ListJobs and all GetJob views SUMMARY and higher.

.google.dataflow.v1beta3.JobMetadata job_metadata = 21;

Parameter
NameDescription
builderForValueJobMetadata.Builder
Returns
TypeDescription
Job.Builder

setLocation(String value)

public Job.Builder setLocation(String value)

The regional endpoint that contains this job.

string location = 18;

Parameter
NameDescription
valueString

The location to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setLocationBytes(ByteString value)

public Job.Builder setLocationBytes(ByteString value)

The regional endpoint that contains this job.

string location = 18;

Parameter
NameDescription
valueByteString

The bytes for location to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setName(String value)

public Job.Builder setName(String value)

The user-specified Cloud Dataflow job name.

Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt returns the existing Job.

The name must match the regular expression a-z?

string name = 3;

Parameter
NameDescription
valueString

The name to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setNameBytes(ByteString value)

public Job.Builder setNameBytes(ByteString value)

The user-specified Cloud Dataflow job name.

Only one Job with a given name may exist in a project at any given time. If a caller attempts to create a Job with the same name as an already-existing Job, the attempt returns the existing Job.

The name must match the regular expression a-z?

string name = 3;

Parameter
NameDescription
valueByteString

The bytes for name to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setPipelineDescription(PipelineDescription value)

public Job.Builder setPipelineDescription(PipelineDescription value)

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Parameter
NameDescription
valuePipelineDescription
Returns
TypeDescription
Job.Builder

setPipelineDescription(PipelineDescription.Builder builderForValue)

public Job.Builder setPipelineDescription(PipelineDescription.Builder builderForValue)

Preliminary field: The format of this data may change at any time. A description of the user pipeline and stages through which it is executed. Created by Cloud Dataflow service. Only retrieved with JOB_VIEW_DESCRIPTION or JOB_VIEW_ALL.

.google.dataflow.v1beta3.PipelineDescription pipeline_description = 19;

Parameter
NameDescription
builderForValuePipelineDescription.Builder
Returns
TypeDescription
Job.Builder

setProjectId(String value)

public Job.Builder setProjectId(String value)

The ID of the Cloud Platform project that the job belongs to.

string project_id = 2;

Parameter
NameDescription
valueString

The projectId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setProjectIdBytes(ByteString value)

public Job.Builder setProjectIdBytes(ByteString value)

The ID of the Cloud Platform project that the job belongs to.

string project_id = 2;

Parameter
NameDescription
valueByteString

The bytes for projectId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public Job.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
Job.Builder
Overrides

setReplaceJobId(String value)

public Job.Builder setReplaceJobId(String value)

If this job is an update of an existing job, this field is the job ID of the job it replaced.

When sending a CreateJobRequest, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job.

string replace_job_id = 12;

Parameter
NameDescription
valueString

The replaceJobId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setReplaceJobIdBytes(ByteString value)

public Job.Builder setReplaceJobIdBytes(ByteString value)

If this job is an update of an existing job, this field is the job ID of the job it replaced.

When sending a CreateJobRequest, you can update a job by specifying it here. The job named here is stopped, and its intermediate state is transferred to this job.

string replace_job_id = 12;

Parameter
NameDescription
valueByteString

The bytes for replaceJobId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setReplacedByJobId(String value)

public Job.Builder setReplacedByJobId(String value)

If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field contains the ID of that job.

string replaced_by_job_id = 15;

Parameter
NameDescription
valueString

The replacedByJobId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setReplacedByJobIdBytes(ByteString value)

public Job.Builder setReplacedByJobIdBytes(ByteString value)

If another job is an update of this job (and thus, this job is in JOB_STATE_UPDATED), this field contains the ID of that job.

string replaced_by_job_id = 15;

Parameter
NameDescription
valueByteString

The bytes for replacedByJobId to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setRequestedState(JobState value)

public Job.Builder setRequestedState(JobState value)

The job's requested state.

UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.

.google.dataflow.v1beta3.JobState requested_state = 9;

Parameter
NameDescription
valueJobState

The requestedState to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setRequestedStateValue(int value)

public Job.Builder setRequestedStateValue(int value)

The job's requested state.

UpdateJob may be used to switch between the JOB_STATE_STOPPED and JOB_STATE_RUNNING states, by setting requested_state. UpdateJob may also be used to directly set a job's requested state to JOB_STATE_CANCELLED or JOB_STATE_DONE, irrevocably terminating the job if it has not already reached a terminal state.

.google.dataflow.v1beta3.JobState requested_state = 9;

Parameter
NameDescription
valueint

The enum numeric value on the wire for requestedState to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setSatisfiesPzs(boolean value)

public Job.Builder setSatisfiesPzs(boolean value)

Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests.

bool satisfies_pzs = 25;

Parameter
NameDescription
valueboolean

The satisfiesPzs to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setStageStates(int index, ExecutionStageState value)

public Job.Builder setStageStates(int index, ExecutionStageState value)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameters
NameDescription
indexint
valueExecutionStageState
Returns
TypeDescription
Job.Builder

setStageStates(int index, ExecutionStageState.Builder builderForValue)

public Job.Builder setStageStates(int index, ExecutionStageState.Builder builderForValue)

This field may be mutated by the Cloud Dataflow service; callers cannot mutate it.

repeated .google.dataflow.v1beta3.ExecutionStageState stage_states = 20;

Parameters
NameDescription
indexint
builderForValueExecutionStageState.Builder
Returns
TypeDescription
Job.Builder

setStartTime(Timestamp value)

public Job.Builder setStartTime(Timestamp value)

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Parameter
NameDescription
valueTimestamp
Returns
TypeDescription
Job.Builder

setStartTime(Timestamp.Builder builderForValue)

public Job.Builder setStartTime(Timestamp.Builder builderForValue)

The timestamp when the job was started (transitioned to JOB_STATE_PENDING). Flexible resource scheduling jobs are started with some delay after job creation, so start_time is unset before start and is updated when the job is started by the Cloud Dataflow service. For other jobs, start_time always equals to create_time and is immutable and set by the Cloud Dataflow service.

.google.protobuf.Timestamp start_time = 22;

Parameter
NameDescription
builderForValueBuilder
Returns
TypeDescription
Job.Builder

setSteps(int index, Step value)

public Job.Builder setSteps(int index, Step value)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameters
NameDescription
indexint
valueStep
Returns
TypeDescription
Job.Builder

setSteps(int index, Step.Builder builderForValue)

public Job.Builder setSteps(int index, Step.Builder builderForValue)

Exactly one of step or steps_location should be specified.

The top-level steps that constitute the entire job. Only retrieved with JOB_VIEW_ALL.

repeated .google.dataflow.v1beta3.Step steps = 6;

Parameters
NameDescription
indexint
builderForValueStep.Builder
Returns
TypeDescription
Job.Builder

setStepsLocation(String value)

public Job.Builder setStepsLocation(String value)

The Cloud Storage location where the steps are stored.

string steps_location = 24;

Parameter
NameDescription
valueString

The stepsLocation to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setStepsLocationBytes(ByteString value)

public Job.Builder setStepsLocationBytes(ByteString value)

The Cloud Storage location where the steps are stored.

string steps_location = 24;

Parameter
NameDescription
valueByteString

The bytes for stepsLocation to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setTempFiles(int index, String value)

public Job.Builder setTempFiles(int index, String value)

A set of files the system should be aware of that are used for temporary storage. These temporary files will be removed on job completion. No duplicates are allowed. No file patterns are supported.

The supported files are:

Google Cloud Storage:

storage.googleapis.com/{bucket}/{object}
bucket.storage.googleapis.com/{object}

repeated string temp_files = 16;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The tempFiles to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setType(JobType value)

public Job.Builder setType(JobType value)

The type of Cloud Dataflow job.

.google.dataflow.v1beta3.JobType type = 4;

Parameter
NameDescription
valueJobType

The type to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setTypeValue(int value)

public Job.Builder setTypeValue(int value)

The type of Cloud Dataflow job.

.google.dataflow.v1beta3.JobType type = 4;

Parameter
NameDescription
valueint

The enum numeric value on the wire for type to set.

Returns
TypeDescription
Job.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final Job.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
Job.Builder
Overrides