Manage runtimes

This page describes how to manage a Colab Enterprise runtime, including the following tasks:

  • Start a runtime.
  • Stop a runtime.
  • Disconnect from a runtime.
  • Reconnect to a runtime.
  • Change the runtime that you are connected to.
  • Delete a runtime.

Required roles

To get the permissions that you need to manage a Colab Enterprise runtime, ask your administrator to grant you the Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) 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.

Start a runtime

To start a runtime, you can use the Google Cloud console, the gcloud CLI, or the REST API.

Console

To start a runtime:

  1. In the Google Cloud console, go to the Colab Enterprise Runtimes page.

    Go to Runtimes

  2. In the Region menu, select the region that contains your runtime.

  3. Select the runtime that you want to start.

  4. Click Start.

gcloud

Before using any of the command data below, make the following replacements:

  • RUNTIME_ID: the ID of your runtime.
  • PROJECT_ID: your project ID.
  • REGION: the region where your runtime is located.

Execute the following command:

Linux, macOS, or Cloud Shell

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

For more information about the command for starting a runtime from the command line, see the gcloud CLI documentation.