Google Cloud Ai Platform V1 Client - Class HyperparameterTuningJob (0.24.0)

Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class HyperparameterTuningJob.

Represents a HyperparameterTuningJob. A HyperparameterTuningJob has a Study specification and multiple CustomJobs with identical CustomJob specification.

Generated from protobuf message google.cloud.aiplatform.v1.HyperparameterTuningJob

Namespace

Google \ Cloud \ AIPlatform \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Output only. Resource name of the HyperparameterTuningJob.

↳ display_name string

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

↳ study_spec Google\Cloud\AIPlatform\V1\StudySpec

Required. Study configuration of the HyperparameterTuningJob.

↳ max_trial_count int

Required. The desired total number of Trials.

↳ parallel_trial_count int

Required. The desired number of Trials to run in parallel.

↳ max_failed_trial_count int

The number of failed Trials that need to be seen before failing the HyperparameterTuningJob. If set to 0, Vertex AI decides how many Trials must fail before the whole job fails.

↳ trial_job_spec Google\Cloud\AIPlatform\V1\CustomJobSpec

Required. The spec of a trial job. The same spec applies to the CustomJobs created in all the trials.

↳ trials array<Google\Cloud\AIPlatform\V1\Trial>

Output only. Trials of the HyperparameterTuningJob.

↳ state int

Output only. The detailed state of the job.

↳ create_time Google\Protobuf\Timestamp

Output only. Time when the HyperparameterTuningJob was created.

↳ start_time Google\Protobuf\Timestamp

Output only. Time when the HyperparameterTuningJob for the first time entered the JOB_STATE_RUNNING state.

↳ end_time Google\Protobuf\Timestamp

Output only. Time when the HyperparameterTuningJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.

↳ update_time Google\Protobuf\Timestamp

Output only. Time when the HyperparameterTuningJob was most recently updated.

↳ error Google\Rpc\Status

Output only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

↳ labels array|Google\Protobuf\Internal\MapField

The labels with user-defined metadata to organize HyperparameterTuningJobs. 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.

↳ encryption_spec Google\Cloud\AIPlatform\V1\EncryptionSpec

Customer-managed encryption key options for a HyperparameterTuningJob. If this is set, then all resources created by the HyperparameterTuningJob will be encrypted with the provided encryption key.

getName

Output only. Resource name of the HyperparameterTuningJob.

Returns
TypeDescription
string

setName

Output only. Resource name of the HyperparameterTuningJob.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

Required. The display name of the HyperparameterTuningJob.

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

Returns
TypeDescription
string

setDisplayName

Required. The display name of the HyperparameterTuningJob.

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getStudySpec

Required. Study configuration of the HyperparameterTuningJob.

Returns
TypeDescription
Google\Cloud\AIPlatform\V1\StudySpec|null

hasStudySpec

clearStudySpec

setStudySpec

Required. Study configuration of the HyperparameterTuningJob.

Parameter
NameDescription
var Google\Cloud\AIPlatform\V1\StudySpec
Returns
TypeDescription
$this

getMaxTrialCount

Required. The desired total number of Trials.

Returns
TypeDescription
int

setMaxTrialCount

Required. The desired total number of Trials.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getParallelTrialCount

Required. The desired number of Trials to run in parallel.

Returns
TypeDescription
int

setParallelTrialCount

Required. The desired number of Trials to run in parallel.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getMaxFailedTrialCount

The number of failed Trials that need to be seen before failing the HyperparameterTuningJob.

If set to 0, Vertex AI decides how many Trials must fail before the whole job fails.

Returns
TypeDescription
int

setMaxFailedTrialCount

The number of failed Trials that need to be seen before failing the HyperparameterTuningJob.

If set to 0, Vertex AI decides how many Trials must fail before the whole job fails.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getTrialJobSpec

Required. The spec of a trial job. The same spec applies to the CustomJobs created in all the trials.

Returns
TypeDescription
Google\Cloud\AIPlatform\V1\CustomJobSpec|null

hasTrialJobSpec

clearTrialJobSpec

setTrialJobSpec

Required. The spec of a trial job. The same spec applies to the CustomJobs created in all the trials.

Parameter
NameDescription
var Google\Cloud\AIPlatform\V1\CustomJobSpec
Returns
TypeDescription
$this

getTrials

Output only. Trials of the HyperparameterTuningJob.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setTrials

Output only. Trials of the HyperparameterTuningJob.

Parameter
NameDescription
var array<Google\Cloud\AIPlatform\V1\Trial>
Returns
TypeDescription
$this

getState

Output only. The detailed state of the job.

Returns
TypeDescription
int

setState

Output only. The detailed state of the job.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getCreateTime

Output only. Time when the HyperparameterTuningJob was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Time when the HyperparameterTuningJob was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getStartTime

Output only. Time when the HyperparameterTuningJob for the first time entered the JOB_STATE_RUNNING state.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

Output only. Time when the HyperparameterTuningJob for the first time entered the JOB_STATE_RUNNING state.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getEndTime

Output only. Time when the HyperparameterTuningJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasEndTime

clearEndTime

setEndTime

Output only. Time when the HyperparameterTuningJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getUpdateTime

Output only. Time when the HyperparameterTuningJob was most recently updated.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Time when the HyperparameterTuningJob was most recently updated.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getError

Output only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

Returns
TypeDescription
Google\Rpc\Status|null

hasError

clearError

setError

Output only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

Parameter
NameDescription
var Google\Rpc\Status
Returns
TypeDescription
$this

getLabels

The labels with user-defined metadata to organize HyperparameterTuningJobs.

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.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

The labels with user-defined metadata to organize HyperparameterTuningJobs.

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.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getEncryptionSpec

Customer-managed encryption key options for a HyperparameterTuningJob.

If this is set, then all resources created by the HyperparameterTuningJob will be encrypted with the provided encryption key.

Returns
TypeDescription
Google\Cloud\AIPlatform\V1\EncryptionSpec|null

hasEncryptionSpec

clearEncryptionSpec

setEncryptionSpec

Customer-managed encryption key options for a HyperparameterTuningJob.

If this is set, then all resources created by the HyperparameterTuningJob will be encrypted with the provided encryption key.

Parameter
NameDescription
var Google\Cloud\AIPlatform\V1\EncryptionSpec
Returns
TypeDescription
$this