本页介绍了如何使用 Identity and Access Management (IAM) 控制 Vertex AI Agent Builder 资源的 Discovery Engine API 访问权限。
概览
Google Cloud 提供 IAM，可让您授予对特定 Google Cloud 资源的更细化访问权限，并防止对其他资源进行不必要的访问。本页介绍了 Vertex AI Agent Builder IAM 角色和权限。如需详细了解 Google Cloud IAM，请参阅 IAM 文档。
Vertex AI Agent Builder 提供了一组预定义角色，旨在帮助您控制对 Vertex AI Agent Builder 资源的访问权限。如果预定义角色未提供您所需的权限，您还可以创建自己的自定义角色。此外，旧版基本角色（Editor、Viewer 和 Owner）仍可供您使用，但这些角色提供的控制不如 Vertex AI Agent Builder 角色那样精细。具体而言，基本角色提供的是对整个 Google Cloud 资源的访问权限，而不仅仅是对 Vertex AI Agent Builder 的访问权限。如需了解详情，请参阅基本角色文档。
预定义角色
Vertex AI Agent Builder 提供了一些预定义角色，可供您用来为主账号授予更精细的权限。您授予主账号的角色决定了主账号可以执行的操作。主账号可以是个人、群组或服务账号。
如果您拥有相关权限，可向同一主账号授予多个角色，还可随时更改授予主账号的角色。
权限范围较广的角色拥有权限范围较窄的角色的所有权限。例如，Discovery Engine Editor 角色包含 Discovery Engine Viewer 角色的所有权限，还在其基础上添加了一些额外的 Discovery Engine Editor 角色权限。同样，Discovery Engine Admin 角色包含 Discovery Engine Editor 角色的所有权限，以及其额外的权限。
基本角色（Owner、Editor、Viewer）提供对整个 Google Cloud 的权限。Vertex AI Agent Builder 专有角色仅提供 Vertex AI Agent Builder 权限，但以下 Google Cloud 权限除外，因为这些是 Google Cloud 常规使用所需的权限：
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
下表列出了 Vertex AI Agent Builder IAM 角色及其包含的所有权限的列表。
| 角色 | 权限 |
|---|---|
Discovery Engine Admin（ 授予对所有 Discovery Engine 资源的完整访问权限。 |
|
Discovery Engine Editor（ 授予对所有 Discovery Engine 资源的读写权限。 |
|
Discovery Engine User Beta 版（ 授予对 Discovery Engine 资源的用户级访问权限。 |
|
Discovery Engine Viewer（ 授予对所有 Discovery Engine 资源的读取权限。 |
|
管理 Vertex AI Agent Builder IAM
您可以使用 Google Cloud 控制台获取和设置 IAM 允许政策和 IAM 角色。如需了解详情，请参阅管理对项目、文件夹和组织的访问权限。
后续步骤
- 了解如何管理对项目、文件夹和组织的访问权限。
- 详细了解 IAM。
- 详细了解基本角色。
- 详细了解自定义角色。