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