Resource: Trial
A message representing a Trial. A Trial contains a unique set of Parameters that has been or will be evaluated, along with the objective metrics got by running the Trial.
JSON representation |
---|
{ "name": string, "id": string, "state": enum ( |
Fields | |
---|---|
name |
Output only. Resource name of the Trial assigned by the service. |
id |
Output only. The identifier of the Trial assigned by the service. |
state |
Output only. The detailed state of the Trial. |
parameters[] |
Output only. The parameters of the Trial. |
finalMeasurement |
Output only. The final measurement containing the objective value. |
measurements[] |
Output only. A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsedDuration). These are used for early stopping computations. |
startTime |
Output only. time when the Trial was started. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
endTime |
Output only. time when the Trial's status changed to A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
clientId |
Output only. The identifier of the client that originally requested this Trial. Each client is identified by a unique clientId. When a client asks for a suggestion, Vertex AI Vizier will assign it a Trial. The client should evaluate the Trial, complete it, and report back to Vertex AI Vizier. If suggestion is asked again by same clientId before the Trial is completed, the same Trial will be returned. Multiple clients with different client_ids can ask for suggestions simultaneously, each of them will get their own Trial. |
infeasibleReason |
Output only. A human readable string describing why the Trial is infeasible. This is set only if Trial state is |
customJob |
Output only. The CustomJob name linked to the Trial. It's set for a HyperparameterTuningJob's Trial. |
webAccessUris |
Output only. URIs for accessing interactive shells (one URI for each training node). Only available if this trial is part of a The keys are names of each node used for the trial; for example, The values are the URIs for each node's interactive shell. |
State
Describes a Trial state.
Enums | |
---|---|
STATE_UNSPECIFIED |
The Trial state is unspecified. |
REQUESTED |
Indicates that a specific Trial has been requested, but it has not yet been suggested by the service. |
ACTIVE |
Indicates that the Trial has been suggested. |
STOPPING |
Indicates that the Trial should stop according to the service. |
SUCCEEDED |
Indicates that the Trial is completed successfully. |
INFEASIBLE |
Indicates that the Trial should not be attempted again. The service will set a Trial to INFEASIBLE when it's done but missing the finalMeasurement. |
Parameter
A message representing a parameter to be tuned.
JSON representation |
---|
{ "parameterId": string, "value": value } |
Fields | |
---|---|
parameterId |
Output only. The id of the parameter. The parameter should be defined in |
value |
Output only. The value of the parameter. |
Methods |
|
---|---|
|
Adds a measurement of the objective metrics to a Trial. |
|
Checks whether a Trial should stop or not. |
|
Marks a Trial as complete. |
|
Adds a user provided Trial to a Study. |
|
Deletes a Trial. |
|
Gets a Trial. |
|
Lists the Trials associated with a Study. |
|
Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. |
|
Stops a Trial. |
|
Adds one or more Trials to a Study, with parameter values suggested by Vertex AI Vizier. |