blob: 190920763a1c68938d00bb8843a487cd95f75b7c [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="ml_v1.html">AI Platform Training & Prediction API</a> . <a href="ml_v1.projects.html">projects</a> . <a href="ml_v1.projects.locations.html">locations</a> . <a href="ml_v1.projects.locations.studies.html">studies</a> . <a href="ml_v1.projects.locations.studies.trials.html">trials</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#addMeasurement">addMeasurement(name, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070079<p class="firstline">Adds a measurement of the objective metrics to a trial. This measurement is assumed to have been taken before the trial is complete.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070080<p class="toc_element">
81 <code><a href="#checkEarlyStoppingState">checkEarlyStoppingState(name, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070082<p class="firstline">Checks whether a trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a CheckTrialEarlyStoppingStateResponse.</p>
83<p class="toc_element">
84 <code><a href="#close">close()</a></code></p>
85<p class="firstline">Close httplib2 connections.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070086<p class="toc_element">
87 <code><a href="#complete">complete(name, body=None, x__xgafv=None)</a></code></p>
88<p class="firstline">Marks a trial as complete.</p>
89<p class="toc_element">
90 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
91<p class="firstline">Adds a user provided trial to a study.</p>
92<p class="toc_element">
93 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
94<p class="firstline">Deletes a trial.</p>
95<p class="toc_element">
96 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
97<p class="firstline">Gets a trial.</p>
98<p class="toc_element">
99 <code><a href="#list">list(parent, x__xgafv=None)</a></code></p>
100<p class="firstline">Lists the trials associated with a study.</p>
101<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700102 <code><a href="#listOptimalTrials">listOptimalTrials(parent, body=None, x__xgafv=None)</a></code></p>
103<p class="firstline">Lists the pareto-optimal trials for multi-objective study or the optimal trials for single-objective study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency</p>
104<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -0700105 <code><a href="#stop">stop(name, body=None, x__xgafv=None)</a></code></p>
106<p class="firstline">Stops a trial.</p>
107<p class="toc_element">
108 <code><a href="#suggest">suggest(parent, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700109<p class="firstline">Adds one or more trials to a study, with parameter values suggested by AI Platform Vizier. Returns a long-running operation associated with the generation of trial suggestions. When this long-running operation succeeds, it will contain a SuggestTrialsResponse.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -0700110<h3>Method Details</h3>
111<div class="method">
112 <code class="details" id="addMeasurement">addMeasurement(name, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700113 <pre>Adds a measurement of the objective metrics to a trial. This measurement is assumed to have been taken before the trial is complete.
Bu Sun Kim65020912020-05-20 12:08:20 -0700114
115Args:
116 name: string, Required. The trial name. (required)
117 body: object, The request body.
118 The object takes the form of:
119
120{ # The request message for the AddTrialMeasurement service method.
121 &quot;measurement&quot;: { # A message representing a measurement. # Required. The measurement to be added to a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800122 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700123 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700124 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
Bu Sun Kim65020912020-05-20 12:08:20 -0700125 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700126 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800127 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700128 },
129 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700130 },
131 }
132
133 x__xgafv: string, V1 error format.
134 Allowed values
135 1 - v1 error format
136 2 - v2 error format
137
138Returns:
139 An object of the form:
140
141 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700142 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800143 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700144 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
145 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
146 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700147 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800148 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700149 },
150 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700151 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800152 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
153 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
154 { # A message representing a measurement.
155 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
156 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
157 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
158 { # A message representing a metric in the measurement.
159 &quot;value&quot;: 3.14, # Required. The value for this metric.
160 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
161 },
162 ],
163 },
164 ],
165 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
166 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700167 &quot;parameters&quot;: [ # The parameters of the trial.
168 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700169 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
170 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800171 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700172 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700173 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700174 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800175 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700176 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800177 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700178 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700179 }</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700180</div>
181
182<div class="method">
183 <code class="details" id="checkEarlyStoppingState">checkEarlyStoppingState(name, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700184 <pre>Checks whether a trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a CheckTrialEarlyStoppingStateResponse.
Bu Sun Kim65020912020-05-20 12:08:20 -0700185
186Args:
187 name: string, Required. The trial name. (required)
188 body: object, The request body.
189 The object takes the form of:
190
191{ # The request message for the CheckTrialEarlyStoppingState service method.
192 }
193
194 x__xgafv: string, V1 error format.
195 Allowed values
196 1 - v1 error format
197 2 - v2 error format
198
199Returns:
200 An object of the form:
201
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700202 { # This resource represents a long-running operation that is the result of a network API call.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800203 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700204 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700205 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800206 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700207 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
Bu Sun Kim65020912020-05-20 12:08:20 -0700208 {
209 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
210 },
211 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700212 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700213 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700214 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
215 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800216 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
217 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
218 },
219 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700220 }</pre>
221</div>
222
223<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700224 <code class="details" id="close">close()</code>
225 <pre>Close httplib2 connections.</pre>
226</div>
227
228<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700229 <code class="details" id="complete">complete(name, body=None, x__xgafv=None)</code>
230 <pre>Marks a trial as complete.
231
232Args:
233 name: string, Required. The trial name.metat (required)
234 body: object, The request body.
235 The object takes the form of:
236
237{ # The request message for the CompleteTrial service method.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700238 &quot;trialInfeasible&quot;: True or False, # Optional. True if the trial cannot be run with the given Parameter, and final_measurement will be ignored.
239 &quot;finalMeasurement&quot;: { # A message representing a measurement. # Optional. If provided, it will be used as the completed trial&#x27;s final_measurement; Otherwise, the service will auto-select a previously reported measurement as the final-measurement
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800240 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700241 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700242 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
Bu Sun Kim65020912020-05-20 12:08:20 -0700243 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700244 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800245 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim65020912020-05-20 12:08:20 -0700246 },
247 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700248 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800249 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Optional. A human readable reason why the trial was infeasible. This should only be provided if `trial_infeasible` is true.
Bu Sun Kim65020912020-05-20 12:08:20 -0700250 }
251
252 x__xgafv: string, V1 error format.
253 Allowed values
254 1 - v1 error format
255 2 - v2 error format
256
257Returns:
258 An object of the form:
259
260 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700261 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800262 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700263 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
264 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
265 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700266 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800267 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700268 },
269 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700270 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800271 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
272 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
273 { # A message representing a measurement.
274 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
275 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
276 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
277 { # A message representing a metric in the measurement.
278 &quot;value&quot;: 3.14, # Required. The value for this metric.
279 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
280 },
281 ],
282 },
283 ],
284 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
285 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700286 &quot;parameters&quot;: [ # The parameters of the trial.
287 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700288 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
289 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800290 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700291 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700292 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700293 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800294 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700295 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800296 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700297 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700298 }</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700299</div>
300
301<div class="method">
302 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
303 <pre>Adds a user provided trial to a study.
304
305Args:
306 parent: string, Required. The name of the study that the trial belongs to. (required)
307 body: object, The request body.
308 The object takes the form of:
309
310{ # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700311 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800312 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700313 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
314 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
315 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700316 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800317 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700318 },
319 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700320 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800321 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
322 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
323 { # A message representing a measurement.
324 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
325 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
326 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
327 { # A message representing a metric in the measurement.
328 &quot;value&quot;: 3.14, # Required. The value for this metric.
329 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
330 },
331 ],
332 },
333 ],
334 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
335 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700336 &quot;parameters&quot;: [ # The parameters of the trial.
337 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700338 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
339 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800340 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700341 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700342 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700343 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800344 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700345 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800346 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700347 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700348}
Bu Sun Kim65020912020-05-20 12:08:20 -0700349
350 x__xgafv: string, V1 error format.
351 Allowed values
352 1 - v1 error format
353 2 - v2 error format
354
355Returns:
356 An object of the form:
357
358 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700359 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800360 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700361 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
362 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
363 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700364 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800365 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700366 },
367 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700368 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800369 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
370 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
371 { # A message representing a measurement.
372 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
373 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
374 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
375 { # A message representing a metric in the measurement.
376 &quot;value&quot;: 3.14, # Required. The value for this metric.
377 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
378 },
379 ],
380 },
381 ],
382 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
383 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700384 &quot;parameters&quot;: [ # The parameters of the trial.
385 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700386 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
387 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800388 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700389 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700390 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700391 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800392 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700393 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800394 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700395 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700396 }</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700397</div>
398
399<div class="method">
400 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
401 <pre>Deletes a trial.
402
403Args:
404 name: string, Required. The trial name. (required)
405 x__xgafv: string, V1 error format.
406 Allowed values
407 1 - v1 error format
408 2 - v2 error format
409
410Returns:
411 An object of the form:
412
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700413 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700414 }</pre>
415</div>
416
417<div class="method">
418 <code class="details" id="get">get(name, x__xgafv=None)</code>
419 <pre>Gets a trial.
420
421Args:
422 name: string, Required. The trial name. (required)
423 x__xgafv: string, V1 error format.
424 Allowed values
425 1 - v1 error format
426 2 - v2 error format
427
428Returns:
429 An object of the form:
430
431 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700432 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800433 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700434 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
435 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
436 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700437 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800438 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700439 },
440 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700441 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800442 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
443 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
444 { # A message representing a measurement.
445 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
446 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
447 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
448 { # A message representing a metric in the measurement.
449 &quot;value&quot;: 3.14, # Required. The value for this metric.
450 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
451 },
452 ],
453 },
454 ],
455 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
456 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700457 &quot;parameters&quot;: [ # The parameters of the trial.
458 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700459 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
460 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800461 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700462 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700463 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700464 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800465 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700466 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800467 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700468 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700469 }</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700470</div>
471
472<div class="method">
473 <code class="details" id="list">list(parent, x__xgafv=None)</code>
474 <pre>Lists the trials associated with a study.
475
476Args:
477 parent: string, Required. The name of the study that the trial belongs to. (required)
478 x__xgafv: string, V1 error format.
479 Allowed values
480 1 - v1 error format
481 2 - v2 error format
482
483Returns:
484 An object of the form:
485
486 { # The response message for the ListTrials method.
487 &quot;trials&quot;: [ # The trials associated with the study.
488 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700489 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800490 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700491 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
492 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
493 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700494 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800495 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700496 },
497 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700498 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800499 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
500 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
501 { # A message representing a measurement.
502 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
503 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
504 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
505 { # A message representing a metric in the measurement.
506 &quot;value&quot;: 3.14, # Required. The value for this metric.
507 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
508 },
509 ],
510 },
511 ],
512 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
513 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700514 &quot;parameters&quot;: [ # The parameters of the trial.
515 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700516 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
517 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800518 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700519 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700520 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700521 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800522 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700523 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800524 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700525 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
526 },
527 ],
528 }</pre>
529</div>
530
531<div class="method">
532 <code class="details" id="listOptimalTrials">listOptimalTrials(parent, body=None, x__xgafv=None)</code>
533 <pre>Lists the pareto-optimal trials for multi-objective study or the optimal trials for single-objective study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency
534
535Args:
536 parent: string, Required. The name of the study that the pareto-optimal trial belongs to. (required)
537 body: object, The request body.
538 The object takes the form of:
539
540{ # The request message for the ListTrials service method.
541 }
542
543 x__xgafv: string, V1 error format.
544 Allowed values
545 1 - v1 error format
546 2 - v2 error format
547
548Returns:
549 An object of the form:
550
551 { # The response message for the ListOptimalTrials method.
552 &quot;trials&quot;: [ # The pareto-optimal trials for multiple objective study or the optimal trial for single objective study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency
553 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700554 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800555 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700556 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
557 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
558 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700559 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800560 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700561 },
562 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700563 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800564 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
565 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
566 { # A message representing a measurement.
567 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
568 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
569 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
570 { # A message representing a metric in the measurement.
571 &quot;value&quot;: 3.14, # Required. The value for this metric.
572 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
573 },
574 ],
575 },
576 ],
577 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
578 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700579 &quot;parameters&quot;: [ # The parameters of the trial.
580 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700581 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
582 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800583 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700584 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
585 },
586 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800587 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700588 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800589 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700590 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700591 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700592 ],
593 }</pre>
594</div>
595
596<div class="method">
597 <code class="details" id="stop">stop(name, body=None, x__xgafv=None)</code>
598 <pre>Stops a trial.
599
600Args:
601 name: string, Required. The trial name. (required)
602 body: object, The request body.
603 The object takes the form of:
604
605{
606 }
607
608 x__xgafv: string, V1 error format.
609 Allowed values
610 1 - v1 error format
611 2 - v2 error format
612
613Returns:
614 An object of the form:
615
616 { # A message representing a trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700617 &quot;finalMeasurement&quot;: { # A message representing a measurement. # The final measurement containing the objective value.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800618 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700619 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
620 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
621 { # A message representing a metric in the measurement.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700622 &quot;value&quot;: 3.14, # Required. The value for this metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800623 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700624 },
625 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700626 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800627 &quot;startTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial was started.
628 &quot;measurements&quot;: [ # A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_time). These are used for early stopping computations.
629 { # A message representing a measurement.
630 &quot;elapsedTime&quot;: &quot;A String&quot;, # Output only. Time that the trial has been running at the point of this measurement.
631 &quot;stepCount&quot;: &quot;A String&quot;, # The number of steps a machine learning model has been trained for. Must be non-negative.
632 &quot;metrics&quot;: [ # Provides a list of metrics that act as inputs into the objective function.
633 { # A message representing a metric in the measurement.
634 &quot;value&quot;: 3.14, # Required. The value for this metric.
635 &quot;metric&quot;: &quot;A String&quot;, # Required. Metric name.
636 },
637 ],
638 },
639 ],
640 &quot;name&quot;: &quot;A String&quot;, # Output only. Name of the trial assigned by the service.
641 &quot;endTime&quot;: &quot;A String&quot;, # Output only. Time at which the trial&#x27;s status changed to COMPLETED.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700642 &quot;parameters&quot;: [ # The parameters of the trial.
643 { # A message representing a parameter to be tuned. Contains the name of the parameter and the suggested value to use for this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700644 &quot;parameter&quot;: &quot;A String&quot;, # The name of the parameter.
645 &quot;floatValue&quot;: 3.14, # Must be set if ParameterType is DOUBLE or DISCRETE.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800646 &quot;intValue&quot;: &quot;A String&quot;, # Must be set if ParameterType is INTEGER
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700647 &quot;stringValue&quot;: &quot;A String&quot;, # Must be set if ParameterTypeis CATEGORICAL
Bu Sun Kim65020912020-05-20 12:08:20 -0700648 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700649 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800650 &quot;infeasibleReason&quot;: &quot;A String&quot;, # Output only. A human readable string describing why the trial is infeasible. This should only be set if trial_infeasible is true.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700651 &quot;state&quot;: &quot;A String&quot;, # The detailed state of a trial.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800652 &quot;clientId&quot;: &quot;A String&quot;, # Output only. The identifier of the client that originally requested this trial.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700653 &quot;trialInfeasible&quot;: True or False, # Output only. If true, the parameters in this trial are not attempted again.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700654 }</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700655</div>
656
657<div class="method">
658 <code class="details" id="suggest">suggest(parent, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700659 <pre>Adds one or more trials to a study, with parameter values suggested by AI Platform Vizier. Returns a long-running operation associated with the generation of trial suggestions. When this long-running operation succeeds, it will contain a SuggestTrialsResponse.
Bu Sun Kim65020912020-05-20 12:08:20 -0700660
661Args:
662 parent: string, Required. The name of the study that the trial belongs to. (required)
663 body: object, The request body.
664 The object takes the form of:
665
666{ # The request message for the SuggestTrial service method.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700667 &quot;clientId&quot;: &quot;A String&quot;, # Required. The identifier of the client that is requesting the suggestion. If multiple SuggestTrialsRequests have the same `client_id`, the service will return the identical suggested trial if the trial is pending, and provide a new trial if the last suggested trial was completed.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800668 &quot;suggestionCount&quot;: 42, # Required. The number of suggestions requested.
Bu Sun Kim65020912020-05-20 12:08:20 -0700669 }
670
671 x__xgafv: string, V1 error format.
672 Allowed values
673 1 - v1 error format
674 2 - v2 error format
675
676Returns:
677 An object of the form:
678
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700679 { # This resource represents a long-running operation that is the result of a network API call.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800680 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700681 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700682 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800683 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700684 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
Bu Sun Kim65020912020-05-20 12:08:20 -0700685 {
686 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
687 },
688 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700689 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700690 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700691 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
692 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800693 &quot;response&quot;: { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
694 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
695 },
696 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700697 }</pre>
698</div>
699
700</body></html>