Stay organized with collections Save and categorize content based on your preferences.
Create a specific version of an instanceThis page describes how to create a specific version of a Vertex AI Workbench instance.
Why you might want to create a specific versionTo ensure that your Vertex AI Workbench instance has software that is compatible with your code or application, you might want to create a specific version.
Vertex AI Workbench instance images are updated frequently, and specific versions of preinstalled software and packages vary from version to version.
To learn more about specific Vertex AI Workbench versions, see the Vertex AI release notes.
After you create a specific version of a Vertex AI Workbench instance, you can upgrade it. Upgrading the instance updates the preinstalled software and packages. For more information, see Upgrade an instance's environment.
Before you beginIn the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.Verify that billing is enabled for your Google Cloud project.
Enable the Notebooks API.
You can create a specific version of a Vertex AI Workbench instance by using the Google Cloud console or the Google Cloud CLI.
ConsoleTo create a specific version of a Vertex AI Workbench instance, do the following:
When you create an instance, in the Environment section, select Use a previous version.
Click the Version list, and select a version. Versions are numbered in the form of an M
followed by the number of the release, for example, M123
.
Complete the rest of the instance-creation dialog, and then click Create.
Vertex AI Workbench creates an instance and automatically starts it. When the instance is ready to use, Vertex AI Workbench activates an Open JupyterLab link.
Before using any of the command data below, make the following replacements:
INSTANCE_NAME
: the name of your Vertex AI Workbench instance; must start with a letter followed by up to 62 lowercase letters, numbers, or hyphens (-), and cannot end with a hyphenPROJECT_ID
: your project IDLOCATION
: the zone where you want your instance to be locatedVM_IMAGE_NAME
: the image name; to get a list of the available image names, use the get-config
commandMACHINE_TYPE
: the machine type of your instance's VMMETADATA
: custom metadata to apply to this instance; for example, to specify a post-startup-script, you can use the post-startup-script
metadata tag, in the format: --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh
--metadata=enable-jupyterlab4-preview=true
. For more information, see JupyterLab 4 preview.Execute the following command:
Linux, macOS, or Cloud Shell Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running either gcloud init; or gcloud auth login and gcloud config set project.gcloud workbench instances create INSTANCE_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --vm-image-project="cloud-notebooks-managed" \ --vm-image-name=VM_IMAGE_NAME \ --machine-type=MACHINE_TYPE \ --metadata=METADATAWindows (PowerShell) Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running either gcloud init; or gcloud auth login and gcloud config set project.
gcloud workbench instances create INSTANCE_NAME ` --project=PROJECT_ID ` --location=LOCATION ` --vm-image-project="cloud-notebooks-managed" ` --vm-image-name=VM_IMAGE_NAME ` --machine-type=MACHINE_TYPE ` --metadata=METADATAWindows (cmd.exe) Note: Ensure you have initialized the Google Cloud CLI with authentication and a project by running either gcloud init; or gcloud auth login and gcloud config set project.
gcloud workbench instances create INSTANCE_NAME ^ --project=PROJECT_ID ^ --location=LOCATION ^ --vm-image-project="cloud-notebooks-managed" ^ --vm-image-name=VM_IMAGE_NAME ^ --machine-type=MACHINE_TYPE ^ --metadata=METADATA
For more information about the command for creating an instance from the command line, see the gcloud CLI documentation.
Vertex AI Workbench creates an instance and automatically starts it. When the instance is ready to use, Vertex AI Workbench activates an Open JupyterLab link in the Google Cloud console.
What's nextLearn more about upgrading Vertex AI Workbench instances to ensure that your instance upgrades only when you are ready.
Learn about monitoring the health status of your Vertex AI Workbench instance.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["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-08-07 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4