REST Resource: projects.locations.nasJobs

Resource: NasJob

Represents a Neural Architecture Search (NAS) job.

JSON representation 
{
  "name": string,
  "displayName": string,
  "nasJobSpec": {
    object (NasJobSpec)
  },
  "nasJobOutput": {
    object (NasJobOutput)
  },
  "state": enum (JobState),
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "updateTime": string,
  "error": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "encryptionSpec": {
    object (EncryptionSpec)
  },
  "enableRestrictedImageTraining": boolean
}
Fields
name

string

Output only. Resource name of the NasJob.
displayName

string

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

object (NasJobSpec)

Required. The specification of a NasJob.
nasJobOutput

object (NasJobOutput)

Output only. Output of the NasJob.
state

enum (JobState)

Output only. The detailed state of the job.
createTime

string (Timestamp format)

Output only. time when the NasJob was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
startTime

string (Timestamp format)

Output only. time when the NasJob for the first time entered the JOB_STATE_RUNNING state.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Output only. time when the NasJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Output only. time when the NasJob was most recently updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
error

object (Status)

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

map (key: string, value: string)

The labels with user-defined metadata to organize NasJobs.

label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.
encryptionSpec

object (EncryptionSpec)

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

boolean

Optional. Enable a separation of Custom model training and restricted image training for tenant project.

NasJobSpec

Represents the spec of a NasJob.

JSON representation 
{
  "resumeNasJobId": string,
  "searchSpaceSpec": string,

  // Union field nas_algorithm_spec can be only one of the following:
  "multiTrialAlgorithmSpec": {
    object (MultiTrialAlgorithmSpec)
  }
  // End of list of possible types for union field nas_algorithm_spec.
}
Fields
resumeNasJobId

string

The ID of the existing NasJob in the same Project and Location which will be used to resume search. searchSpaceSpec and nas_algorithm_spec are obtained from previous NasJob hence should not provide them again for this NasJob.
searchSpaceSpec

string

It defines the search space for Neural Architecture Search (NAS).
Union field nas_algorithm_spec. The Neural Architecture Search (NAS) algorithm specification. nas_algorithm_spec can be only one of the following:
multiTrialAlgorithmSpec

object (MultiTrialAlgorithmSpec)

The spec of multi-trial algorithms.

MultiTrialAlgorithmSpec

The spec of multi-trial Neural Architecture Search (NAS).

JSON representation 
{
  "multiTrialAlgorithm": enum (MultiTrialAlgorithm),
  "metric": {
    object (MetricSpec)
  },
  "searchTrialSpec": {
    object (SearchTrialSpec)
  },
  "trainTrialSpec": {
    object (TrainTrialSpec)
  }
}
Fields
multiTrialAlgorithm

enum (MultiTrialAlgorithm)

The multi-trial Neural Architecture Search (NAS) algorithm type. Defaults to REINFORCEMENT_LEARNING.
metric

object (MetricSpec)

Metric specs for the NAS job. Validation for this field is done at multiTrialAlgorithmSpec field.
searchTrialSpec

object (SearchTrialSpec)

Required. Spec for search trials.
trainTrialSpec

object (TrainTrialSpec)

Spec for train trials. top N [TrainTrialSpec.max_parallel_trial_count] search trials will be trained for every M [TrainTrialSpec.frequency] trials searched.

MultiTrialAlgorithm

The available types of multi-trial algorithms.

Enums
MULTI_TRIAL_ALGORITHM_UNSPECIFIED Defaults to REINFORCEMENT_LEARNING.
REINFORCEMENT_LEARNING The Reinforcement Learning Algorithm for Multi-trial Neural Architecture Search (NAS).

MetricSpec

Represents a metric to optimize.

JSON representation 
{
  "metricId": string,
  "goal": enum (GoalType)
}
Fields
metricId

string

Required. The ID of the metric. Must not contain whitespaces.
goal

enum (GoalType)

Required. The optimization goal of the metric.

GoalType

The available types of optimization goals.

Enums
GOAL_TYPE_UNSPECIFIED Goal type will default to maximize.
MAXIMIZE Maximize the goal metric.
MINIMIZE Minimize the goal metric.

SearchTrialSpec

Represent spec for search trials.

JSON representation 
{
  "searchTrialJobSpec": {
    object (CustomJobSpec)
  },
  "maxTrialCount": integer,
  "maxParallelTrialCount": integer,
  "maxFailedTrialCount": integer
}
Fields
searchTrialJobSpec

object (CustomJobSpec)

Required. The spec of a search trial job. The same spec applies to all search trials.
maxTrialCount

integer

Required. The maximum number of Neural Architecture Search (NAS) trials to run.
maxParallelTrialCount

integer

Required. The maximum number of trials to run in parallel.
maxFailedTrialCount

integer

The number of failed trials that need to be seen before failing the NasJob.

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

TrainTrialSpec

Represent spec for train trials.

JSON representation 
{
  "trainTrialJobSpec": {
    object (CustomJobSpec)
  },
  "maxParallelTrialCount": integer,
  "frequency": integer
}
Fields
trainTrialJobSpec

object (CustomJobSpec)

Required. The spec of a train trial job. The same spec applies to all train trials.
maxParallelTrialCount

integer

Required. The maximum number of trials to run in parallel.
frequency

integer

Required. Frequency of search trials to start train stage. top N [TrainTrialSpec.max_parallel_trial_count] search trials will be trained for every M [TrainTrialSpec.frequency] trials searched.

NasJobOutput

Represents a uCAIP NasJob output.

JSON representation 
{

  // Union field output can be only one of the following:
  "multiTrialJobOutput": {
    object (MultiTrialJobOutput)
  }
  // End of list of possible types for union field output.
}
Fields
Union field output. The output of this Neural Architecture Search (NAS) job. output can be only one of the following:
multiTrialJobOutput

object (MultiTrialJobOutput)

Output only. The output of this multi-trial Neural Architecture Search (NAS) job.

MultiTrialJobOutput

The output of a multi-trial Neural Architecture Search (NAS) jobs.

JSON representation 
{
  "searchTrials": [
    {
      object (NasTrial)
    }
  ],
  "trainTrials": [
    {
      object (NasTrial)
    }
  ]
}
Fields
searchTrials[]

object (NasTrial)

Output only. List of NasTrials that were started as part of search stage.
trainTrials[]

object (NasTrial)

Output only. List of NasTrials that were started as part of train stage.

Methods

cancel

 Cancels a NasJob.

create

 Creates a NasJob

delete

 Deletes a NasJob.

get

 Gets a NasJob

list

 Lists NasJobs in a Location.