public final class CustomJobSpec extends GeneratedMessageV3 implements CustomJobSpecOrBuilder
Represents the spec of a CustomJob.
Protobuf type google.cloud.aiplatform.v1beta1.CustomJobSpec
Static Fields
public static final int BASE_OUTPUT_DIRECTORY_FIELD_NUMBER
Field Value
public static final int ENABLE_WEB_ACCESS_FIELD_NUMBER
Field Value
public static final int NETWORK_FIELD_NUMBER
Field Value
public static final int RESERVED_IP_RANGES_FIELD_NUMBER
Field Value
public static final int SCHEDULING_FIELD_NUMBER
Field Value
public static final int SERVICE_ACCOUNT_FIELD_NUMBER
Field Value
public static final int TENSORBOARD_FIELD_NUMBER
Field Value
public static final int WORKER_POOL_SPECS_FIELD_NUMBER
Field Value
Static Methods
public static CustomJobSpec getDefaultInstance()
Returns
public static final Descriptors.Descriptor getDescriptor()
Returns
public static CustomJobSpec.Builder newBuilder()
Returns
public static CustomJobSpec.Builder newBuilder(CustomJobSpec prototype)
Parameter
Returns
public static CustomJobSpec parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static CustomJobSpec parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static CustomJobSpec parseFrom(byte[] data)
Parameter
| Name | Description |
| data | byte[]
|
Returns
Exceptions
public static CustomJobSpec parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static CustomJobSpec parseFrom(ByteString data)
Parameter
Returns
Exceptions
public static CustomJobSpec parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static CustomJobSpec parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static CustomJobSpec parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static CustomJobSpec parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static CustomJobSpec parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static CustomJobSpec parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
public static CustomJobSpec parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Parser<CustomJobSpec> parser()
Returns
Methods
public boolean equals(Object obj)
Parameter
Returns
Overrides
public GcsDestination getBaseOutputDirectory()
The Cloud Storage location to store the output of this CustomJob or
HyperparameterTuningJob. For HyperparameterTuningJob,
the baseOutputDirectory of
each child CustomJob backing a Trial is set to a subdirectory of name
id under its parent HyperparameterTuningJob's
baseOutputDirectory.
The following Vertex AI environment variables will be passed to
containers or python modules when this field is set:
For CustomJob:
- AIP_MODEL_DIR =
<base_output_directory>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/logs/
For CustomJob backing a Trial of HyperparameterTuningJob:
- AIP_MODEL_DIR =
<base_output_directory>/<trial_id>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/<trial_id>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/<trial_id>/logs/
.google.cloud.aiplatform.v1beta1.GcsDestination base_output_directory = 6;
public GcsDestinationOrBuilder getBaseOutputDirectoryOrBuilder()
The Cloud Storage location to store the output of this CustomJob or
HyperparameterTuningJob. For HyperparameterTuningJob,
the baseOutputDirectory of
each child CustomJob backing a Trial is set to a subdirectory of name
id under its parent HyperparameterTuningJob's
baseOutputDirectory.
The following Vertex AI environment variables will be passed to
containers or python modules when this field is set:
For CustomJob:
- AIP_MODEL_DIR =
<base_output_directory>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/logs/
For CustomJob backing a Trial of HyperparameterTuningJob:
- AIP_MODEL_DIR =
<base_output_directory>/<trial_id>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/<trial_id>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/<trial_id>/logs/
.google.cloud.aiplatform.v1beta1.GcsDestination base_output_directory = 6;
public CustomJobSpec getDefaultInstanceForType()
Returns
public boolean getEnableWebAccess()
Optional. Whether you want Vertex AI to enable interactive shell
access
to training containers.
If set to true, you can access interactive shells at the URIs given
by CustomJob.web_access_uris or Trial.web_access_uris (within
HyperparameterTuningJob.trials).
bool enable_web_access = 10 [(.google.api.field_behavior) = OPTIONAL];
| Type | Description |
| boolean | The enableWebAccess.
|
public String getNetwork()
Optional. The full name of the Compute Engine
network to which the Job
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.
To specify this field, you must have already configured VPC Network
Peering for Vertex
AI.
If this field is left unspecified, the job is not peered with any network.
string network = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
| Type | Description |
| String | The network.
|
public ByteString getNetworkBytes()
Optional. The full name of the Compute Engine
network to which the Job
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.
To specify this field, you must have already configured VPC Network
Peering for Vertex
AI.
If this field is left unspecified, the job is not peered with any network.
string network = 5 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
public Parser<CustomJobSpec> getParserForType()
Returns
Overrides
public String getReservedIpRanges(int index)
Optional. A list of names for the reserved ip ranges under the VPC network
that can be used for this job.
If set, we will deploy the job 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 = 13 [(.google.api.field_behavior) = OPTIONAL];
| Name | Description |
| index | int
The index of the element to return.
|
Returns
| Type | Description |
| String | The reservedIpRanges at the given index.
|
public ByteString getReservedIpRangesBytes(int index)
Optional. A list of names for the reserved ip ranges under the VPC network
that can be used for this job.
If set, we will deploy the job 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 = 13 [(.google.api.field_behavior) = OPTIONAL];
| Name | Description |
| index | int
The index of the value to return.
|
Returns
| Type | Description |
| ByteString | The bytes of the reservedIpRanges at the given index.
|
public int getReservedIpRangesCount()
Optional. A list of names for the reserved ip ranges under the VPC network
that can be used for this job.
If set, we will deploy the job 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 = 13 [(.google.api.field_behavior) = OPTIONAL];
| Type | Description |
| int | The count of reservedIpRanges.
|
public ProtocolStringList getReservedIpRangesList()
Optional. A list of names for the reserved ip ranges under the VPC network
that can be used for this job.
If set, we will deploy the job 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 = 13 [(.google.api.field_behavior) = OPTIONAL];
public Scheduling getScheduling()
Scheduling options for a CustomJob.
.google.cloud.aiplatform.v1beta1.Scheduling scheduling = 3;
public SchedulingOrBuilder getSchedulingOrBuilder()
Scheduling options for a CustomJob.
.google.cloud.aiplatform.v1beta1.Scheduling scheduling = 3;
public int getSerializedSize()
Returns
Overrides
public String getServiceAccount()
Specifies the service account for workload run-as account.
Users submitting jobs must have act-as permission on this run-as account.
If unspecified, the Vertex AI Custom Code Service
Agent
for the CustomJob's project is used.
string service_account = 4;
| Type | Description |
| String | The serviceAccount.
|
public ByteString getServiceAccountBytes()
Specifies the service account for workload run-as account.
Users submitting jobs must have act-as permission on this run-as account.
If unspecified, the Vertex AI Custom Code Service
Agent
for the CustomJob's project is used.
string service_account = 4;
| Type | Description |
| ByteString | The bytes for serviceAccount.
|
public String getTensorboard()
Optional. The name of a Vertex AI Tensorboard resource to which this CustomJob
will upload Tensorboard logs.
Format:
projects/{project}/locations/{location}/tensorboards/{tensorboard}
string tensorboard = 7 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
| Type | Description |
| String | The tensorboard.
|
public ByteString getTensorboardBytes()
Optional. The name of a Vertex AI Tensorboard resource to which this CustomJob
will upload Tensorboard logs.
Format:
projects/{project}/locations/{location}/tensorboards/{tensorboard}
string tensorboard = 7 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
| Type | Description |
| ByteString | The bytes for tensorboard.
|
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
public WorkerPoolSpec getWorkerPoolSpecs(int index)
Required. The spec of the worker pools including machine type and Docker image.
All worker pools except the first one are optional and can be skipped by
providing an empty value.
repeated .google.cloud.aiplatform.v1beta1.WorkerPoolSpec worker_pool_specs = 1 [(.google.api.field_behavior) = REQUIRED];
public int getWorkerPoolSpecsCount()
Required. The spec of the worker pools including machine type and Docker image.
All worker pools except the first one are optional and can be skipped by
providing an empty value.
repeated .google.cloud.aiplatform.v1beta1.WorkerPoolSpec worker_pool_specs = 1 [(.google.api.field_behavior) = REQUIRED];
public List<WorkerPoolSpec> getWorkerPoolSpecsList()
Required. The spec of the worker pools including machine type and Docker image.
All worker pools except the first one are optional and can be skipped by
providing an empty value.
repeated .google.cloud.aiplatform.v1beta1.WorkerPoolSpec worker_pool_specs = 1 [(.google.api.field_behavior) = REQUIRED];
public WorkerPoolSpecOrBuilder getWorkerPoolSpecsOrBuilder(int index)
Required. The spec of the worker pools including machine type and Docker image.
All worker pools except the first one are optional and can be skipped by
providing an empty value.
repeated .google.cloud.aiplatform.v1beta1.WorkerPoolSpec worker_pool_specs = 1 [(.google.api.field_behavior) = REQUIRED];
public List<? extends WorkerPoolSpecOrBuilder> getWorkerPoolSpecsOrBuilderList()
Required. The spec of the worker pools including machine type and Docker image.
All worker pools except the first one are optional and can be skipped by
providing an empty value.
repeated .google.cloud.aiplatform.v1beta1.WorkerPoolSpec worker_pool_specs = 1 [(.google.api.field_behavior) = REQUIRED];
| Type | Description |
| List<? extends com.google.cloud.aiplatform.v1beta1.WorkerPoolSpecOrBuilder> | |
public boolean hasBaseOutputDirectory()
The Cloud Storage location to store the output of this CustomJob or
HyperparameterTuningJob. For HyperparameterTuningJob,
the baseOutputDirectory of
each child CustomJob backing a Trial is set to a subdirectory of name
id under its parent HyperparameterTuningJob's
baseOutputDirectory.
The following Vertex AI environment variables will be passed to
containers or python modules when this field is set:
For CustomJob:
- AIP_MODEL_DIR =
<base_output_directory>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/logs/
For CustomJob backing a Trial of HyperparameterTuningJob:
- AIP_MODEL_DIR =
<base_output_directory>/<trial_id>/model/
- AIP_CHECKPOINT_DIR =
<base_output_directory>/<trial_id>/checkpoints/
- AIP_TENSORBOARD_LOG_DIR =
<base_output_directory>/<trial_id>/logs/
.google.cloud.aiplatform.v1beta1.GcsDestination base_output_directory = 6;
| Type | Description |
| boolean | Whether the baseOutputDirectory field is set.
|
public boolean hasScheduling()
Scheduling options for a CustomJob.
.google.cloud.aiplatform.v1beta1.Scheduling scheduling = 3;
| Type | Description |
| boolean | Whether the scheduling field is set.
|
Returns
Overrides
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
public final boolean isInitialized()
Returns
Overrides
public CustomJobSpec.Builder newBuilderForType()
Returns
protected CustomJobSpec.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
public CustomJobSpec.Builder toBuilder()
Returns
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions
