管理运行时模板
本页面介绍了如何管理 Colab Enterprise 运行时模板，包括以下任务：
- 修改运行时模板。
- 删除运行时模板。
所需的角色
如需获得管理 Colab Enterprise 运行时模板所需的权限，请让您的管理员为您授予项目的Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
修改运行时模板
您可以更改运行时模板的某些规范，包括 Python 版本和加密密钥配置。对运行时模板所做的任何更改仅适用于使用此模板新建的运行时。
如需修改运行时模板，您可以使用 Google Cloud 控制台或 REST API。
控制台
若要修改运行时模板，请执行以下操作：
-
在 Google Cloud 控制台中，前往 Colab Enterprise 运行时模板 页面。
-
在区域 菜单中，选择包含 您的运行时模板的区域。
-
在 ID 列中，点击要修改的运行时模板的 ID 编号。
-
点击 修改图标。
-
在修改运行时模板 面板中，对运行时模板进行更改。
-
点击更新 。
REST
在使用任何请求数据之前， 请先进行以下替换：
REGION：运行时模板所在的区域。PROJECT_ID：您的项目 ID。NOTEBOOK_RUNTIME_TEMPLATE_ID：运行时模板的 ID。RELEASE_NAME：您要使用的映像的版本名称。 例如，py311是 Python 3.11 映像的版本名称。如需将 映像设置为Latest，请将RELEASE_NAME留空。
HTTP 方法和网址：
PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name
请求 JSON 正文：
{
softwareConfig: {
colabImage: {
releaseName: "RELEASE_NAME"
}
}
}
如需发送请求，请选择以下方式之一：
curl
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"
PowerShell
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
如需了解可用的查询参数，请参阅
notebookRuntimeTemplates.patch REST API
文档。
删除运行时模板
如需删除运行时模板，您可以使用 Google Cloud 控制台、 gcloud CLI 或 REST API。
控制台
若要删除运行时模板，请执行以下操作：
-
在 Google Cloud 控制台中，前往 Colab Enterprise 运行时模板 页面。
-
在区域 菜单中，选择包含 您的运行时模板的区域。
-
选择要删除的运行时模板。
-
点击 删除。
-
点击确认。
gcloud
在使用下面的命令数据之前，请先进行以下替换：
RUNTIME_ID：运行时的 ID。PROJECT_ID：您的项目 ID。REGION：运行时所在的区域。
执行以下命令：
Linux、macOS 或 Cloud Shell
gcloud colab runtimes delete RUNTIME_ID \ --project=PROJECT_ID \ --region=REGION
Windows (PowerShell)
gcloud colab runtimes delete RUNTIME_ID ` --project=PROJECT_ID ` --region=REGION
Windows (cmd.exe)
gcloud colab runtimes delete RUNTIME_ID ^ --project=PROJECT_ID ^ --region=REGION
如需详细了解用于从命令行删除 运行时模板的命令，请参阅gcloud CLI 文档。
REST
在使用任何请求数据之前， 请先进行以下替换：
REGION：运行时所在的区域。PROJECT_ID：您的项目 ID。RUNTIME_ID：运行时的 ID。
HTTP 方法和网址：
DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"
PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
如需了解详情，请参阅 notebookRuntimeTemplates.delete REST API
文档。