管理執行階段範本

本頁說明如何管理 Colab Enterprise 執行階段範本，包括下列工作：

  • 編輯執行階段範本。
  • 刪除執行階段範本。

必要的角色

如要取得管理 Colab Enterprise 執行階段範本所需的權限，請要求管理員授予您專案的「Colab Enterprise 管理員」 (roles/aiplatform.colabEnterpriseAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

編輯執行階段範本

您可以變更執行階段範本的部分規格，包括 Python 版本和加密金鑰設定。對執行階段範本所做的任何變更，只會套用至透過這個範本新建立的執行階段。

如要編輯執行階段範本，可以使用 Google Cloud 控制台或 REST API。

控制台

如要編輯執行階段範本，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的 Colab Enterprise「執行階段範本」頁面。

    前往執行階段範本

  2. 在「Region」(地區) 選單中，選取包含執行階段範本的地區。

  3. 在「ID」欄中，按一下要編輯的執行階段範本 ID 號碼。

  4. 按一下「編輯」圖示 。

  5. 在「編輯執行階段範本」面板中，變更執行階段範本。

  6. 按一下「Update」。

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
如果成功，回應主體會包含 Operation 的執行個體。

如要瞭解可用的查詢參數，請參閱 notebookRuntimeTemplates.patch REST API 說明文件。

刪除執行階段範本

如要刪除執行階段範本，可以使用 Google Cloud 控制台、gcloud CLI 或 REST API。

控制台

如要刪除執行階段範本，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的 Colab Enterprise「執行階段範本」頁面。

    前往執行階段範本

  2. 在「Region」(地區) 選單中，選取包含執行階段範本的地區。

  3. 選取要刪除的執行階段範本。

  4. 按一下「刪除」圖示 。

  5. 按一下「確認」。

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
如果成功，回應主體會包含 Operation 的執行個體。

詳情請參閱 notebookRuntimeTemplates.delete REST API 說明文件。

後續步驟