Stay organized with collections Save and categorize content based on your preferences.
Create an instance with Confidential ComputingPreview
This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.
This document describes how to create a Vertex AI Workbench instance with Confidential Computing enabled.
OverviewConfidential Computing is the protection of data in-use with hardware-based Trusted Execution Environment (TEE). TEEs are secure and isolated environments that prevent unauthorized access or modification of applications and data while they are in use. This security standard is defined by the Confidential Computing Consortium.
When you create a Vertex AI Workbench instance with Confidential Computing enabled, your new Vertex AI Workbench instance is a Confidential VM instance. To learn more about Confidential VM instances, see the Confidential VM overview.
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 Compute Engine and Notebooks APIs.
In 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 Compute Engine and Notebooks APIs.
To get the permissions that you need to create a Vertex AI Workbench instance, ask your administrator to grant you the Notebooks Runner (roles/notebooks.runner
) IAM role on the project. For more information about granting roles, see Manage access to projects, folders, and organizations.
You might also be able to get the required permissions through custom roles or other predefined roles.
Create an instanceYou can create an instance with Confidential Computing enabled by using the gcloud CLI or the REST API:
gcloudTo create a Vertex AI Workbench instance with Confidential Computing enabled, use the gcloud workbench instances create
command and set --confidential-compute-type
to SEV
.
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 locatedMACHINE_TYPE
: the machine type of your instance's VM, for example: n2d-standard-2
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 \ --machine-type=MACHINE_TYPE \ --confidential-compute-type=SEVWindows (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 ` --machine-type=MACHINE_TYPE ` --confidential-compute-type=SEVWindows (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 ^ --machine-type=MACHINE_TYPE ^ --confidential-compute-type=SEV
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.
RESTTo create a Vertex AI Workbench instance with Confidential Computing enabled, use the projects.locations.instances.create
method and include a confidentialInstanceConfig
in your GceSetup
.
Before using any of the request data, make the following replacements:
PROJECT_ID
: your project IDLOCATION
: the zone where you want your instance to be locatedMACHINE_TYPE
: the machine type of your instance's VM, for example: n2d-standard-2
HTTP method and URL:
POST https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances
Request JSON body:
{ "gce_setup": { "machine_type": "MACHINE_TYPE", "confidentialInstanceConfig": { "confidentialInstanceType": SEV } } }
To send your request, choose one of these options:
curl Note: The following command assumes that you have logged in to thegcloud
CLI with your user account by running gcloud init
or gcloud auth login
, or by using Cloud Shell, which automatically logs you into the gcloud
CLI . You can check the currently active account by running gcloud auth list
.
Save the request body in a file named request.json
, and execute the following command:
curl -X POST \PowerShell Note: The following command assumes that you have logged in to the
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances"
gcloud
CLI with your user account by running gcloud init
or gcloud auth login
. You can check the currently active account by running gcloud auth list
.
Save the request body in a file named request.json
, and execute the following command:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances" | Select-Object -Expand Content
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.
Confirm whether an instance has Confidential Computing enabledTo confirm whether a Vertex AI Workbench instance has Confidential Computing enabled, do the following:
In the Google Cloud console, go to the Instances page.
In the Instance name column, click the name of the instance that you want to check.
The Instance details page opens.
Next to VM details, click View in Compute Engine.
On the Compute Engine details page, the value for Confidential VM service shows either Enabled
or Disabled
.
When you create or use a Vertex AI Workbench instance with Confidential Computing enabled, the following limitations apply:
Only N2D machine types are supported. See N2D machine types.
Confidential Computing can't be enabled or turned off after you create the Vertex AI Workbench instance.
While this feature is in Preview, charges for using Vertex AI Workbench instances with Confidential Computing are the same as using instances without Confidential Computing. See Pricing.
What's nextExcept 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