---
title: Vertex AI Tuning Job
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Vertex AI Tuning Job
---

# Vertex AI Tuning Job

Vertex AI Tuning Job is a managed Google Cloud service that automates hyperparameter tuning for machine learning models. It runs multiple training trials with different parameter combinations to find the best-performing model configuration. The service integrates with Vertex AI Training and supports custom or pre-built algorithms, helping optimize model accuracy and performance efficiently without manual experimentation.

```
gcp.aiplatform_tuning_job
```

## Fields

| Title                    | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                              | Description |
| ------------------------ | ---- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| _key                     | core | string        |
| ancestors                | core | array<string> |
| base_model               | core | string        | The base model that is being tuned. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models).                                                                                                                                                                                                                                             |
| create_time              | core | timestamp     | Output only. Time when the TuningJob was created.                                                                                                                                                                                                                                                                                                                                                      |
| datadog_display_name     | core | string        |
| description              | core | string        | Optional. The description of the TuningJob.                                                                                                                                                                                                                                                                                                                                                            |
| encryption_spec          | core | json          | Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with the provided encryption key.                                                                                                                                                                                                                               |
| end_time                 | core | timestamp     | Output only. Time when the TuningJob entered any of the following JobStates: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`, `JOB_STATE_EXPIRED`.                                                                                                                                                                                                                                    |
| error                    | core | json          | Output only. Only populated when job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.                                                                                                                                                                                                                                                                                                           |
| experiment               | core | string        | Output only. The Experiment associated with this TuningJob.                                                                                                                                                                                                                                                                                                                                            |
| labels                   | core | array<string> | Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. 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. |
| name                     | core | string        | Output only. Identifier. Resource name of a TuningJob. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}`                                                                                                                                                                                                                                                                       |
| organization_id          | core | string        |
| parent                   | core | string        |
| project_id               | core | string        |
| project_number           | core | string        |
| region_id                | core | string        |
| resource_name            | core | string        |
| service_account          | core | string        | The service account that the tuningJob workload runs as. If not specified, the Vertex AI Secure Fine-Tuned Service Agent in the project will be used. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent Users starting the pipeline must have the `iam.serviceAccounts.actAs` permission on this service account.                                        |
| start_time               | core | timestamp     | Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state.                                                                                                                                                                                                                                                                                                         |
| state                    | core | string        | Output only. The detailed state of the job.                                                                                                                                                                                                                                                                                                                                                            |
| supervised_tuning_spec   | core | json          | Tuning Spec for Supervised Fine Tuning.                                                                                                                                                                                                                                                                                                                                                                |
| tags                     | core | hstore_csv    |
| tuned_model              | core | json          | Output only. The tuned model resources associated with this TuningJob.                                                                                                                                                                                                                                                                                                                                 |
| tuned_model_display_name | core | string        | Optional. The display name of the TunedModel. The name can be up to 128 characters long and can consist of any UTF-8 characters. For continuous tuning, tuned_model_display_name will by default use the same display name as the pre-tuned model. If a new display name is provided, the tuning job will create a new model instead of a new version.                                                 |
| tuning_data_stats        | core | json          | Output only. The tuning data statistics associated with this TuningJob.                                                                                                                                                                                                                                                                                                                                |
| update_time              | core | timestamp     | Output only. Time when the TuningJob was most recently updated.                                                                                                                                                                                                                                                                                                                                        |
| zone_id                  | core | string        |
