public final class Trial extends GeneratedMessageV3 implements TrialOrBuilder
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.
Protobuf type google.cloud.aiplatform.v1.Trial
Static Fields
public static final int CLIENT_ID_FIELD_NUMBER
Field Value
public static final int CUSTOM_JOB_FIELD_NUMBER
Field Value
public static final int END_TIME_FIELD_NUMBER
Field Value
public static final int FINAL_MEASUREMENT_FIELD_NUMBER
Field Value
public static final int ID_FIELD_NUMBER
Field Value
public static final int INFEASIBLE_REASON_FIELD_NUMBER
Field Value
public static final int MEASUREMENTS_FIELD_NUMBER
Field Value
public static final int NAME_FIELD_NUMBER
Field Value
public static final int PARAMETERS_FIELD_NUMBER
Field Value
public static final int START_TIME_FIELD_NUMBER
Field Value
public static final int STATE_FIELD_NUMBER
Field Value
public static final int WEB_ACCESS_URIS_FIELD_NUMBER
Field Value
Static Methods
public static Trial getDefaultInstance()
Returns
public static final Descriptors.Descriptor getDescriptor()
Returns
public static Trial.Builder newBuilder()
Returns
public static Trial.Builder newBuilder(Trial prototype)
Parameter
| Name | Description |
| prototype | Trial
|
Returns
public static Trial parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static Trial parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Trial parseFrom(byte[] data)
Parameter
| Name | Description |
| data | byte[]
|
Returns
Exceptions
public static Trial parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Trial parseFrom(ByteString data)
Parameter
Returns
Exceptions
public static Trial parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Trial parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static Trial parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Trial parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static Trial parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Trial parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
public static Trial parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Parser<Trial> parser()
Returns
Methods
public boolean containsWebAccessUris(String key)
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a HyperparameterTuningJob and the job's
trial_job_spec.enable_web_access field
is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
map<string, string> web_access_uris = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];
public boolean equals(Object obj)
Parameter
Returns
Overrides
public String getClientId()
Output only. The identifier of the client that originally requested this Trial.
Each client is identified by a unique client_id. 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 client_id 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.
string client_id = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| String | The clientId.
|
public ByteString getClientIdBytes()
Output only. The identifier of the client that originally requested this Trial.
Each client is identified by a unique client_id. 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 client_id 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.
string client_id = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
public String getCustomJob()
Output only. The CustomJob name linked to the Trial.
It's set for a HyperparameterTuningJob's Trial.
string custom_job = 11 [(.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.resource_reference) = { ... }
| Type | Description |
| String | The customJob.
|
public ByteString getCustomJobBytes()
Output only. The CustomJob name linked to the Trial.
It's set for a HyperparameterTuningJob's Trial.
string custom_job = 11 [(.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.resource_reference) = { ... }
public Trial getDefaultInstanceForType()
Returns
public Timestamp getEndTime()
Output only. Time when the Trial's status changed to SUCCEEDED or INFEASIBLE.
.google.protobuf.Timestamp end_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
public TimestampOrBuilder getEndTimeOrBuilder()
Output only. Time when the Trial's status changed to SUCCEEDED or INFEASIBLE.
.google.protobuf.Timestamp end_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
public Measurement getFinalMeasurement()
Output only. The final measurement containing the objective value.
.google.cloud.aiplatform.v1.Measurement final_measurement = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
public MeasurementOrBuilder getFinalMeasurementOrBuilder()
Output only. The final measurement containing the objective value.
.google.cloud.aiplatform.v1.Measurement final_measurement = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
Output only. The identifier of the Trial assigned by the service.
string id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
public ByteString getIdBytes()
Output only. The identifier of the Trial assigned by the service.
string id = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
public String getInfeasibleReason()
Output only. A human readable string describing why the Trial is
infeasible. This is set only if Trial state is INFEASIBLE.
string infeasible_reason = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| String | The infeasibleReason.
|
public ByteString getInfeasibleReasonBytes()
Output only. A human readable string describing why the Trial is
infeasible. This is set only if Trial state is INFEASIBLE.
string infeasible_reason = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| ByteString | The bytes for infeasibleReason.
|
public Measurement getMeasurements(int index)
Output only. A list of measurements that are strictly lexicographically
ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
repeated .google.cloud.aiplatform.v1.Measurement measurements = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
public int getMeasurementsCount()
Output only. A list of measurements that are strictly lexicographically
ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
repeated .google.cloud.aiplatform.v1.Measurement measurements = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
public List<Measurement> getMeasurementsList()
Output only. A list of measurements that are strictly lexicographically
ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
repeated .google.cloud.aiplatform.v1.Measurement measurements = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
public MeasurementOrBuilder getMeasurementsOrBuilder(int index)
Output only. A list of measurements that are strictly lexicographically
ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
repeated .google.cloud.aiplatform.v1.Measurement measurements = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
public List<? extends MeasurementOrBuilder> getMeasurementsOrBuilderList()
Output only. A list of measurements that are strictly lexicographically
ordered by their induced tuples (steps, elapsed_duration).
These are used for early stopping computations.
repeated .google.cloud.aiplatform.v1.Measurement measurements = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| List<? extends com.google.cloud.aiplatform.v1.MeasurementOrBuilder> | |
Output only. Resource name of the Trial assigned by the service.
string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| String | The name.
|
public ByteString getNameBytes()
Output only. Resource name of the Trial assigned by the service.
string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];
public Trial.Parameter getParameters(int index)
Output only. The parameters of the Trial.
repeated .google.cloud.aiplatform.v1.Trial.Parameter parameters = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
public int getParametersCount()
Output only. The parameters of the Trial.
repeated .google.cloud.aiplatform.v1.Trial.Parameter parameters = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
public List<Trial.Parameter> getParametersList()
Output only. The parameters of the Trial.
repeated .google.cloud.aiplatform.v1.Trial.Parameter parameters = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
public Trial.ParameterOrBuilder getParametersOrBuilder(int index)
Output only. The parameters of the Trial.
repeated .google.cloud.aiplatform.v1.Trial.Parameter parameters = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
public List<? extends Trial.ParameterOrBuilder> getParametersOrBuilderList()
Output only. The parameters of the Trial.
repeated .google.cloud.aiplatform.v1.Trial.Parameter parameters = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| List<? extends com.google.cloud.aiplatform.v1.Trial.ParameterOrBuilder> | |
public Parser<Trial> getParserForType()
Returns
Overrides
public int getSerializedSize()
Returns
Overrides
public Timestamp getStartTime()
Output only. Time when the Trial was started.
.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
public TimestampOrBuilder getStartTimeOrBuilder()
Output only. Time when the Trial was started.
.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
public Trial.State getState()
Output only. The detailed state of the Trial.
.google.cloud.aiplatform.v1.Trial.State state = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
public int getStateValue()
Output only. The detailed state of the Trial.
.google.cloud.aiplatform.v1.Trial.State state = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| int | The enum numeric value on the wire for state.
|
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
public Map<String,String> getWebAccessUris()
Returns
public int getWebAccessUrisCount()
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a HyperparameterTuningJob and the job's
trial_job_spec.enable_web_access field
is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
map<string, string> web_access_uris = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];
public Map<String,String> getWebAccessUrisMap()
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a HyperparameterTuningJob and the job's
trial_job_spec.enable_web_access field
is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
map<string, string> web_access_uris = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];
public String getWebAccessUrisOrDefault(String key, String defaultValue)
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a HyperparameterTuningJob and the job's
trial_job_spec.enable_web_access field
is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
map<string, string> web_access_uris = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];
public String getWebAccessUrisOrThrow(String key)
Output only. URIs for accessing interactive
shells
(one URI for each training node). Only available if this trial is part of
a HyperparameterTuningJob and the job's
trial_job_spec.enable_web_access field
is true.
The keys are names of each node used for the trial; for example,
workerpool0-0 for the primary node, workerpool1-0 for the first node in
the second worker pool, and workerpool1-1 for the second node in the
second worker pool.
The values are the URIs for each node's interactive shell.
map<string, string> web_access_uris = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];
public boolean hasEndTime()
Output only. Time when the Trial's status changed to SUCCEEDED or INFEASIBLE.
.google.protobuf.Timestamp end_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| boolean | Whether the endTime field is set.
|
public boolean hasFinalMeasurement()
Output only. The final measurement containing the objective value.
.google.cloud.aiplatform.v1.Measurement final_measurement = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| boolean | Whether the finalMeasurement field is set.
|
public boolean hasStartTime()
Output only. Time when the Trial was started.
.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type | Description |
| boolean | Whether the startTime field is set.
|
Returns
Overrides
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
protected MapField internalGetMapField(int number)
Parameter
Returns
Overrides
public final boolean isInitialized()
Returns
Overrides
public Trial.Builder newBuilderForType()
Returns
protected Trial.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
public Trial.Builder toBuilder()
Returns
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions
