01 Vertex AI notebook instances must be stopped for updating the root access configuration. To stop your notebook instance, run workbench instances stop command (Windows/macOS/Linux) with the name of the instance that you want to stop as the identifier parameter:
gcloud workbench instances stop tm-vertex-ai-notebook-instance
--location=us-central1-a
--format="yaml(state)"
02 The command output should return the new operational status for the selected notebook instance:
Waiting for operation on Instance [tm-vertex-ai-notebook-instance] to be updated with [projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234]...done.
Updated workbench instance tm-vertex-ai-notebook-instance [https://notebooks.googleapis.com/v2/projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234].
state: STOPPED
03 Run workbench instances update command (Windows/macOS/Linux) with the name of the Vertex AI notebook instance that you want to update as the identifier parameter, to disable the root access to the selected notebook instance:
gcloud workbench instances update tm-vertex-ai-notebook-instance
--location=us-central1-a
--metadata 'notebook-disable-root'='true'
--format="yaml(gceSetup.metadata.notebook-disable-root)"
04 The command output should return the new root access configuration:
Waiting for operation on Instance [tm-vertex-ai-notebook-instance] to be updated with [projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234]...done.
Updated workbench instance tm-vertex-ai-notebook-instance [https://notebooks.googleapis.com/v2/projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234].
gceSetup:
metadata:
notebook-disable-root: 'true'
05 To restart your Vertex AI notebook instance, run workbench instances start command (Windows/macOS/Linux) with the name of the instance that you want to start as the identifier parameter:
gcloud workbench instances start tm-vertex-ai-notebook-instance
--location=us-central1-a
--format="yaml(state)"
06 The command output should return the new status of the selected notebook instance:
Waiting for operation on Instance [tm-vertex-ai-notebook-instance] to be updated with [projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234]...done.
Updated workbench instance tm-vertex-ai-notebook-instance [https://notebooks.googleapis.com/v2/projects/cc-vertex-project-123123/locations/us-central1-a/operations/operation-abcd1234abcd-abcd1234abcd-abcd1234-abcd1234].
state: PROVISIONING
07 Repeat step no. 1 – 6 for each Vertex AI notebook instance that you want to update, created for the selected GCP project.
08 Repeat steps no. 1 – 7 for each GCP project deployed in your Google Cloud account.