[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Create and manage experiment runs\n\nUse the Vertex AI SDK for Python to create and manage your\nexperiment runs. You can use the Google Cloud console to delete experiment runs. \n\n### Vertex AI SDK for Python\n\nThe following samples use the methods [`init`](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#google_cloud_aiplatform_init),\n[`start_run`](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#google_cloud_aiplatform_start_run),\nand [`end_run`](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#google_cloud_aiplatform_end_run) from the `aiplatform` [Package\nfunctions](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#functions), and [`delete`](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform.ExperimentRun#google_cloud_aiplatform_ExperimentRun_delete)\nfrom the [`ExperimentClass`](/python/docs/reference/aiplatform/latest/google.cloud.aiplatform.ExperimentRun). \n\n### Create and start run\n\n### Python\n\n from typing import Optional, Union\n\n from google.cloud import aiplatform\n\n\n def create_experiment_run_sample(\n experiment_name: str,\n run_name: str,\n experiment_run_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],\n project: str,\n location: str,\n ):\n aiplatform.init(experiment=experiment_name, project=project, location=location)\n\n aiplatform.start_run(run=run_name, tensorboard=experiment_run_tensorboard)\n\n- `experiment_name`: Provide the name of your experiment. You can find your list of experiments in the Google Cloud console by selecting \"Experiments\" in the section nav.\n- `run_name`: Specify a run name to associate with your current session. See [`start_run`](https://cloud.google.com/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#google_cloud_aiplatform_start_run) in the Vertex AI SDK reference documentation.\n- `experiment_run_tensorboard`: Optional. A backing TensorBoard resource to enable and store time series metrics logged to this experiment run using [`log_time_series_metrics`](https://cloud.google.com/python/docs/reference/aiplatform/latest/google.cloud.aiplatform#google_cloud_aiplatform_log_time_series_metrics).\n- `project`: . You can find these IDs in the Google Cloud console [welcome](https://console.cloud.google.com/welcome) page.\n- `location`: See [List of available locations](/vertex-ai/docs/general/locations)\n\n### End run\n\n### Python\n\n from google.cloud import aiplatform\n\n\n def end_experiment_run_sample(\n experiment_name: str,\n run_name: str,\n project: str,\n location: str,\n ):\n aiplatform.init(experiment=experiment_name, project=project, location=location)\n\n aiplatform.start_run(run=run_name, resume=True)\n\n aiplatform.end_run()\n\n- `experiment_name`: Provide the name of your experiment. You can find your list of experiments in the Google Cloud console by selecting \"Experiments\" in the section nav.\n- `run_name`: Specify a run name.\n- `project`: . You can find these in the Google Cloud console [welcome](https://console.cloud.google.com/welcome) page.\n- `location`: See [List of\n available locations](/vertex-ai/docs/general/locations)\n\n### Resume run\n\n### Python\n\n from google.cloud import aiplatform\n\n\n def resume_experiment_run_sample(\n experiment_name: str,\n run_name: str,\n project: str,\n location: str,\n ):\n aiplatform.init(experiment=experiment_name, project=project, location=location)\n\n aiplatform.start_run(run=run_name, resume=True)\n\n- `experiment_name`: Provide the name of your experiment. You can find your list of experiments in the Google Cloud console by selecting \"Experiments\" in the section nav.\n- `run_name`: Specify name of run that you want to resume.\n- `project`: . You can find these in the Google Cloud console [welcome](https://console.cloud.google.com/welcome) page.\n- `location`: See [List of\n available locations](/vertex-ai/docs/general/locations)\n\n### Delete run\n\n### Python\n\n from typing import Union\n\n from google.cloud import aiplatform\n\n\n def delete_experiment_run_sample(\n run_name: str,\n experiment: Union[str, aiplatform.Experiment],\n project: str,\n location: str,\n delete_backing_tensorboard_run: bool = False,\n ):\n experiment_run = aiplatform.ExperimentRun(\n run_name=run_name, experiment=experiment, project=project, location=location\n )\n\n experiment_run.delete(delete_backing_tensorboard_run=delete_backing_tensorboard_run)\n\n- `experiment`: The name or instance of this experiment. You can find your list of experiments in the Google Cloud console by selecting \"Experiments\" in the section nav.\n- `run_name`: Specify name of run that you want to delete.\n- `project`: . You can find these in the Google Cloud console [welcome](https://console.cloud.google.com/welcome) page.\n- `location`: See [List of\n available locations](/vertex-ai/docs/general/locations)\n- `delete_backing_tensorboard_run`: Whether to delete the backing Vertex AI TensorBoard run that stores time series metrics for this run.\n\n### Manage status\n\n### Python\n\n from typing import Union\n\n from google.cloud import aiplatform\n\n\n def update_experiment_run_state_sample(\n run_name: str,\n experiment: Union[str, aiplatform.Experiment],\n project: str,\n location: str,\n state: aiplatform.gapic.Execution.State,\n ) -\u003e None:\n experiment_run = aiplatform.ExperimentRun(\n run_name=run_name,\n experiment=experiment,\n project=project,\n location=location,\n )\n\n experiment_run.update_state(state)\n\n- `run_name`: run name associated with your experiment\n- `experiment_name`: name of your experiment. You can find your list of experiments in the Google Cloud console by selecting **Experiments** in the section nav.\n- `project`: . You can find these Project IDs in the Google Cloud console [welcome](https://console.cloud.google.com/welcome) page.\n- `location`: See [List of available locations](/vertex-ai/docs/general/locations)\n- `state`: Possible values for `state`, which shows up as \"status\" in the Google Cloud console, are:\n - `aiplatform.gapic.Execution.State.CACHED`\n - `aiplatform.gapic.Execution.State.CANCELLED`\n - `aiplatform.gapic.Execution.State.COMPLETE`\n - `aiplatform.gapic.Execution.State.FAILED`\n - `aiplatform.gapic.Execution.State.NEW`\n - `aiplatform.gapic.Execution.State.RUNNING`\n\n### Google Cloud console\n\nFollow these steps to delete an .\n\n1. In the Google Cloud console, go to the **Experiments** page. \n [Go to Experiments](https://console.cloud.google.com/vertex-ai/experiments)\n2. In the experiment details page, click the name of the experiment that is associated with the experiment run you want to delete. The **Experiment runs** page appears with the list of all the experiment runs for that experiment.\n3. Select the checkbox associated with the run that you want to delete. The **Delete** button appears.\n4. Click **Delete**\n - Alternatively, you can go to the more_vert options menu that's in the same row as the experiment run and select **delete**.\n\nView list of experiment runs and run details\n--------------------------------------------\n\nThe Google Cloud console provides a visualization of the data\nassociated with these runs.\n\n- [View experiment run data](/vertex-ai/docs/experiments/compare-analyze-runs#view-experiment-run-data)\n- [Compare experiment runs](/vertex-ai/docs/experiments/compare-analyze-runs#compare-experiment-runs)\n\nWhat's next\n-----------\n\n- [Add pipeline run to an experiment or experiment run](/vertex-ai/docs/experiments/add-pipelinerun-experiment)"]]
