管理筆記本存取權

管理筆記本存取權

本頁說明如何授予及撤銷 Colab Enterprise 筆記本 (IPYNB 檔案) 的存取權。

事前準備

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

必要的角色

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

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

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

授予筆記本存取權

本節說明如何授予主體 Colab Enterprise 筆記本的存取權。

重要事項： 只要使用者具備筆記本存取權，即可查看筆記本中程式碼產生的所有輸出內容。即使輸出內容包含使用者無權存取的資源資料，使用者仍可查看。如要避免共用儲存的輸出內容，請關閉筆記本輸出內容儲存功能。

如要授予主體 Colab Enterprise 筆記本的存取權，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 Colab Enterprise「我的筆記本」頁面。

   前往「我的筆記本」

2. 在「Region」(區域) 選單中，選取包含筆記本的區域。

3. 在要共用的筆記本旁，按一下「筆記本動作」選單，然後選取「共用」。

4. 在「分享權限」視窗中，按一下「新增使用者/群組」。

5. 在「新增使用者/群組」對話方塊的「New principals」(新增主體) 欄位中，輸入一或多個主體，並以半形逗號分隔。

6. 在「Role」(角色) 清單中，選取下列其中一個角色：

   • 程式碼擁有者：可以對筆記本執行任何動作，包括刪除或共用筆記本。
   • 程式碼編輯者：可編輯筆記本。
   • 程式碼檢視者：可以查看筆記本。
   主體也必須具備「筆記本執行階段使用者」(roles/aiplatform.notebookRuntimeUser) 角色，才能執行筆記本。

7. 按一下 [儲存]。

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

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

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

關閉筆記本輸出內容儲存功能

如要禁止與可存取筆記本檔案的其他使用者共用已儲存的筆記本輸出內容，可以關閉筆記本輸出內容儲存功能。

為所選筆記本關閉輸出內容儲存功能後，Colab Enterprise 會刪除筆記本檔案中儲存的所有輸出內容，且不會儲存後續執行的輸出內容。

不過，具備筆記本存取權的使用者仍可透過下列方式查看輸出內容：

• 執行筆記本，即可查看目前的輸出內容。系統不會儲存這項輸出內容。

• 在修訂版本記錄中查看筆記本的封存版本和輸出內容。

如要為選取的筆記本關閉輸出內容儲存功能，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 Colab Enterprise「我的筆記本」頁面。

   前往「我的筆記本」

2. 在「Region」(區域) 選單中，選取包含筆記本的區域。

3. 按一下筆記本名稱即可開啟。

4. 依序點選「切換標題顯示設定」>「編輯」>「筆記本設定」。

5. 在「筆記本設定」視窗中，選取「儲存這個筆記本時，忽略程式碼儲存格輸出內容」。

6. 按一下 [儲存]。

7. 按一下「重新載入」。

撤銷筆記本存取權

如要撤銷 Colab Enterprise 筆記本的存取權，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「IAM」(身分與存取權管理) 頁面。

   前往「IAM」頁面

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

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

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

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

後續步驟

• 如要瞭解如何授予執行階段範本的存取權，請參閱「管理執行階段範本的存取權」。