---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails

`GET /v1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails`

## Request

- Base URL: `https://aiplatform.googleapis.com`
- URL: `https://aiplatform.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

List top NasTrialDetails of a NasJob.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `nasJobsId` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- GoogleCloudAiplatformV1ListNasTrialDetailsResponse: Response message for JobService.ListNasTrialDetails
  - `nasTrialDetails` GoogleCloudAiplatformV1NasTrialDetail[]: List of top NasTrials in the requested page.
    - `name` string: Output only. Resource name of the NasTrialDetail.
    - `parameters` string: The parameters for the NasJob NasTrial.
    - `searchTrial` GoogleCloudAiplatformV1NasTrial: Represents a uCAIP NasJob trial.
      - `endTime` string, google-datetime: Output only. Time when the NasTrial's status changed to `SUCCEEDED` or `INFEASIBLE`.
      - `finalMeasurement` GoogleCloudAiplatformV1Measurement: A message representing a Measurement of a Trial. A Measurement contains the Metrics got by executing a Trial using suggested hyperparameter values.
        - `elapsedDuration` string, google-duration: Output only. Time that the Trial has been running at the point of this Measurement.
        - `metrics` GoogleCloudAiplatformV1MeasurementMetric[]: Output only. A list of metrics got by evaluating the objective functions using suggested Parameter values.
          - `metricId` string: Output only. The ID of the Metric. The Metric should be defined in StudySpec's Metrics.
          - `value` number, double: Output only. The value for this metric.
        - `stepCount` string, int64: Output only. The number of steps the machine learning model has been trained for. Must be non-negative.
      - `id` string: Output only. The identifier of the NasTrial assigned by the service.
      - `startTime` string, google-datetime: Output only. Time when the NasTrial was started.
      - `state` 'STATE_UNSPECIFIED' | 'REQUESTED' | 'ACTIVE' | 'STOPPING' | 'SUCCEEDED' | 'INFEASIBLE': Output only. The detailed state of the NasTrial.
    - `trainTrial` GoogleCloudAiplatformV1NasTrial: Represents a uCAIP NasJob trial.
      - `endTime` string, google-datetime: Output only. Time when the NasTrial's status changed to `SUCCEEDED` or `INFEASIBLE`.
      - `finalMeasurement` GoogleCloudAiplatformV1Measurement: A message representing a Measurement of a Trial. A Measurement contains the Metrics got by executing a Trial using suggested hyperparameter values.
        - `elapsedDuration` string, google-duration: Output only. Time that the Trial has been running at the point of this Measurement.
        - `metrics` GoogleCloudAiplatformV1MeasurementMetric[]: Output only. A list of metrics got by evaluating the objective functions using suggested Parameter values.
          - `metricId` string: Output only. The ID of the Metric. The Metric should be defined in StudySpec's Metrics.
          - `value` number, double: Output only. The value for this metric.
        - `stepCount` string, int64: Output only. The number of steps the machine learning model has been trained for. Must be non-negative.
      - `id` string: Output only. The identifier of the NasTrial assigned by the service.
      - `startTime` string, google-datetime: Output only. Time when the NasTrial was started.
      - `state` 'STATE_UNSPECIFIED' | 'REQUESTED' | 'ACTIVE' | 'STOPPING' | 'SUCCEEDED' | 'INFEASIBLE': Output only. The detailed state of the NasTrial.
  - `nextPageToken` string: A token to retrieve the next page of results. Pass to ListNasTrialDetailsRequest.page_token to obtain that page.

---

[API](https://skmtc.dev/google/apis/aiplatform.md) - [All operations](https://skmtc.dev/google/apis/aiplatform/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/aiplatform/revisions/3aca3b348f0c?raw)
