Create an instance after the end of patch and support date

Vertex AI Workbench user-managed notebooks is deprecated . On April 14, 2025, support for user-managed notebooks will end and the ability to create user-managed notebooks instances will be removed. Existing instances will continue to function but patches, updates, and upgrades won't be available. To continue using Vertex AI Workbench, we recommend that you migrate your user-managed notebooks instances to Vertex AI Workbench instances .

This page describes how to create a user-managed notebooks instance from an image family that has reached its end of patch and support date.

Overview

When all images from an image family have reached their end of patch and support date, you can't create an instance from that image family by using the Google Cloud console.

To create an instance after its end of patch and support date, you must use the Google Cloud CLI.

To look up end of patch and support dates, see Supported frameworks .

Look up the image name

To create an instance, you'll need to know the image name. To find the image name, use the following command:

gcloud  
compute  
images  
list  
 \ 
  
--project = 
deeplearning-platform-release  
 \ 
  
--filter = 
 NAME_SEGMENT 
  
 \ 
  
--show-deprecated

Replace NAME_SEGMENT with a part of the image name that you're looking for. For example, you might look for Debian 10 image names by using "notebooks-debian-10" for the name segment.

Create an instance

To create a specific instance type by using the gcloud CLI, run the following command:

gcloud  
notebooks  
instances  
create  
 INSTANCE_NAME 
  
 \ 
  
--vm-image-project = 
deeplearning-platform-release  
 \ 
  
--vm-image-name = 
 IMAGE_NAME 
  
 \ 
  
--machine-type = 
 MACHINE_TYPE 
  
 \ 
  
--location = 
 LOCATION 
  
 \ 
  
--project  
 PROJECT_ID

Replace the following:

INSTANCE_NAME : the name of your new instance
IMAGE_NAME : the name of the image, for example: tf-2-8-cu113-notebooks-v20230925-debian-10
MACHINE_TYPE : the machine type of your instance's VM
LOCATION : the Google Cloud location where you want your new instance to be
PROJECT_ID : your project ID

For more information about how to create instances by using the gcloud CLI, see the gcloud tab of Create a user-managed notebooks instance .