管理对笔记本的访问权限

管理对笔记本的访问权限

本页介绍了如何授予和撤消对 Colab Enterprise 笔记本 (IPYNB 文件) 的访问权限。

准备工作

1. 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.

2. 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

3. Make sure that billing is enabled for your Google Cloud project.

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

   Enable the APIs

5. 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

6. Make sure that billing is enabled for your Google Cloud project.

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

   Enable the APIs

所需的角色

如需确保您的用户账号具有管理对 Colab Enterprise 笔记本的访问权限所需的权限，请让您的管理员向您的用户账号授予项目的 Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您的管理员还可以通过自定义角色或其他预定义角色向您的用户账号授予所需的权限。

一个或多个必需的角色可提供 dataform.repositories.list 权限。在项目中被授予 dataform.repositories.list 权限或 Code Creator (roles/dataform.codeCreator) 角色的用户可以使用 Dataform API 或 Dataform 命令行界面 (CLI) 列出该项目中代码资产的名称。使用 BigQuery Studio 的非管理员只能看到他们创建或与他们共享的代码资产。

授予对笔记本的访问权限

本部分介绍了如何向主账号授予对 Colab Enterprise 笔记本的访问权限。

重要提示： 有权访问笔记本的用户可以查看由笔记本中的代码生成的所有输出。用户可以看到此输出，即使输出包含他们无权访问的资源中的数据也是如此。如需禁止共享保存的输出，请关闭笔记本输出保存。

如需向主账号授予对 Colab Enterprise 笔记本的访问权限，请执行以下操作：

1. 在 Google Cloud 控制台中，进入 Colab Enterprise Notebooks 页面。

   转到 Notebooks

2. 在区域菜单中，选择包含您的笔记本的区域。

3. 在要共享的笔记本旁边，点击 Notebook 操作菜单，然后选择共享。

4. 在共享权限窗口中，点击  添加用户/群组。

5. 在添加用户/群组对话框的新的主账号字段中，输入一个或多个主账号（主账号之间用英文逗号分隔）。

6. 在角色列表中，选择以下角色之一：

   • Code Owner：可以对笔记本执行任何操作，包括删除或共享笔记本。
   • Code Editor：可以修改笔记本。
   • Code Viewer：可以查看笔记本。
   主账号还必须拥有 Notebook Runtime User (roles/aiplatform.notebookRuntimeUser) 角色才能运行笔记本。

7. 点击保存。

Colab Enterprise 主账号是用户、群组或网域

您可以向用户、群组或网域授予访问权限。请参阅下表：

主账号	用户账号示例
单个用户	[e-mail]
Google 群组	[e-mail]
Google Workspace 网域	example.com

关闭笔记本输出保存

如需阻止与有权访问笔记本文件的其他用户共享保存的笔记本输出，您可以关闭笔记本输出保存。

为所选笔记本关闭输出保存功能后，Colab Enterprise 会删除笔记本文件中保存的所有输出，且不会保存后续运行的输出。

不过，有权访问笔记本的用户仍可以通过以下方式查看其输出：

• 运行笔记本以查看其当前输出。此输出不保存。

• 在修订历史记录中查看笔记本的归档版本及其输出。

如需为所选笔记本关闭输出保存功能，请执行以下操作：

1. 在 Google Cloud 控制台中，进入 Colab Enterprise Notebooks 页面。

   转到 Notebooks

2. 在区域菜单中，选择包含您的笔记本的区域。

3. 选择要关闭输出保存功能的笔记本。

4. 依次点击  显示/隐藏标题 > 修改 > 笔记本设置。

5. 在笔记本设置窗口中，选择保存此笔记本时忽略代码单元格输出项。

6. 点击保存。

7. 点击重新加载。

撤消对笔记本的访问权限

如需撤消对 Colab Enterprise 笔记本的访问权限，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 IAM 页面。

   转到 IAM

2. 选择一个项目、文件夹或组织。

3. 找到包含要撤消其访问权限的主账号的行。然后，点击该行中的 修改主账号。

   注意：管理资源访问权限时，您无法修改继承的角色。要修改继承的角色，请找到授予角色的资源。

4. 点击要撤消的角色对应的删除 按钮，然后点击保存。

后续步骤

• 如需了解如何授予对运行时模板的访问权限，请参阅管理对运行时模板的访问权限。