Google Git Google Git
Sign in
chromium/external/github.com/google/google-api-python-client/refs/heads/issue_14/./docs/dyn/ml_v1beta1.projects.jobs.html
blob: cd6f67a11626ae3442e950441758e8a27aca1cf0 [file] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="ml_v1beta1.html">Google Cloud Machine Learning Engine</a> . <a href="ml_v1beta1.projects.html">projects</a> . <a href="ml_v1beta1.projects.jobs.html">jobs</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#cancel">cancel(name, body, x__xgafv=None)</a></code></p>
<p class="firstline">Cancels a running job.</p>
<p class="toc_element">
<code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a training or a batch prediction job.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Describes a job.</p>
<p class="toc_element">
<code><a href="#list">list(parent, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the jobs in the project.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="cancel">cancel(name, body, x__xgafv=None)</code>
<pre>Cancels a running job.
Args:
name: string, Required. The name of the job to cancel.
Authorization: requires `Editor` role on the parent project. (required)
body: object, The request body. (required)
The object takes the form of:
{ # Request message for the CancelJob method.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # 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 `{}`.
}</pre>
</div>
<div class="method">
<code class="details" id="create">create(parent, body, x__xgafv=None)</code>
<pre>Creates a training or a batch prediction job.
Args:
parent: string, Required. The project name.
Authorization: requires `Editor` role on the specified project. (required)
body: object, The request body. (required)
The object takes the form of:
{ # Represents a training or prediction job.
"trainingOutput": { # Represents results of a training job. Output only. # The current training job result.
"completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
# Only set for hyperparameter tuning jobs.
"isHyperparameterTuningJob": True or False, # Whether this job is a hyperparameter tuning job.
"trials": [ # Results for individual Hyperparameter trials.
# Only set for hyperparameter tuning jobs.
{ # Represents the result of a single hyperparameter tuning trial from a
# training job. The TrainingOutput object that is returned on successful
# completion of a training job with hyperparameter tuning includes a list
# of HyperparameterOutput objects, one for each successful trial.
"hyperparameters": { # The hyperparameters given to this trial.
"a_key": "A String",
},
"trialId": "A String", # The trial id for these results.
"allMetrics": [ # All recorded object metrics for this trial.
{ # An observed value of a metric.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
],
"finalMetric": { # An observed value of a metric. # The final objective metric seen for this trial.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
},
],
"consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
},
"trainingInput": { # Represents input parameters for a training job. # Input parameters to create a training job.
"workerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's worker nodes.
#
# The supported values are the same as those described in the entry for
# `masterType`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `workerCount` is greater than zero.
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for training. If not
# set, Google Cloud ML will choose the latest stable version.
"scaleTier": "A String", # Required. Specifies the machine types, the number of replicas for workers
# and parameter servers.
"masterType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's master worker.
#
# The following types are supported:
#
# <dl>
# <dt>standard</dt>
# <dd>
# A basic machine configuration suitable for training simple models with
# small to moderate datasets.
# </dd>
# <dt>large_model</dt>
# <dd>
# A machine with a lot of memory, specially suited for parameter servers
# when your model is large (having many hidden layers or layers with very
# large numbers of nodes).
# </dd>
# <dt>complex_model_s</dt>
# <dd>
# A machine suitable for the master and workers of the cluster when your
# model requires more computation than the standard machine can handle
# satisfactorily.
# </dd>
# <dt>complex_model_m</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_s</code>.
# </dd>
# <dt>complex_model_l</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_m</code>.
# </dd>
# <dt>standard_gpu</dt>
# <dd>
# A machine equivalent to <code suppresswarning="true">standard</code> that
# also includes a
# <a href="/ml-engine/docs/how-tos/using-gpus">
# GPU that you can use in your trainer</a>.
# </dd>
# <dt>complex_model_m_gpu</dt>
# <dd>
# A machine equivalent to
# <code suppresswarning="true">complex_model_m</code> that also includes
# four GPUs.
# </dd>
# </dl>
#
# You must set this value when `scaleTier` is set to `CUSTOM`.
"hyperparameters": { # Represents a set of hyperparameters to optimize. # Optional. The set of Hyperparameters to tune.
"maxTrials": 42, # Optional. How many training trials should be attempted to optimize
# the specified hyperparameters.
#
# Defaults to one.
"hyperparameterMetricTag": "A String", # Optional. The Tensorflow summary tag name to use for optimizing trials. For
# current versions of Tensorflow, this tag name should exactly match what is
# shown in Tensorboard, including all scopes. For versions of Tensorflow
# prior to 0.12, this should be only the tag passed to tf.Summary.
# By default, "training/hptuning/metric" will be used.
"params": [ # Required. The set of parameters to tune.
{ # Represents a single hyperparameter to optimize.
"maxValue": 3.14, # Required if typeis `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is `INTEGER`.
"categoricalValues": [ # Required if type is `CATEGORICAL`. The list of possible categories.
"A String",
],
"discreteValues": [ # Required if type is `DISCRETE`.
# A list of feasible points.
# The list should be in strictly increasing order. For instance, this
# parameter might have possible settings of 1.5, 2.5, and 4.0. This list
# should not contain more than 1,000 values.
3.14,
],
"parameterName": "A String", # Required. The parameter name must be unique amongst all ParameterConfigs in
# a HyperparameterSpec message. E.g., "learning_rate".
"minValue": 3.14, # Required if type is `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is INTEGER.
"type": "A String", # Required. The type of the parameter.
"scaleType": "A String", # Optional. How the parameter should be scaled to the hypercube.
# Leave unset for categorical parameters.
# Some kind of scaling is strongly recommended for real or integral
# parameters (e.g., `UNIT_LINEAR_SCALE`).
},
],
"maxParallelTrials": 42, # Optional. The number of training trials to run concurrently.
# You can reduce the time it takes to perform hyperparameter tuning by adding
# trials in parallel. However, each trail only benefits from the information
# gained in completed trials. That means that a trial does not get access to
# the results of trials running at the same time, which could reduce the
# quality of the overall optimization.
#
# Each trial will use the same scale tier and machine types.
#
# Defaults to one.
"goal": "A String", # Required. The type of goal to use for tuning. Available types are
# `MAXIMIZE` and `MINIMIZE`.
#
# Defaults to `MAXIMIZE`.
},
"region": "A String", # Required. The Google Compute Engine region to run the training job in.
"args": [ # Optional. Command line arguments to pass to the program.
"A String",
],
"pythonModule": "A String", # Required. The Python module name to run after installing the packages.
"jobDir": "A String", # Optional. A Google Cloud Storage path in which to store training outputs
# and other data needed for training. This path is passed to your TensorFlow
# program as the 'job_dir' command-line argument. The benefit of specifying
# this field is that Cloud ML validates the path for use in training.
"packageUris": [ # Required. The Google Cloud Storage location of the packages with
# the training program and any additional dependencies.
# The maximum number of package URIs is 100.
"A String",
],
"workerCount": "A String", # Optional. The number of worker replicas to use for the training job. Each
# replica in the cluster will be of the type specified in `worker_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`. If you
# set this value, you must also set `worker_type`.
"parameterServerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's parameter server.
#
# The supported values are the same as those described in the entry for
# `master_type`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `parameter_server_count` is greater than zero.
"parameterServerCount": "A String", # Optional. The number of parameter server replicas to use for the training
# job. Each replica in the cluster will be of the type specified in
# `parameter_server_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`.If you
# set this value, you must also set `parameter_server_type`.
},
"startTime": "A String", # Output only. When the job processing was started.
"errorMessage": "A String", # Output only. The details of a failure or a cancellation.
"jobId": "A String", # Required. The user-specified id of the job.
"state": "A String", # Output only. The detailed state of a job.
"predictionInput": { # Represents input parameters for a prediction job. # Input parameters to create a prediction job.
"modelName": "A String", # Use this field if you want to use the default version for the specified
# model. The string must use the following format:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>[YOUR_MODEL]</var>"`
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for this batch
# prediction. If not set, Google Cloud ML will pick the runtime version used
# during the CreateVersion request for this model version, or choose the
# latest stable version when model version information is not available
# such as when the model is specified by uri.
"inputPaths": [ # Required. The Google Cloud Storage location of the input data files.
# May contain wildcards.
"A String",
],
"maxWorkerCount": "A String", # Optional. The maximum number of workers to be used for parallel processing.
# Defaults to 10 if not specified.
"uri": "A String", # Use this field if you want to specify a Google Cloud Storage path for
# the model to use.
"outputPath": "A String", # Required. The output Google Cloud Storage location.
"dataFormat": "A String", # Required. The format of the input data files.
"versionName": "A String", # Use this field if you want to specify a version of the model to use. The
# string is formatted the same way as `model_version`, with the addition
# of the version information:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>YOUR_MODEL/versions/<var>[YOUR_VERSION]</var>"`
"region": "A String", # Required. The Google Compute Engine region to run the prediction job in.
},
"endTime": "A String", # Output only. When the job processing was completed.
"predictionOutput": { # Represents results of a prediction job. # The current prediction job result.
"outputPath": "A String", # The output Google Cloud Storage location provided at the job creation time.
"nodeHours": 3.14, # Node hours used by the batch prediction job.
"predictionCount": "A String", # The number of generated predictions.
"errorCount": "A String", # The number of data instances which resulted in errors.
},
"createTime": "A String", # Output only. When the job was created.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Represents a training or prediction job.
"trainingOutput": { # Represents results of a training job. Output only. # The current training job result.
"completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
# Only set for hyperparameter tuning jobs.
"isHyperparameterTuningJob": True or False, # Whether this job is a hyperparameter tuning job.
"trials": [ # Results for individual Hyperparameter trials.
# Only set for hyperparameter tuning jobs.
{ # Represents the result of a single hyperparameter tuning trial from a
# training job. The TrainingOutput object that is returned on successful
# completion of a training job with hyperparameter tuning includes a list
# of HyperparameterOutput objects, one for each successful trial.
"hyperparameters": { # The hyperparameters given to this trial.
"a_key": "A String",
},
"trialId": "A String", # The trial id for these results.
"allMetrics": [ # All recorded object metrics for this trial.
{ # An observed value of a metric.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
],
"finalMetric": { # An observed value of a metric. # The final objective metric seen for this trial.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
},
],
"consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
},
"trainingInput": { # Represents input parameters for a training job. # Input parameters to create a training job.
"workerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's worker nodes.
#
# The supported values are the same as those described in the entry for
# `masterType`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `workerCount` is greater than zero.
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for training. If not
# set, Google Cloud ML will choose the latest stable version.
"scaleTier": "A String", # Required. Specifies the machine types, the number of replicas for workers
# and parameter servers.
"masterType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's master worker.
#
# The following types are supported:
#
# <dl>
# <dt>standard</dt>
# <dd>
# A basic machine configuration suitable for training simple models with
# small to moderate datasets.
# </dd>
# <dt>large_model</dt>
# <dd>
# A machine with a lot of memory, specially suited for parameter servers
# when your model is large (having many hidden layers or layers with very
# large numbers of nodes).
# </dd>
# <dt>complex_model_s</dt>
# <dd>
# A machine suitable for the master and workers of the cluster when your
# model requires more computation than the standard machine can handle
# satisfactorily.
# </dd>
# <dt>complex_model_m</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_s</code>.
# </dd>
# <dt>complex_model_l</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_m</code>.
# </dd>
# <dt>standard_gpu</dt>
# <dd>
# A machine equivalent to <code suppresswarning="true">standard</code> that
# also includes a
# <a href="/ml-engine/docs/how-tos/using-gpus">
# GPU that you can use in your trainer</a>.
# </dd>
# <dt>complex_model_m_gpu</dt>
# <dd>
# A machine equivalent to
# <code suppresswarning="true">complex_model_m</code> that also includes
# four GPUs.
# </dd>
# </dl>
#
# You must set this value when `scaleTier` is set to `CUSTOM`.
"hyperparameters": { # Represents a set of hyperparameters to optimize. # Optional. The set of Hyperparameters to tune.
"maxTrials": 42, # Optional. How many training trials should be attempted to optimize
# the specified hyperparameters.
#
# Defaults to one.
"hyperparameterMetricTag": "A String", # Optional. The Tensorflow summary tag name to use for optimizing trials. For
# current versions of Tensorflow, this tag name should exactly match what is
# shown in Tensorboard, including all scopes. For versions of Tensorflow
# prior to 0.12, this should be only the tag passed to tf.Summary.
# By default, "training/hptuning/metric" will be used.
"params": [ # Required. The set of parameters to tune.
{ # Represents a single hyperparameter to optimize.
"maxValue": 3.14, # Required if typeis `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is `INTEGER`.
"categoricalValues": [ # Required if type is `CATEGORICAL`. The list of possible categories.
"A String",
],
"discreteValues": [ # Required if type is `DISCRETE`.
# A list of feasible points.
# The list should be in strictly increasing order. For instance, this
# parameter might have possible settings of 1.5, 2.5, and 4.0. This list
# should not contain more than 1,000 values.
3.14,
],
"parameterName": "A String", # Required. The parameter name must be unique amongst all ParameterConfigs in
# a HyperparameterSpec message. E.g., "learning_rate".
"minValue": 3.14, # Required if type is `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is INTEGER.
"type": "A String", # Required. The type of the parameter.
"scaleType": "A String", # Optional. How the parameter should be scaled to the hypercube.
# Leave unset for categorical parameters.
# Some kind of scaling is strongly recommended for real or integral
# parameters (e.g., `UNIT_LINEAR_SCALE`).
},
],
"maxParallelTrials": 42, # Optional. The number of training trials to run concurrently.
# You can reduce the time it takes to perform hyperparameter tuning by adding
# trials in parallel. However, each trail only benefits from the information
# gained in completed trials. That means that a trial does not get access to
# the results of trials running at the same time, which could reduce the
# quality of the overall optimization.
#
# Each trial will use the same scale tier and machine types.
#
# Defaults to one.
"goal": "A String", # Required. The type of goal to use for tuning. Available types are
# `MAXIMIZE` and `MINIMIZE`.
#
# Defaults to `MAXIMIZE`.
},
"region": "A String", # Required. The Google Compute Engine region to run the training job in.
"args": [ # Optional. Command line arguments to pass to the program.
"A String",
],
"pythonModule": "A String", # Required. The Python module name to run after installing the packages.
"jobDir": "A String", # Optional. A Google Cloud Storage path in which to store training outputs
# and other data needed for training. This path is passed to your TensorFlow
# program as the 'job_dir' command-line argument. The benefit of specifying
# this field is that Cloud ML validates the path for use in training.
"packageUris": [ # Required. The Google Cloud Storage location of the packages with
# the training program and any additional dependencies.
# The maximum number of package URIs is 100.
"A String",
],
"workerCount": "A String", # Optional. The number of worker replicas to use for the training job. Each
# replica in the cluster will be of the type specified in `worker_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`. If you
# set this value, you must also set `worker_type`.
"parameterServerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's parameter server.
#
# The supported values are the same as those described in the entry for
# `master_type`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `parameter_server_count` is greater than zero.
"parameterServerCount": "A String", # Optional. The number of parameter server replicas to use for the training
# job. Each replica in the cluster will be of the type specified in
# `parameter_server_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`.If you
# set this value, you must also set `parameter_server_type`.
},
"startTime": "A String", # Output only. When the job processing was started.
"errorMessage": "A String", # Output only. The details of a failure or a cancellation.
"jobId": "A String", # Required. The user-specified id of the job.
"state": "A String", # Output only. The detailed state of a job.
"predictionInput": { # Represents input parameters for a prediction job. # Input parameters to create a prediction job.
"modelName": "A String", # Use this field if you want to use the default version for the specified
# model. The string must use the following format:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>[YOUR_MODEL]</var>"`
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for this batch
# prediction. If not set, Google Cloud ML will pick the runtime version used
# during the CreateVersion request for this model version, or choose the
# latest stable version when model version information is not available
# such as when the model is specified by uri.
"inputPaths": [ # Required. The Google Cloud Storage location of the input data files.
# May contain wildcards.
"A String",
],
"maxWorkerCount": "A String", # Optional. The maximum number of workers to be used for parallel processing.
# Defaults to 10 if not specified.
"uri": "A String", # Use this field if you want to specify a Google Cloud Storage path for
# the model to use.
"outputPath": "A String", # Required. The output Google Cloud Storage location.
"dataFormat": "A String", # Required. The format of the input data files.
"versionName": "A String", # Use this field if you want to specify a version of the model to use. The
# string is formatted the same way as `model_version`, with the addition
# of the version information:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>YOUR_MODEL/versions/<var>[YOUR_VERSION]</var>"`
"region": "A String", # Required. The Google Compute Engine region to run the prediction job in.
},
"endTime": "A String", # Output only. When the job processing was completed.
"predictionOutput": { # Represents results of a prediction job. # The current prediction job result.
"outputPath": "A String", # The output Google Cloud Storage location provided at the job creation time.
"nodeHours": 3.14, # Node hours used by the batch prediction job.
"predictionCount": "A String", # The number of generated predictions.
"errorCount": "A String", # The number of data instances which resulted in errors.
},
"createTime": "A String", # Output only. When the job was created.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
<pre>Describes a job.
Args:
name: string, Required. The name of the job to get the description of.
Authorization: requires `Viewer` role on the parent project. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Represents a training or prediction job.
"trainingOutput": { # Represents results of a training job. Output only. # The current training job result.
"completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
# Only set for hyperparameter tuning jobs.
"isHyperparameterTuningJob": True or False, # Whether this job is a hyperparameter tuning job.
"trials": [ # Results for individual Hyperparameter trials.
# Only set for hyperparameter tuning jobs.
{ # Represents the result of a single hyperparameter tuning trial from a
# training job. The TrainingOutput object that is returned on successful
# completion of a training job with hyperparameter tuning includes a list
# of HyperparameterOutput objects, one for each successful trial.
"hyperparameters": { # The hyperparameters given to this trial.
"a_key": "A String",
},
"trialId": "A String", # The trial id for these results.
"allMetrics": [ # All recorded object metrics for this trial.
{ # An observed value of a metric.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
],
"finalMetric": { # An observed value of a metric. # The final objective metric seen for this trial.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
},
],
"consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
},
"trainingInput": { # Represents input parameters for a training job. # Input parameters to create a training job.
"workerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's worker nodes.
#
# The supported values are the same as those described in the entry for
# `masterType`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `workerCount` is greater than zero.
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for training. If not
# set, Google Cloud ML will choose the latest stable version.
"scaleTier": "A String", # Required. Specifies the machine types, the number of replicas for workers
# and parameter servers.
"masterType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's master worker.
#
# The following types are supported:
#
# <dl>
# <dt>standard</dt>
# <dd>
# A basic machine configuration suitable for training simple models with
# small to moderate datasets.
# </dd>
# <dt>large_model</dt>
# <dd>
# A machine with a lot of memory, specially suited for parameter servers
# when your model is large (having many hidden layers or layers with very
# large numbers of nodes).
# </dd>
# <dt>complex_model_s</dt>
# <dd>
# A machine suitable for the master and workers of the cluster when your
# model requires more computation than the standard machine can handle
# satisfactorily.
# </dd>
# <dt>complex_model_m</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_s</code>.
# </dd>
# <dt>complex_model_l</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_m</code>.
# </dd>
# <dt>standard_gpu</dt>
# <dd>
# A machine equivalent to <code suppresswarning="true">standard</code> that
# also includes a
# <a href="/ml-engine/docs/how-tos/using-gpus">
# GPU that you can use in your trainer</a>.
# </dd>
# <dt>complex_model_m_gpu</dt>
# <dd>
# A machine equivalent to
# <code suppresswarning="true">complex_model_m</code> that also includes
# four GPUs.
# </dd>
# </dl>
#
# You must set this value when `scaleTier` is set to `CUSTOM`.
"hyperparameters": { # Represents a set of hyperparameters to optimize. # Optional. The set of Hyperparameters to tune.
"maxTrials": 42, # Optional. How many training trials should be attempted to optimize
# the specified hyperparameters.
#
# Defaults to one.
"hyperparameterMetricTag": "A String", # Optional. The Tensorflow summary tag name to use for optimizing trials. For
# current versions of Tensorflow, this tag name should exactly match what is
# shown in Tensorboard, including all scopes. For versions of Tensorflow
# prior to 0.12, this should be only the tag passed to tf.Summary.
# By default, "training/hptuning/metric" will be used.
"params": [ # Required. The set of parameters to tune.
{ # Represents a single hyperparameter to optimize.
"maxValue": 3.14, # Required if typeis `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is `INTEGER`.
"categoricalValues": [ # Required if type is `CATEGORICAL`. The list of possible categories.
"A String",
],
"discreteValues": [ # Required if type is `DISCRETE`.
# A list of feasible points.
# The list should be in strictly increasing order. For instance, this
# parameter might have possible settings of 1.5, 2.5, and 4.0. This list
# should not contain more than 1,000 values.
3.14,
],
"parameterName": "A String", # Required. The parameter name must be unique amongst all ParameterConfigs in
# a HyperparameterSpec message. E.g., "learning_rate".
"minValue": 3.14, # Required if type is `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is INTEGER.
"type": "A String", # Required. The type of the parameter.
"scaleType": "A String", # Optional. How the parameter should be scaled to the hypercube.
# Leave unset for categorical parameters.
# Some kind of scaling is strongly recommended for real or integral
# parameters (e.g., `UNIT_LINEAR_SCALE`).
},
],
"maxParallelTrials": 42, # Optional. The number of training trials to run concurrently.
# You can reduce the time it takes to perform hyperparameter tuning by adding
# trials in parallel. However, each trail only benefits from the information
# gained in completed trials. That means that a trial does not get access to
# the results of trials running at the same time, which could reduce the
# quality of the overall optimization.
#
# Each trial will use the same scale tier and machine types.
#
# Defaults to one.
"goal": "A String", # Required. The type of goal to use for tuning. Available types are
# `MAXIMIZE` and `MINIMIZE`.
#
# Defaults to `MAXIMIZE`.
},
"region": "A String", # Required. The Google Compute Engine region to run the training job in.
"args": [ # Optional. Command line arguments to pass to the program.
"A String",
],
"pythonModule": "A String", # Required. The Python module name to run after installing the packages.
"jobDir": "A String", # Optional. A Google Cloud Storage path in which to store training outputs
# and other data needed for training. This path is passed to your TensorFlow
# program as the 'job_dir' command-line argument. The benefit of specifying
# this field is that Cloud ML validates the path for use in training.
"packageUris": [ # Required. The Google Cloud Storage location of the packages with
# the training program and any additional dependencies.
# The maximum number of package URIs is 100.
"A String",
],
"workerCount": "A String", # Optional. The number of worker replicas to use for the training job. Each
# replica in the cluster will be of the type specified in `worker_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`. If you
# set this value, you must also set `worker_type`.
"parameterServerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's parameter server.
#
# The supported values are the same as those described in the entry for
# `master_type`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `parameter_server_count` is greater than zero.
"parameterServerCount": "A String", # Optional. The number of parameter server replicas to use for the training
# job. Each replica in the cluster will be of the type specified in
# `parameter_server_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`.If you
# set this value, you must also set `parameter_server_type`.
},
"startTime": "A String", # Output only. When the job processing was started.
"errorMessage": "A String", # Output only. The details of a failure or a cancellation.
"jobId": "A String", # Required. The user-specified id of the job.
"state": "A String", # Output only. The detailed state of a job.
"predictionInput": { # Represents input parameters for a prediction job. # Input parameters to create a prediction job.
"modelName": "A String", # Use this field if you want to use the default version for the specified
# model. The string must use the following format:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>[YOUR_MODEL]</var>"`
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for this batch
# prediction. If not set, Google Cloud ML will pick the runtime version used
# during the CreateVersion request for this model version, or choose the
# latest stable version when model version information is not available
# such as when the model is specified by uri.
"inputPaths": [ # Required. The Google Cloud Storage location of the input data files.
# May contain wildcards.
"A String",
],
"maxWorkerCount": "A String", # Optional. The maximum number of workers to be used for parallel processing.
# Defaults to 10 if not specified.
"uri": "A String", # Use this field if you want to specify a Google Cloud Storage path for
# the model to use.
"outputPath": "A String", # Required. The output Google Cloud Storage location.
"dataFormat": "A String", # Required. The format of the input data files.
"versionName": "A String", # Use this field if you want to specify a version of the model to use. The
# string is formatted the same way as `model_version`, with the addition
# of the version information:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>YOUR_MODEL/versions/<var>[YOUR_VERSION]</var>"`
"region": "A String", # Required. The Google Compute Engine region to run the prediction job in.
},
"endTime": "A String", # Output only. When the job processing was completed.
"predictionOutput": { # Represents results of a prediction job. # The current prediction job result.
"outputPath": "A String", # The output Google Cloud Storage location provided at the job creation time.
"nodeHours": 3.14, # Node hours used by the batch prediction job.
"predictionCount": "A String", # The number of generated predictions.
"errorCount": "A String", # The number of data instances which resulted in errors.
},
"createTime": "A String", # Output only. When the job was created.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists the jobs in the project.
Args:
parent: string, Required. The name of the project for which to list jobs.
Authorization: requires `Viewer` role on the specified project. (required)
pageSize: integer, Optional. The number of jobs to retrieve per "page" of results. If there
are more remaining results than this number, the response message will
contain a valid value in the `next_page_token` field.
The default value is 20, and the maximum page size is 100.
filter: string, Optional. Specifies the subset of jobs to retrieve.
pageToken: string, Optional. A page token to request the next page of results.
You get the token from the `next_page_token` field of the response from
the previous call.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for the ListJobs method.
"nextPageToken": "A String", # Optional. Pass this token as the `page_token` field of the request for a
# subsequent call.
"jobs": [ # The list of jobs.
{ # Represents a training or prediction job.
"trainingOutput": { # Represents results of a training job. Output only. # The current training job result.
"completedTrialCount": "A String", # The number of hyperparameter tuning trials that completed successfully.
# Only set for hyperparameter tuning jobs.
"isHyperparameterTuningJob": True or False, # Whether this job is a hyperparameter tuning job.
"trials": [ # Results for individual Hyperparameter trials.
# Only set for hyperparameter tuning jobs.
{ # Represents the result of a single hyperparameter tuning trial from a
# training job. The TrainingOutput object that is returned on successful
# completion of a training job with hyperparameter tuning includes a list
# of HyperparameterOutput objects, one for each successful trial.
"hyperparameters": { # The hyperparameters given to this trial.
"a_key": "A String",
},
"trialId": "A String", # The trial id for these results.
"allMetrics": [ # All recorded object metrics for this trial.
{ # An observed value of a metric.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
],
"finalMetric": { # An observed value of a metric. # The final objective metric seen for this trial.
"trainingStep": "A String", # The global training step for this metric.
"objectiveValue": 3.14, # The objective value at this training step.
},
},
],
"consumedMLUnits": 3.14, # The amount of ML units consumed by the job.
},
"trainingInput": { # Represents input parameters for a training job. # Input parameters to create a training job.
"workerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's worker nodes.
#
# The supported values are the same as those described in the entry for
# `masterType`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `workerCount` is greater than zero.
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for training. If not
# set, Google Cloud ML will choose the latest stable version.
"scaleTier": "A String", # Required. Specifies the machine types, the number of replicas for workers
# and parameter servers.
"masterType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's master worker.
#
# The following types are supported:
#
# <dl>
# <dt>standard</dt>
# <dd>
# A basic machine configuration suitable for training simple models with
# small to moderate datasets.
# </dd>
# <dt>large_model</dt>
# <dd>
# A machine with a lot of memory, specially suited for parameter servers
# when your model is large (having many hidden layers or layers with very
# large numbers of nodes).
# </dd>
# <dt>complex_model_s</dt>
# <dd>
# A machine suitable for the master and workers of the cluster when your
# model requires more computation than the standard machine can handle
# satisfactorily.
# </dd>
# <dt>complex_model_m</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_s</code>.
# </dd>
# <dt>complex_model_l</dt>
# <dd>
# A machine with roughly twice the number of cores and roughly double the
# memory of <code suppresswarning="true">complex_model_m</code>.
# </dd>
# <dt>standard_gpu</dt>
# <dd>
# A machine equivalent to <code suppresswarning="true">standard</code> that
# also includes a
# <a href="/ml-engine/docs/how-tos/using-gpus">
# GPU that you can use in your trainer</a>.
# </dd>
# <dt>complex_model_m_gpu</dt>
# <dd>
# A machine equivalent to
# <code suppresswarning="true">complex_model_m</code> that also includes
# four GPUs.
# </dd>
# </dl>
#
# You must set this value when `scaleTier` is set to `CUSTOM`.
"hyperparameters": { # Represents a set of hyperparameters to optimize. # Optional. The set of Hyperparameters to tune.
"maxTrials": 42, # Optional. How many training trials should be attempted to optimize
# the specified hyperparameters.
#
# Defaults to one.
"hyperparameterMetricTag": "A String", # Optional. The Tensorflow summary tag name to use for optimizing trials. For
# current versions of Tensorflow, this tag name should exactly match what is
# shown in Tensorboard, including all scopes. For versions of Tensorflow
# prior to 0.12, this should be only the tag passed to tf.Summary.
# By default, "training/hptuning/metric" will be used.
"params": [ # Required. The set of parameters to tune.
{ # Represents a single hyperparameter to optimize.
"maxValue": 3.14, # Required if typeis `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is `INTEGER`.
"categoricalValues": [ # Required if type is `CATEGORICAL`. The list of possible categories.
"A String",
],
"discreteValues": [ # Required if type is `DISCRETE`.
# A list of feasible points.
# The list should be in strictly increasing order. For instance, this
# parameter might have possible settings of 1.5, 2.5, and 4.0. This list
# should not contain more than 1,000 values.
3.14,
],
"parameterName": "A String", # Required. The parameter name must be unique amongst all ParameterConfigs in
# a HyperparameterSpec message. E.g., "learning_rate".
"minValue": 3.14, # Required if type is `DOUBLE` or `INTEGER`. This field
# should be unset if type is `CATEGORICAL`. This value should be integers if
# type is INTEGER.
"type": "A String", # Required. The type of the parameter.
"scaleType": "A String", # Optional. How the parameter should be scaled to the hypercube.
# Leave unset for categorical parameters.
# Some kind of scaling is strongly recommended for real or integral
# parameters (e.g., `UNIT_LINEAR_SCALE`).
},
],
"maxParallelTrials": 42, # Optional. The number of training trials to run concurrently.
# You can reduce the time it takes to perform hyperparameter tuning by adding
# trials in parallel. However, each trail only benefits from the information
# gained in completed trials. That means that a trial does not get access to
# the results of trials running at the same time, which could reduce the
# quality of the overall optimization.
#
# Each trial will use the same scale tier and machine types.
#
# Defaults to one.
"goal": "A String", # Required. The type of goal to use for tuning. Available types are
# `MAXIMIZE` and `MINIMIZE`.
#
# Defaults to `MAXIMIZE`.
},
"region": "A String", # Required. The Google Compute Engine region to run the training job in.
"args": [ # Optional. Command line arguments to pass to the program.
"A String",
],
"pythonModule": "A String", # Required. The Python module name to run after installing the packages.
"jobDir": "A String", # Optional. A Google Cloud Storage path in which to store training outputs
# and other data needed for training. This path is passed to your TensorFlow
# program as the 'job_dir' command-line argument. The benefit of specifying
# this field is that Cloud ML validates the path for use in training.
"packageUris": [ # Required. The Google Cloud Storage location of the packages with
# the training program and any additional dependencies.
# The maximum number of package URIs is 100.
"A String",
],
"workerCount": "A String", # Optional. The number of worker replicas to use for the training job. Each
# replica in the cluster will be of the type specified in `worker_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`. If you
# set this value, you must also set `worker_type`.
"parameterServerType": "A String", # Optional. Specifies the type of virtual machine to use for your training
# job's parameter server.
#
# The supported values are the same as those described in the entry for
# `master_type`.
#
# This value must be present when `scaleTier` is set to `CUSTOM` and
# `parameter_server_count` is greater than zero.
"parameterServerCount": "A String", # Optional. The number of parameter server replicas to use for the training
# job. Each replica in the cluster will be of the type specified in
# `parameter_server_type`.
#
# This value can only be used when `scale_tier` is set to `CUSTOM`.If you
# set this value, you must also set `parameter_server_type`.
},
"startTime": "A String", # Output only. When the job processing was started.
"errorMessage": "A String", # Output only. The details of a failure or a cancellation.
"jobId": "A String", # Required. The user-specified id of the job.
"state": "A String", # Output only. The detailed state of a job.
"predictionInput": { # Represents input parameters for a prediction job. # Input parameters to create a prediction job.
"modelName": "A String", # Use this field if you want to use the default version for the specified
# model. The string must use the following format:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>[YOUR_MODEL]</var>"`
"runtimeVersion": "A String", # Optional. The Google Cloud ML runtime version to use for this batch
# prediction. If not set, Google Cloud ML will pick the runtime version used
# during the CreateVersion request for this model version, or choose the
# latest stable version when model version information is not available
# such as when the model is specified by uri.
"inputPaths": [ # Required. The Google Cloud Storage location of the input data files.
# May contain wildcards.
"A String",
],
"maxWorkerCount": "A String", # Optional. The maximum number of workers to be used for parallel processing.
# Defaults to 10 if not specified.
"uri": "A String", # Use this field if you want to specify a Google Cloud Storage path for
# the model to use.
"outputPath": "A String", # Required. The output Google Cloud Storage location.
"dataFormat": "A String", # Required. The format of the input data files.
"versionName": "A String", # Use this field if you want to specify a version of the model to use. The
# string is formatted the same way as `model_version`, with the addition
# of the version information:
#
# `"projects/<var>[YOUR_PROJECT]</var>/models/<var>YOUR_MODEL/versions/<var>[YOUR_VERSION]</var>"`
"region": "A String", # Required. The Google Compute Engine region to run the prediction job in.
},
"endTime": "A String", # Output only. When the job processing was completed.
"predictionOutput": { # Represents results of a prediction job. # The current prediction job result.
"outputPath": "A String", # The output Google Cloud Storage location provided at the job creation time.
"nodeHours": 3.14, # Node hours used by the batch prediction job.
"predictionCount": "A String", # The number of generated predictions.
"errorCount": "A String", # The number of data instances which resulted in errors.
},
"createTime": "A String", # Output only. When the job was created.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>