Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Output only. time when the NasJob for the first time entered the JOB_STATE_RUNNING state.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Output only. time when the NasJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Output only. time when the NasJob was most recently updated.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
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.
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.
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).
nas_algorithm_spec
Union type
The Neural Architecture Search (NAS) algorithm specification. nas_algorithm_spec can be only one of the following:
Spec for train trials. top N [TrainTrialSpec.max_parallel_trial_count] search trials will be trained for every M [TrainTrialSpec.frequency] trials searched.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[],[],null,["# REST Resource: projects.locations.nasJobs\n\nResource: NasJob\n----------------\n\nRepresents a Neural Architecture Search (NAS) job.\nFields `name` `string` \nOutput only. Resource name of the NasJob.\n`displayName` `string` \nRequired. The display name of the NasJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.\n`nasJobSpec` `object (`[NasJobSpec](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#NasJobSpec)`)` \nRequired. The specification of a NasJob.\n`nasJobOutput` `object (`[NasJobOutput](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#NasJobOutput)`)` \nOutput only. Output of the NasJob.\n`state` `enum (`[JobState](/vertex-ai/docs/reference/rest/v1/JobState)`)` \nOutput only. The detailed state of the job.\n`createTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. time when the NasJob was created.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`startTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. time when the NasJob for the first time entered the `JOB_STATE_RUNNING` state.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`endTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. time when the NasJob entered any of the following states: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`updateTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. time when the NasJob was most recently updated.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`error` `object (`[Status](/vertex-ai/docs/reference/rest/Shared.Types/ListOperationsResponse#Status)`)` \nOutput only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.\n`labels` `map (key: string, value: string)` \nThe labels with user-defined metadata to organize NasJobs.\n\nlabel 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.\n\nSee \u003chttps://goo.gl/xmQnxf\u003e for more information and examples of labels.\n`encryptionSpec` `object (`[EncryptionSpec](/vertex-ai/docs/reference/rest/v1/EncryptionSpec)`)` \nCustomer-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.\n`enableRestrictedImageTraining` \n**(deprecated)** `boolean` \n| This item is deprecated!\n\nOptional. Enable a separation of Custom model training and restricted image training for tenant project.\n`satisfiesPzs` `boolean` \nOutput only. reserved for future use.\n`satisfiesPzi` `boolean` \nOutput only. reserved for future use. \n\nNasJobSpec\n----------\n\nRepresents the spec of a NasJob.\nFields `resumeNasJobId` `string` \nThe 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.\n`searchSpaceSpec` `string` \nIt defines the search space for Neural Architecture Search (NAS). \n`nas_algorithm_spec` `Union type` \nThe Neural Architecture Search (NAS) algorithm specification. `nas_algorithm_spec` can be only one of the following:\n`multiTrialAlgorithmSpec` `object (`[MultiTrialAlgorithmSpec](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#MultiTrialAlgorithmSpec)`)` \nThe spec of multi-trial algorithms. \n\nMultiTrialAlgorithmSpec\n-----------------------\n\nThe spec of multi-trial Neural Architecture Search (NAS).\nFields `multiTrialAlgorithm` `enum (`[MultiTrialAlgorithm](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#MultiTrialAlgorithm)`)` \nThe multi-trial Neural Architecture Search (NAS) algorithm type. Defaults to `REINFORCEMENT_LEARNING`.\n`metric` `object (`[MetricSpec](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#MetricSpec)`)` \nMetric specs for the NAS job. Validation for this field is done at `multiTrialAlgorithmSpec` field.\n`searchTrialSpec` `object (`[SearchTrialSpec](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#SearchTrialSpec)`)` \nRequired. Spec for search trials.\n`trainTrialSpec` `object (`[TrainTrialSpec](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#TrainTrialSpec)`)` \nSpec for train trials. top N \\[TrainTrialSpec.max_parallel_trial_count\\] search trials will be trained for every M \\[TrainTrialSpec.frequency\\] trials searched. \n\nMultiTrialAlgorithm\n-------------------\n\nThe available types of multi-trial algorithms.\n\nMetricSpec\n----------\n\nRepresents a metric to optimize.\nFields `metricId` `string` \nRequired. The id of the metric. Must not contain whitespaces.\n`goal` `enum (`[GoalType](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#GoalType)`)` \nRequired. The optimization goal of the metric. \n\nGoalType\n--------\n\nThe available types of optimization goals.\n\nSearchTrialSpec\n---------------\n\nRepresent spec for search trials.\nFields `searchTrialJobSpec` `object (`[CustomJobSpec](/vertex-ai/docs/reference/rest/v1/CustomJobSpec)`)` \nRequired. The spec of a search trial job. The same spec applies to all search trials.\n`maxTrialCount` `integer` \nRequired. The maximum number of Neural Architecture Search (NAS) trials to run.\n`maxParallelTrialCount` `integer` \nRequired. The maximum number of trials to run in parallel.\n`maxFailedTrialCount` `integer` \nThe number of failed trials that need to be seen before failing the NasJob.\n\nIf set to 0, Vertex AI decides how many trials must fail before the whole job fails. \n\nTrainTrialSpec\n--------------\n\nRepresent spec for train trials.\nFields `trainTrialJobSpec` `object (`[CustomJobSpec](/vertex-ai/docs/reference/rest/v1/CustomJobSpec)`)` \nRequired. The spec of a train trial job. The same spec applies to all train trials.\n`maxParallelTrialCount` `integer` \nRequired. The maximum number of trials to run in parallel.\n`frequency` `integer` \nRequired. 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. \n\nNasJobOutput\n------------\n\nRepresents a uCAIP NasJob output.\nFields \n`output` `Union type` \nThe output of this Neural Architecture Search (NAS) job. `output` can be only one of the following:\n`multiTrialJobOutput` `object (`[MultiTrialJobOutput](/vertex-ai/docs/reference/rest/v1/projects.locations.nasJobs#MultiTrialJobOutput)`)` \nOutput only. The output of this multi-trial Neural Architecture Search (NAS) job. \n\nMultiTrialJobOutput\n-------------------\n\nThe output of a multi-trial Neural Architecture Search (NAS) jobs.\nFields `searchTrials[]` `object (`[NasTrial](/vertex-ai/docs/reference/rest/v1/NasTrial)`)` \nOutput only. List of NasTrials that were started as part of search stage.\n`trainTrials[]` `object (`[NasTrial](/vertex-ai/docs/reference/rest/v1/NasTrial)`)` \nOutput only. List of NasTrials that were started as part of train stage."]]
