Class PipelineJob.Builder (3.52.0) 

public static final class PipelineJob.Builder extends GeneratedMessageV3.Builder<PipelineJob.Builder> implements PipelineJobOrBuilder

An instance of a machine learning PipelineJob.

Protobuf type google.cloud.aiplatform.v1beta1.PipelineJob

Inheritance

Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > PipelineJob.Builder

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addAllPipelineTaskRerunConfigs(Iterable<? extends PipelineTaskRerunConfig> values)

public PipelineJob.Builder addAllPipelineTaskRerunConfigs(Iterable<? extends PipelineTaskRerunConfig> values)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
values Iterable<? extends com.google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig>
Returns
Type Description
PipelineJob.Builder

addAllReservedIpRanges(Iterable<String> values)

public PipelineJob.Builder addAllReservedIpRanges(Iterable<String> values)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameter
Name Description
values Iterable<String>

The reservedIpRanges to add.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

addPipelineTaskRerunConfigs(PipelineTaskRerunConfig value)

public PipelineJob.Builder addPipelineTaskRerunConfigs(PipelineTaskRerunConfig value)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineTaskRerunConfig
Returns
Type Description
PipelineJob.Builder

addPipelineTaskRerunConfigs(PipelineTaskRerunConfig.Builder builderForValue)

public PipelineJob.Builder addPipelineTaskRerunConfigs(PipelineTaskRerunConfig.Builder builderForValue)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue PipelineTaskRerunConfig.Builder
Returns
Type Description
PipelineJob.Builder

addPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig value)

public PipelineJob.Builder addPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig value)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
value PipelineTaskRerunConfig
Returns
Type Description
PipelineJob.Builder

addPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig.Builder builderForValue)

public PipelineJob.Builder addPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig.Builder builderForValue)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
builderForValue PipelineTaskRerunConfig.Builder
Returns
Type Description
PipelineJob.Builder

addPipelineTaskRerunConfigsBuilder()

public PipelineTaskRerunConfig.Builder addPipelineTaskRerunConfigsBuilder()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineTaskRerunConfig.Builder

addPipelineTaskRerunConfigsBuilder(int index)

public PipelineTaskRerunConfig.Builder addPipelineTaskRerunConfigsBuilder(int index)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
PipelineTaskRerunConfig.Builder

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public PipelineJob.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
PipelineJob.Builder
Overrides

addReservedIpRanges(String value)

public PipelineJob.Builder addReservedIpRanges(String value)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameter
Name Description
value String

The reservedIpRanges to add.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

addReservedIpRangesBytes(ByteString value)

public PipelineJob.Builder addReservedIpRangesBytes(ByteString value)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameter
Name Description
value ByteString

The bytes of the reservedIpRanges to add.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

build()

public PipelineJob build()
Returns
Type Description
PipelineJob

buildPartial()

public PipelineJob buildPartial()
Returns
Type Description
PipelineJob

clear()

public PipelineJob.Builder clear()
Returns
Type Description
PipelineJob.Builder
Overrides

clearCreateTime()

public PipelineJob.Builder clearCreateTime()

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearDisplayName()

public PipelineJob.Builder clearDisplayName()

The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters.

string display_name = 2;

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearEncryptionSpec()

public PipelineJob.Builder clearEncryptionSpec()

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Returns
Type Description
PipelineJob.Builder

clearEndTime()

public PipelineJob.Builder clearEndTime()

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearError()

public PipelineJob.Builder clearError()

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearField(Descriptors.FieldDescriptor field)

public PipelineJob.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
PipelineJob.Builder
Overrides

clearJobDetail()

public PipelineJob.Builder clearJobDetail()

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearLabels()

public PipelineJob.Builder clearLabels()
Returns
Type Description
PipelineJob.Builder

clearName()

public PipelineJob.Builder clearName()

Output only. The resource name of the PipelineJob.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearNetwork()

public PipelineJob.Builder clearNetwork()

The full name of the Compute Engine network to which the Pipeline Job's workload should be peered. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name.

Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.

string network = 18 [(.google.api.resource_reference) = { ... }

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public PipelineJob.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
PipelineJob.Builder
Overrides

clearOriginalPipelineJobId()

public PipelineJob.Builder clearOriginalPipelineJobId()

Output only. The original pipeline job id if this pipeline job is a rerun of a previous pipeline job.

int64 original_pipeline_job_id = 29 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearPipelineSpec()

public PipelineJob.Builder clearPipelineSpec()

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Returns
Type Description
PipelineJob.Builder

clearPipelineTaskRerunConfigs()

public PipelineJob.Builder clearPipelineTaskRerunConfigs()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearPreflightValidations()

public PipelineJob.Builder clearPreflightValidations()

Optional. Whether to do component level validations before job creation.

bool preflight_validations = 26 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearReservedIpRanges()

public PipelineJob.Builder clearReservedIpRanges()

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearRuntimeConfig()

public PipelineJob.Builder clearRuntimeConfig()

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Returns
Type Description
PipelineJob.Builder

clearSatisfiesPzi()

public PipelineJob.Builder clearSatisfiesPzi()

Output only. Reserved for future use.

bool satisfies_pzi = 28 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearSatisfiesPzs()

public PipelineJob.Builder clearSatisfiesPzs()

Output only. Reserved for future use.

bool satisfies_pzs = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearScheduleName()

public PipelineJob.Builder clearScheduleName()

Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.

string schedule_name = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearServiceAccount()

public PipelineJob.Builder clearServiceAccount()

The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account

Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

string service_account = 17;

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearStartTime()

public PipelineJob.Builder clearStartTime()

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearState()

public PipelineJob.Builder clearState()

Output only. The detailed state of the job.

.google.cloud.aiplatform.v1beta1.PipelineState state = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearTemplateMetadata()

public PipelineJob.Builder clearTemplateMetadata()

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clearTemplateUri()

public PipelineJob.Builder clearTemplateUri()

A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.

string template_uri = 19;

Returns
Type Description
PipelineJob.Builder

This builder for chaining.

clearUpdateTime()

public PipelineJob.Builder clearUpdateTime()

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJob.Builder

clone()

public PipelineJob.Builder clone()
Returns
Type Description
PipelineJob.Builder
Overrides

containsLabels(String key)

public boolean containsLabels(String key)

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameter
Name Description
key String
Returns
Type Description
boolean

getCreateTime()

public Timestamp getCreateTime()

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The createTime.

getCreateTimeBuilder()

public Timestamp.Builder getCreateTimeBuilder()

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getCreateTimeOrBuilder()

public TimestampOrBuilder getCreateTimeOrBuilder()

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getDefaultInstanceForType()

public PipelineJob getDefaultInstanceForType()
Returns
Type Description
PipelineJob

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getDisplayName()

public String getDisplayName()

The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters.

string display_name = 2;

Returns
Type Description
String

The displayName.

getDisplayNameBytes()

public ByteString getDisplayNameBytes()

The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters.

string display_name = 2;

Returns
Type Description
ByteString

The bytes for displayName.

getEncryptionSpec()

public EncryptionSpec getEncryptionSpec()

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Returns
Type Description
EncryptionSpec

The encryptionSpec.

getEncryptionSpecBuilder()

public EncryptionSpec.Builder getEncryptionSpecBuilder()

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Returns
Type Description
EncryptionSpec.Builder

getEncryptionSpecOrBuilder()

public EncryptionSpecOrBuilder getEncryptionSpecOrBuilder()

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Returns
Type Description
EncryptionSpecOrBuilder

getEndTime()

public Timestamp getEndTime()

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The endTime.

getEndTimeBuilder()

public Timestamp.Builder getEndTimeBuilder()

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getEndTimeOrBuilder()

public TimestampOrBuilder getEndTimeOrBuilder()

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getError()

public Status getError()

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
com.google.rpc.Status

The error.

getErrorBuilder()

public Status.Builder getErrorBuilder()

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
com.google.rpc.Status.Builder

getErrorOrBuilder()

public StatusOrBuilder getErrorOrBuilder()

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
com.google.rpc.StatusOrBuilder

getJobDetail()

public PipelineJobDetail getJobDetail()

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJobDetail

The jobDetail.

getJobDetailBuilder()

public PipelineJobDetail.Builder getJobDetailBuilder()

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJobDetail.Builder

getJobDetailOrBuilder()

public PipelineJobDetailOrBuilder getJobDetailOrBuilder()

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineJobDetailOrBuilder

getLabels() (deprecated)

public Map<String,String> getLabels()

Use #getLabelsMap() instead.

Returns
Type Description
Map<String,String>

getLabelsCount()

public int getLabelsCount()

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Returns
Type Description
int

getLabelsMap()

public Map<String,String> getLabelsMap()

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Returns
Type Description
Map<String,String>

getLabelsOrDefault(String key, String defaultValue)

public String getLabelsOrDefault(String key, String defaultValue)

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameters
Name Description
key String
defaultValue String
Returns
Type Description
String

getLabelsOrThrow(String key)

public String getLabelsOrThrow(String key)

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameter
Name Description
key String
Returns
Type Description
String

getMutableLabels() (deprecated)

public Map<String,String> getMutableLabels()

Use alternate mutation accessors instead.

Returns
Type Description
Map<String,String>

getName()

public String getName()

Output only. The resource name of the PipelineJob.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The name.

getNameBytes()

public ByteString getNameBytes()

Output only. The resource name of the PipelineJob.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for name.

getNetwork()

public String getNetwork()

The full name of the Compute Engine network to which the Pipeline Job's workload should be peered. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name.

Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.

string network = 18 [(.google.api.resource_reference) = { ... }

Returns
Type Description
String

The network.

getNetworkBytes()

public ByteString getNetworkBytes()

The full name of the Compute Engine network to which the Pipeline Job's workload should be peered. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name.

Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.

string network = 18 [(.google.api.resource_reference) = { ... }

Returns
Type Description
ByteString

The bytes for network.

getOriginalPipelineJobId()

public long getOriginalPipelineJobId()

Output only. The original pipeline job id if this pipeline job is a rerun of a previous pipeline job.

int64 original_pipeline_job_id = 29 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
long

The originalPipelineJobId.

getPipelineSpec()

public Struct getPipelineSpec()

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Returns
Type Description
Struct

The pipelineSpec.

getPipelineSpecBuilder()

public Struct.Builder getPipelineSpecBuilder()

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Returns
Type Description
Builder

getPipelineSpecOrBuilder()

public StructOrBuilder getPipelineSpecOrBuilder()

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Returns
Type Description
StructOrBuilder

getPipelineTaskRerunConfigs(int index)

public PipelineTaskRerunConfig getPipelineTaskRerunConfigs(int index)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
PipelineTaskRerunConfig

getPipelineTaskRerunConfigsBuilder(int index)

public PipelineTaskRerunConfig.Builder getPipelineTaskRerunConfigsBuilder(int index)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
PipelineTaskRerunConfig.Builder

getPipelineTaskRerunConfigsBuilderList()

public List<PipelineTaskRerunConfig.Builder> getPipelineTaskRerunConfigsBuilderList()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<Builder>

getPipelineTaskRerunConfigsCount()

public int getPipelineTaskRerunConfigsCount()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
int

getPipelineTaskRerunConfigsList()

public List<PipelineTaskRerunConfig> getPipelineTaskRerunConfigsList()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<PipelineTaskRerunConfig>

getPipelineTaskRerunConfigsOrBuilder(int index)

public PipelineTaskRerunConfigOrBuilder getPipelineTaskRerunConfigsOrBuilder(int index)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
PipelineTaskRerunConfigOrBuilder

getPipelineTaskRerunConfigsOrBuilderList()

public List<? extends PipelineTaskRerunConfigOrBuilder> getPipelineTaskRerunConfigsOrBuilderList()

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<? extends com.google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfigOrBuilder>

getPreflightValidations()

public boolean getPreflightValidations()

Optional. Whether to do component level validations before job creation.

bool preflight_validations = 26 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
boolean

The preflightValidations.

getReservedIpRanges(int index)

public String getReservedIpRanges(int index)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameter
Name Description
index int

The index of the element to return.
Returns
Type Description
String

The reservedIpRanges at the given index.

getReservedIpRangesBytes(int index)

public ByteString getReservedIpRangesBytes(int index)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameter
Name Description
index int

The index of the value to return.
Returns
Type Description
ByteString

The bytes of the reservedIpRanges at the given index.

getReservedIpRangesCount()

public int getReservedIpRangesCount()

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Returns
Type Description
int

The count of reservedIpRanges.

getReservedIpRangesList()

public ProtocolStringList getReservedIpRangesList()

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Returns
Type Description
ProtocolStringList

A list containing the reservedIpRanges.

getRuntimeConfig()

public PipelineJob.RuntimeConfig getRuntimeConfig()

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Returns
Type Description
PipelineJob.RuntimeConfig

The runtimeConfig.

getRuntimeConfigBuilder()

public PipelineJob.RuntimeConfig.Builder getRuntimeConfigBuilder()

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Returns
Type Description
PipelineJob.RuntimeConfig.Builder

getRuntimeConfigOrBuilder()

public PipelineJob.RuntimeConfigOrBuilder getRuntimeConfigOrBuilder()

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Returns
Type Description
PipelineJob.RuntimeConfigOrBuilder

getSatisfiesPzi()

public boolean getSatisfiesPzi()

Output only. Reserved for future use.

bool satisfies_pzi = 28 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

The satisfiesPzi.

getSatisfiesPzs()

public boolean getSatisfiesPzs()

Output only. Reserved for future use.

bool satisfies_pzs = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

The satisfiesPzs.

getScheduleName()

public String getScheduleName()

Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.

string schedule_name = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The scheduleName.

getScheduleNameBytes()

public ByteString getScheduleNameBytes()

Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.

string schedule_name = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for scheduleName.

getServiceAccount()

public String getServiceAccount()

The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account

Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

string service_account = 17;

Returns
Type Description
String

The serviceAccount.

getServiceAccountBytes()

public ByteString getServiceAccountBytes()

The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account

Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

string service_account = 17;

Returns
Type Description
ByteString

The bytes for serviceAccount.

getStartTime()

public Timestamp getStartTime()

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The startTime.

getStartTimeBuilder()

public Timestamp.Builder getStartTimeBuilder()

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getStartTimeOrBuilder()

public TimestampOrBuilder getStartTimeOrBuilder()

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getState()

public PipelineState getState()

Output only. The detailed state of the job.

.google.cloud.aiplatform.v1beta1.PipelineState state = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineState

The state.

getStateValue()

public int getStateValue()

Output only. The detailed state of the job.

.google.cloud.aiplatform.v1beta1.PipelineState state = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
int

The enum numeric value on the wire for state.

getTemplateMetadata()

public PipelineTemplateMetadata getTemplateMetadata()

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineTemplateMetadata

The templateMetadata.

getTemplateMetadataBuilder()

public PipelineTemplateMetadata.Builder getTemplateMetadataBuilder()

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineTemplateMetadata.Builder

getTemplateMetadataOrBuilder()

public PipelineTemplateMetadataOrBuilder getTemplateMetadataOrBuilder()

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
PipelineTemplateMetadataOrBuilder

getTemplateUri()

public String getTemplateUri()

A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.

string template_uri = 19;

Returns
Type Description
String

The templateUri.

getTemplateUriBytes()

public ByteString getTemplateUriBytes()

A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.

string template_uri = 19;

Returns
Type Description
ByteString

The bytes for templateUri.

getUpdateTime()

public Timestamp getUpdateTime()

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The updateTime.

getUpdateTimeBuilder()

public Timestamp.Builder getUpdateTimeBuilder()

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getUpdateTimeOrBuilder()

public TimestampOrBuilder getUpdateTimeOrBuilder()

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

hasCreateTime()

public boolean hasCreateTime()

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the createTime field is set.

hasEncryptionSpec()

public boolean hasEncryptionSpec()

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Returns
Type Description
boolean

Whether the encryptionSpec field is set.

hasEndTime()

public boolean hasEndTime()

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the endTime field is set.

hasError()

public boolean hasError()

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the error field is set.

hasJobDetail()

public boolean hasJobDetail()

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the jobDetail field is set.

hasPipelineSpec()

public boolean hasPipelineSpec()

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Returns
Type Description
boolean

Whether the pipelineSpec field is set.

hasRuntimeConfig()

public boolean hasRuntimeConfig()

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Returns
Type Description
boolean

Whether the runtimeConfig field is set.

hasStartTime()

public boolean hasStartTime()

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the startTime field is set.

hasTemplateMetadata()

public boolean hasTemplateMetadata()

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the templateMetadata field is set.

hasUpdateTime()

public boolean hasUpdateTime()

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the updateTime field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

internalGetMapFieldReflection(int number)

protected MapFieldReflectionAccessor internalGetMapFieldReflection(int number)
Parameter
Name Description
number int
Returns
Type Description
com.google.protobuf.MapFieldReflectionAccessor
Overrides
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMapFieldReflection(int)

internalGetMutableMapFieldReflection(int number)

protected MapFieldReflectionAccessor internalGetMutableMapFieldReflection(int number)
Parameter
Name Description
number int
Returns
Type Description
com.google.protobuf.MapFieldReflectionAccessor
Overrides
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMutableMapFieldReflection(int)

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeCreateTime(Timestamp value)

public PipelineJob.Builder mergeCreateTime(Timestamp value)

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

mergeEncryptionSpec(EncryptionSpec value)

public PipelineJob.Builder mergeEncryptionSpec(EncryptionSpec value)

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Parameter
Name Description
value EncryptionSpec
Returns
Type Description
PipelineJob.Builder

mergeEndTime(Timestamp value)

public PipelineJob.Builder mergeEndTime(Timestamp value)

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

mergeError(Status value)

public PipelineJob.Builder mergeError(Status value)

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value com.google.rpc.Status
Returns
Type Description
PipelineJob.Builder

mergeFrom(PipelineJob other)

public PipelineJob.Builder mergeFrom(PipelineJob other)
Parameter
Name Description
other PipelineJob
Returns
Type Description
PipelineJob.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public PipelineJob.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
PipelineJob.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public PipelineJob.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
PipelineJob.Builder
Overrides

mergeJobDetail(PipelineJobDetail value)

public PipelineJob.Builder mergeJobDetail(PipelineJobDetail value)

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineJobDetail
Returns
Type Description
PipelineJob.Builder

mergePipelineSpec(Struct value)

public PipelineJob.Builder mergePipelineSpec(Struct value)

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Parameter
Name Description
value Struct
Returns
Type Description
PipelineJob.Builder

mergeRuntimeConfig(PipelineJob.RuntimeConfig value)

public PipelineJob.Builder mergeRuntimeConfig(PipelineJob.RuntimeConfig value)

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Parameter
Name Description
value PipelineJob.RuntimeConfig
Returns
Type Description
PipelineJob.Builder

mergeStartTime(Timestamp value)

public PipelineJob.Builder mergeStartTime(Timestamp value)

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

mergeTemplateMetadata(PipelineTemplateMetadata value)

public PipelineJob.Builder mergeTemplateMetadata(PipelineTemplateMetadata value)

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineTemplateMetadata
Returns
Type Description
PipelineJob.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final PipelineJob.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
PipelineJob.Builder
Overrides

mergeUpdateTime(Timestamp value)

public PipelineJob.Builder mergeUpdateTime(Timestamp value)

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

putAllLabels(Map<String,String> values)

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

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameter
Name Description
values Map<String,String>
Returns
Type Description
PipelineJob.Builder

putLabels(String key, String value)

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

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameters
Name Description
key String
value String
Returns
Type Description
PipelineJob.Builder

removeLabels(String key)

public PipelineJob.Builder removeLabels(String key)

The labels with user-defined metadata to organize PipelineJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

Note there is some reserved label key for Vertex AI Pipelines.

  • vertex-ai-pipelines-run-billing-id, user set value will get overrided.

map<string, string> labels = 11;

Parameter
Name Description
key String
Returns
Type Description
PipelineJob.Builder

removePipelineTaskRerunConfigs(int index)

public PipelineJob.Builder removePipelineTaskRerunConfigs(int index)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
PipelineJob.Builder

setCreateTime(Timestamp value)

public PipelineJob.Builder setCreateTime(Timestamp value)

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

setCreateTime(Timestamp.Builder builderForValue)

public PipelineJob.Builder setCreateTime(Timestamp.Builder builderForValue)

Output only. Pipeline creation time.

.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
PipelineJob.Builder

setDisplayName(String value)

public PipelineJob.Builder setDisplayName(String value)

The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters.

string display_name = 2;

Parameter
Name Description
value String

The displayName to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setDisplayNameBytes(ByteString value)

public PipelineJob.Builder setDisplayNameBytes(ByteString value)

The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters.

string display_name = 2;

Parameter
Name Description
value ByteString

The bytes for displayName to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setEncryptionSpec(EncryptionSpec value)

public PipelineJob.Builder setEncryptionSpec(EncryptionSpec value)

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Parameter
Name Description
value EncryptionSpec
Returns
Type Description
PipelineJob.Builder

setEncryptionSpec(EncryptionSpec.Builder builderForValue)

public PipelineJob.Builder setEncryptionSpec(EncryptionSpec.Builder builderForValue)

Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key.

.google.cloud.aiplatform.v1beta1.EncryptionSpec encryption_spec = 16;

Parameter
Name Description
builderForValue EncryptionSpec.Builder
Returns
Type Description
PipelineJob.Builder

setEndTime(Timestamp value)

public PipelineJob.Builder setEndTime(Timestamp value)

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

setEndTime(Timestamp.Builder builderForValue)

public PipelineJob.Builder setEndTime(Timestamp.Builder builderForValue)

Output only. Pipeline end time.

.google.protobuf.Timestamp end_time = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
PipelineJob.Builder

setError(Status value)

public PipelineJob.Builder setError(Status value)

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value com.google.rpc.Status
Returns
Type Description
PipelineJob.Builder

setError(Status.Builder builderForValue)

public PipelineJob.Builder setError(Status.Builder builderForValue)

Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED.

.google.rpc.Status error = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue com.google.rpc.Status.Builder
Returns
Type Description
PipelineJob.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public PipelineJob.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
PipelineJob.Builder
Overrides

setJobDetail(PipelineJobDetail value)

public PipelineJob.Builder setJobDetail(PipelineJobDetail value)

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineJobDetail
Returns
Type Description
PipelineJob.Builder

setJobDetail(PipelineJobDetail.Builder builderForValue)

public PipelineJob.Builder setJobDetail(PipelineJobDetail.Builder builderForValue)

Output only. The details of pipeline run. Not available in the list view.

.google.cloud.aiplatform.v1beta1.PipelineJobDetail job_detail = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue PipelineJobDetail.Builder
Returns
Type Description
PipelineJob.Builder

setName(String value)

public PipelineJob.Builder setName(String value)

Output only. The resource name of the PipelineJob.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The name to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setNameBytes(ByteString value)

public PipelineJob.Builder setNameBytes(ByteString value)

Output only. The resource name of the PipelineJob.

string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for name to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setNetwork(String value)

public PipelineJob.Builder setNetwork(String value)

The full name of the Compute Engine network to which the Pipeline Job's workload should be peered. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name.

Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.

string network = 18 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
value String

The network to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setNetworkBytes(ByteString value)

public PipelineJob.Builder setNetworkBytes(ByteString value)

The full name of the Compute Engine network to which the Pipeline Job's workload should be peered. For example, projects/12345/global/networks/myVPC. Format is of the form projects/{project}/global/networks/{network}. Where {project} is a project number, as in 12345, and {network} is a network name.

Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.

string network = 18 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
value ByteString

The bytes for network to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setOriginalPipelineJobId(long value)

public PipelineJob.Builder setOriginalPipelineJobId(long value)

Output only. The original pipeline job id if this pipeline job is a rerun of a previous pipeline job.

int64 original_pipeline_job_id = 29 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value long

The originalPipelineJobId to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setPipelineSpec(Struct value)

public PipelineJob.Builder setPipelineSpec(Struct value)

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Parameter
Name Description
value Struct
Returns
Type Description
PipelineJob.Builder

setPipelineSpec(Struct.Builder builderForValue)

public PipelineJob.Builder setPipelineSpec(Struct.Builder builderForValue)

The spec of the pipeline.

.google.protobuf.Struct pipeline_spec = 7;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
PipelineJob.Builder

setPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig value)

public PipelineJob.Builder setPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig value)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
value PipelineTaskRerunConfig
Returns
Type Description
PipelineJob.Builder

setPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig.Builder builderForValue)

public PipelineJob.Builder setPipelineTaskRerunConfigs(int index, PipelineTaskRerunConfig.Builder builderForValue)

Output only. The rerun configs for each task in the pipeline job. By default, the rerun will:

  1. Use the same input artifacts as the original run.
  2. Use the same input parameters as the original run.
  3. Skip all the tasks that are already succeeded in the original run.
  4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.

repeated .google.cloud.aiplatform.v1beta1.PipelineTaskRerunConfig pipeline_task_rerun_configs = 30 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
builderForValue PipelineTaskRerunConfig.Builder
Returns
Type Description
PipelineJob.Builder

setPreflightValidations(boolean value)

public PipelineJob.Builder setPreflightValidations(boolean value)

Optional. Whether to do component level validations before job creation.

bool preflight_validations = 26 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value boolean

The preflightValidations to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

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

public PipelineJob.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
PipelineJob.Builder
Overrides

setReservedIpRanges(int index, String value)

public PipelineJob.Builder setReservedIpRanges(int index, String value)

A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload.

If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network.

Example: ['vertex-ai-ip-range'].

repeated string reserved_ip_ranges = 25;

Parameters
Name Description
index int

The index to set the value at.
value String

The reservedIpRanges to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setRuntimeConfig(PipelineJob.RuntimeConfig value)

public PipelineJob.Builder setRuntimeConfig(PipelineJob.RuntimeConfig value)

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Parameter
Name Description
value PipelineJob.RuntimeConfig
Returns
Type Description
PipelineJob.Builder

setRuntimeConfig(PipelineJob.RuntimeConfig.Builder builderForValue)

public PipelineJob.Builder setRuntimeConfig(PipelineJob.RuntimeConfig.Builder builderForValue)

Runtime config of the pipeline.

.google.cloud.aiplatform.v1beta1.PipelineJob.RuntimeConfig runtime_config = 12;

Parameter
Name Description
builderForValue PipelineJob.RuntimeConfig.Builder
Returns
Type Description
PipelineJob.Builder

setSatisfiesPzi(boolean value)

public PipelineJob.Builder setSatisfiesPzi(boolean value)

Output only. Reserved for future use.

bool satisfies_pzi = 28 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value boolean

The satisfiesPzi to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setSatisfiesPzs(boolean value)

public PipelineJob.Builder setSatisfiesPzs(boolean value)

Output only. Reserved for future use.

bool satisfies_pzs = 27 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value boolean

The satisfiesPzs to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setScheduleName(String value)

public PipelineJob.Builder setScheduleName(String value)

Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.

string schedule_name = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The scheduleName to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setScheduleNameBytes(ByteString value)

public PipelineJob.Builder setScheduleNameBytes(ByteString value)

Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.

string schedule_name = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for scheduleName to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setServiceAccount(String value)

public PipelineJob.Builder setServiceAccount(String value)

The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account

Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

string service_account = 17;

Parameter
Name Description
value String

The serviceAccount to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setServiceAccountBytes(ByteString value)

public PipelineJob.Builder setServiceAccountBytes(ByteString value)

The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account

Users starting the pipeline must have the iam.serviceAccounts.actAs permission on this service account.

string service_account = 17;

Parameter
Name Description
value ByteString

The bytes for serviceAccount to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setStartTime(Timestamp value)

public PipelineJob.Builder setStartTime(Timestamp value)

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

setStartTime(Timestamp.Builder builderForValue)

public PipelineJob.Builder setStartTime(Timestamp.Builder builderForValue)

Output only. Pipeline start time.

.google.protobuf.Timestamp start_time = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
PipelineJob.Builder

setState(PipelineState value)

public PipelineJob.Builder setState(PipelineState value)

Output only. The detailed state of the job.

.google.cloud.aiplatform.v1beta1.PipelineState state = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineState

The state to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setStateValue(int value)

public PipelineJob.Builder setStateValue(int value)

Output only. The detailed state of the job.

.google.cloud.aiplatform.v1beta1.PipelineState state = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value int

The enum numeric value on the wire for state to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setTemplateMetadata(PipelineTemplateMetadata value)

public PipelineJob.Builder setTemplateMetadata(PipelineTemplateMetadata value)

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value PipelineTemplateMetadata
Returns
Type Description
PipelineJob.Builder

setTemplateMetadata(PipelineTemplateMetadata.Builder builderForValue)

public PipelineJob.Builder setTemplateMetadata(PipelineTemplateMetadata.Builder builderForValue)

Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry.

.google.cloud.aiplatform.v1beta1.PipelineTemplateMetadata template_metadata = 20 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue PipelineTemplateMetadata.Builder
Returns
Type Description
PipelineJob.Builder

setTemplateUri(String value)

public PipelineJob.Builder setTemplateUri(String value)

A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.

string template_uri = 19;

Parameter
Name Description
value String

The templateUri to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setTemplateUriBytes(ByteString value)

public PipelineJob.Builder setTemplateUriBytes(ByteString value)

A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.

string template_uri = 19;

Parameter
Name Description
value ByteString

The bytes for templateUri to set.
Returns
Type Description
PipelineJob.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final PipelineJob.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
PipelineJob.Builder
Overrides

setUpdateTime(Timestamp value)

public PipelineJob.Builder setUpdateTime(Timestamp value)

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
PipelineJob.Builder

setUpdateTime(Timestamp.Builder builderForValue)

public PipelineJob.Builder setUpdateTime(Timestamp.Builder builderForValue)

Output only. Timestamp when this PipelineJob was most recently updated.

.google.protobuf.Timestamp update_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
PipelineJob.Builder