- 1.35.0 (latest)
- 1.34.0
- 1.33.0
- 1.32.1
- 1.31.0
- 1.30.0
- 1.26.0
- 1.23.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
- 1.16.0
- 1.15.0
- 1.14.0
- 1.13.1
- 1.12.0
- 1.11.0
- 1.10.0
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.0
- 1.5.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.0
- 1.0.0
- 0.39.0
- 0.38.0
- 0.37.1
- 0.32.0
- 0.31.0
- 0.30.0
- 0.29.0
- 0.28.0
- 0.27.0
- 0.26.2
- 0.25.0
- 0.24.0
- 0.23.0
- 0.22.0
- 0.21.0
- 0.20.0
- 0.19.0
- 0.18.0
- 0.17.0
- 0.16.0
- 0.15.0
- 0.13.0
- 0.12.0
- 0.11.1
- 0.10.0
Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class CustomJobSpec.
Represents the spec of a CustomJob.
Generated from protobuf message google.cloud.aiplatform.v1.CustomJobSpec
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ worker_pool_specs
array< Google\Cloud\AIPlatform\V1\WorkerPoolSpec
>
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.
↳ scheduling
↳ service_account
string
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.
↳ network
string
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.
↳ reserved_ip_ranges
array
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'].
↳ base_output_directory
Google\Cloud\AIPlatform\V1\GcsDestination
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/
↳ tensorboard
string
Optional. The name of a Vertex AI Tensorboard
resource to which this CustomJob will upload Tensorboard logs. Format: projects/{project}/locations/{location}/tensorboards/{tensorboard}
↳ enable_web_access
bool
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
).
getWorkerPoolSpecs
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.
setWorkerPoolSpecs
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.
$this
getScheduling
Scheduling options for a CustomJob.
hasScheduling
clearScheduling
setScheduling
Scheduling options for a CustomJob.
$this
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
setServiceAccount
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.
var
string
$this
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
setNetwork
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.
var
string
$this
getReservedIpRanges
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'].
setReservedIpRanges
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'].
var
string[]
$this
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/
hasBaseOutputDirectory
clearBaseOutputDirectory
setBaseOutputDirectory
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/
$this
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
setTensorboard
Optional. The name of a Vertex AI Tensorboard resource to which this CustomJob will upload Tensorboard logs.
Format: projects/{project}/locations/{location}/tensorboards/{tensorboard}
var
string
$this
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
setEnableWebAccess
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
).
var
bool
$this