管理執行階段範本的存取權

管理執行階段範本的存取權

本頁說明如何在 Colab Enterprise 中授予及撤銷執行階段範本的存取權。

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the 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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

Enable the APIs

必要的角色

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

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

一或多個必要角色包含 dataform.repositories.list 權限。在專案中獲派 dataform.repositories.list 權限或「程式碼建立者」(roles/dataform.codeCreator) 角色的使用者，可以使用 Dataform API 或 Dataform 指令列介面 (CLI)，列出該專案中的程式碼資產名稱。使用 BigQuery Studio 的非管理員只能查看自己建立或與自己共用的程式碼資產。

授予執行階段範本的存取權

如要授予主體執行階段範本的存取權，可以使用 Google Cloud 控制台、Google Cloud CLI 或 Terraform。

控制台

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

   前往「執行階段範本」

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

3. 在「執行階段範本」選單中，選取執行階段範本。如果沒有列出任何執行階段範本，請建立執行階段範本。

4. 按一下「權限」。

5. 在「權限」視窗中，按一下「新增主體」。

6. 在「授予存取權」對話方塊的「New principals」(新增主體) 欄位中，輸入一個或以半形逗號分隔的主體清單。

7. 在「Select a role」(請選擇角色) 選單中完成對話方塊，指派角色。

8. 選用：按一下「新增其他角色」，然後重複上一個步驟。

9. 按一下 [儲存]。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• RUNTIME_TEMPLATE_ID：執行階段範本的 ID。
• PRINCIPAL：要新增繫結的主體。
• ROLE：要指派給主體的角色名稱。
• PROJECT_ID：您的專案 ID。
• REGION：執行階段範本所在的區域。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID \
    --member=PRINCIPAL \
    --role=ROLE \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID `
    --member=PRINCIPAL `
    --role=ROLE `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID ^
    --member=PRINCIPAL ^
    --role=ROLE ^
    --project=PROJECT_ID ^
    --region=REGION

如要進一步瞭解如何透過指令列管理執行階段範本的 IAM 政策，請參閱 gcloud CLI 說明文件。

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。 詳情請參閱 Terraform供應商參考說明文件。

下列範例使用 google_colab_runtime_template_iam_policy Terraform 資源，授予 Colab Enterprise 執行階段範本的存取權。

data "google_iam_policy" "admin" {
  binding {
    role = "roles/viewer"
    members = [
      "user:[e-mail]",
    ]
  }
}

resource "google_colab_runtime_template_iam_policy" "policy" {
  project = google_colab_runtime_template.runtime-template.project
  location = google_colab_runtime_template.runtime-template.location
  runtime_template = google_colab_runtime_template.runtime-template.name
  policy_data = data.google_iam_policy.admin.policy_data
}

Colab Enterprise 主體包括使用者、群組或網域

您可以將存取權授予使用者、群組或網域。請參閱下表：

主體	使用者帳戶範例
單一使用者	[e-mail]
Google 群組	[e-mail]
Google Workspace 網域	example.com

撤銷執行階段範本的存取權

如要撤銷執行階段範本的存取權，可以使用 Google Cloud 控制台或 gcloud CLI。

控制台

1. 前往 Google Cloud 控制台的「IAM」IAM頁面。

   前往「IAM」頁面

2. 選取專案、資料夾或機構。

3. 找到包含要撤銷存取權主體的資料列。然後點選該列中的「Edit principal」(編輯主體) 圖示 。

   注意： 管理資源存取權時，您無法編輯沿用的角色。如要編輯沿用的角色，請前往授予角色的資源。

4. 針對要撤銷的角色按一下「刪除」圖示 按鈕，然後按一下「儲存」。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• RUNTIME_TEMPLATE_ID：執行階段範本的 ID。
• PRINCIPAL：要撤銷存取權的主體。
• ROLE：要從主體移除的角色。
• PROJECT_ID：您的專案 ID。
• REGION：執行階段範本所在的區域。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID \
    --member=PRINCIPAL \
    --role=ROLE \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID `
    --member=PRINCIPAL `
    --role=ROLE `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID ^
    --member=PRINCIPAL ^
    --role=ROLE ^
    --project=PROJECT_ID ^
    --region=REGION

如要進一步瞭解如何透過指令列管理執行階段範本的 IAM 政策，請參閱 gcloud CLI 說明文件。

後續步驟

• 如要瞭解如何授予筆記本存取權，請參閱「管理筆記本存取權」。