本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon Bedrock AgentCore 的操作、资源和条件键
Amazon Bedrock AgentCore(服务前缀:bedrock-agentcore)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。
参考:
Amazon Bedrock AgentCore 定义的操作
您可以在 IAM 策略语句的 Action 元素中指定以下操作。可以使用策略授予在 AWS中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的访问级别列描述如何对操作进行分类(列出、读取、权限管理或标记)。此分类可以帮助您了解当您在策略中使用操作时,相应操作授予的访问级别。有关访问级别的更多信息,请参阅策略摘要中的访问级别。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定策略应用的所有资源(“*”)。通过在 IAM policy 中使用条件来筛选访问权限,以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源,则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限,则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息,请参阅资源类型表的条件键列。
操作表的依赖操作列显示成功调用操作可能需要的其他权限。除了操作本身的权限以外,可能还需要这些权限。若某个操作指定依赖操作,则这些依赖关系可能适用于为该操作定义的其他资源,而不仅仅是表中列出的第一个资源。
注意
资源条件键在资源类型表中列出。您可以在操作表的资源类型(* 为必需)列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列,这是应用于操作表中操作的资源条件键。
有关下表中各列的详细信息,请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型(* 为必需) | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| AllowVendedLogDeliveryForResource [仅权限] | 授予权限以为资源配置提供的遥测 | 权限管理 | |||
| AuthorizeAction [仅权限] | 授予针对授权请求评估 Cedar 策略的权限 | 权限管理 | |||
| BatchCreateMemoryRecords | 授予权限以创建一个或多个内存记录 | 写入 | |||
| BatchDeleteMemoryRecords | 授予权限以删除一个或多个内存记录 | 写入 | |||
| BatchUpdateMemoryRecords | 授予权限以更新一个或多个内存记录 | 写入 | |||
| CompleteResourceTokenAuth | 授予通过 3LO 流程检索访问令牌 OAuth2 的权限,以访问外部资源 | 读取 | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud bedrock-agentcore:InboundJwtClaim/scope |
|||||
| ConnectBrowserAutomationStream | 授予权限以连接到浏览器自动化流 | 读取 | |||
| ConnectBrowserLiveViewStream | 授予权限以连接到浏览器实时查看流 | 读取 | |||
| CreateAgentRuntime | 授予权限以创建新的代理运行时 | 写入 |
iam:PassRole |
||
| CreateAgentRuntimeEndpoint | 授予权限以创建新的代理运行时端点 | 写入 | |||
| CreateApiKeyCredentialProvider | 授予权限以创建新的 API 密钥凭证提供商 | 写入 | |||
| CreateBrowser | 授予权限以创建新的自定义浏览器 | 写入 | |||
| CreateCodeInterpreter | 授予权限以创建新的自定义代码解释器 | 写入 | |||
| CreateEvaluator | 授予创建新评估者的权限 | 写入 | |||
| CreateEvent | 授予权限以创建事件 | 写入 | |||
| CreateGateway | 授予权限以创建新网关 | 写入 |
iam:PassRole |
||
| CreateGatewayTarget | 授予权限以在现有网关中创建新目标 | 写入 | |||
| CreateMemory | 授予权限以创建内存资源 | 写入 |
iam:PassRole |
||
| CreateOauth2CredentialProvider | 授予创建新的凭据提供者以使用协议访问外部资源的权限 OAuth2 | 写入 | |||
| CreateOnlineEvaluationConfig | 授予创建新的在线评估配置的权限 | 写入 |
iam:PassRole |
||
| CreatePolicy | 授予在策略引擎中创建新策略的权限 | 写入 | |||
| CreatePolicyEngine | 授予创建新策略引擎的权限 | 写入 | |||
| CreateWorkloadIdentity | 授予权限以创建新的工作负载身份 | 写入 | |||
| DeleteAgentRuntime | 授予权限以删除代理运行时 | 写入 | |||
| DeleteAgentRuntimeEndpoint | 授予权限以删除代理运行时端点 | 写入 | |||
| DeleteApiKeyCredentialProvider | 授予权限以删除注册的 API 密钥凭证提供商 | 写入 | |||
| DeleteBrowser | 授予权限以删除自定义浏览器 | 写入 | |||
| DeleteCodeInterpreter | 授予权限以删除自定义代码解释器 | 写入 | |||
| DeleteEvaluator | 授予删除评估者的权限 | 写入 | |||
| DeleteEvent | 授予权限以删除事件 | 写入 | |||
| DeleteGateway | 授予权限以删除现有网关 | 写入 | |||
| DeleteGatewayTarget | 授予权限以删除现有网关目标 | 写入 | |||
| DeleteMemory | 授予权限以删除内存资源 | 写入 | |||
| DeleteMemoryRecord | 授予权限以删除内场记录 | 写入 | |||
| DeleteOauth2CredentialProvider | 授予删除已注册 OAuth2 凭证提供者的权限 | 写入 | |||
| DeleteOnlineEvaluationConfig | 授予删除在线评估配置的权限 | 写入 | |||
| DeletePolicy | 授予删除策略的权限 | 写入 | |||
| DeletePolicyEngine | 授予删除策略引擎的权限 | 写入 | |||
| DeleteResourcePolicy | 授予删除 Bedrock 资源的基于资源的策略的权限 | 写入 | |||
| DeleteWorkloadIdentity | 授予权限以删除注册的工作负载身份 | 写入 | |||
| Evaluate | 授予使用评估器进行评估的权限 | 写入 | |||
| GetAgentCard | 授予授权以检索 A2A 代理卡 | 读取 | |||
| GetAgentRuntime | 授予权限以获取代理运行时的详细信息 | 读取 | |||
| GetAgentRuntimeEndpoint | 授予权限以获取代理运行时端点的详细信息 | 读取 | |||
| GetApiKeyCredentialProvider | 授予权限以按其名称获取注册的 API 密钥凭证提供商 | 读取 | |||
| GetBrowser | 授予权限以获取浏览器的详细信息 | 读取 | |||
| GetBrowserSession | 授予权限以获取浏览器会话的详细信息 | 读取 | |||
| GetCodeInterpreter | 授予权限以获取代码解释器的详细信息 | 读取 | |||
| GetCodeInterpreterSession | 授予权限以获取代码解释器会话的详细信息 | 读取 | |||
| GetEvaluator | 授予获取评估者详细信息的权限 | 读取 | |||
| GetEvent | 授予权限以获取事件 | 读取 | |||
| GetGateway | 授予权限以检索现有网关 | 读取 | |||
| GetGatewayTarget | 授予权限以检索现有网关目标 | 读取 | |||
| GetMemory | 授予权限以获取内存资源的详细信息 | 读取 | |||
| GetMemoryRecord | 授予权限以获取内场记录 | 读取 | |||
| GetOauth2CredentialProvider | 授予按其名称获取已注册 OAuth2 凭证提供商的权限 | 读取 | |||
| GetOnlineEvaluationConfig | 授予获取在线评估配置详细信息的权限 | 读取 | |||
| GetPolicy | 授予检索策略的权限 | 读取 | |||
| GetPolicyEngine | 授予检索策略引擎的权限 | 读取 | |||
| GetPolicyGeneration | 授予检索策略生成请求状态和结果的权限 | 读取 | |||
| GetResourceApiKey | 授予权限以检索与 API 密钥凭证提供商关联的 API 密钥 | 读取 | |||
| GetResourceOauth2Token | 授予通过 OAuth2 2LO 或 3LO 流程检索访问令牌的权限,以访问外部资源 | 读取 | |||
| GetResourcePolicy | 授予检索 Bedrock 资源的基于资源的策略的权限 | 读取 | |||
| GetTokenVault | 授予获取当前配置(包括加密设置)的权限 TokenVault | 读取 | |||
| GetWorkloadAccessToken | 授予权限以为不代表用户执行的代理式工作负载检索工作负载访问令牌 | 写入 | |||
| GetWorkloadAccessTokenForJWT | 授予权限以为代表具有 JWT 令牌的用户执行的代理式工作负载检索工作负载访问令牌 | 写入 | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud |
|||||
| GetWorkloadAccessTokenForUserId | 授予权限以为代表具有用户 ID 的用户执行的代理式工作负载检索工作负载访问令牌 | 写入 | |||
| GetWorkloadIdentity | 授予获取特定工作负载身份详细信息的权限,包括其名称和允许的 OAuth2 返回值 URLs | 读取 | |||
| InvokeAgentRuntime | 授予权限以调用代理运行时端点 | 写入 | |||
| InvokeAgentRuntimeForUser | 授予调用带有 X-Amzn-Bedrock-AgentCore-Runtime-User-Id 标头的代理运行时端点的权限 | 写入 | |||
| InvokeAgentRuntimeWithWebSocketStream | 授予使用 WebSocket 流调用代理运行时端点的权限 | 写入 | |||
| InvokeAgentRuntimeWithWebSocketStreamForUser | 授予调用带有 WebSocket stream 和 X-Amzn-Bedrock-AgentCore-Runtime-User-Id 标头的代理运行时端点的权限 | 写入 | |||
| InvokeCodeInterpreter | 授予权限以调用代码解释器会话 | 写入 | |||
| InvokeGateway [仅权限] | 授予权限以调用网关 | 权限管理 | |||
| ListActors | 授予权限以列出参与者 | 列表 | |||
| ListAgentRuntimeEndpoints | 授予权限以列出代理运行时端点 | 列表 | |||
| ListAgentRuntimeVersions | 授予权限以列出代理运行时版本 | 列表 | |||
| ListAgentRuntimes | 授予权限以列出代理运行时 | 列表 | |||
| ListApiKeyCredentialProviders | 授予权限以列出令牌文件库中的所有 API 密钥凭证提供商 | 读取 | |||
| ListBrowserSessions | 授予权限以列出浏览器会话 | 列表 | |||
| ListBrowsers | 授予权限以列出浏览器 | 列表 | |||
| ListCodeInterpreterSessions | 授予权限以列出代码解释器会话 | 列表 | |||
| ListCodeInterpreters | 授予权限以列出代码解释器 | 列表 | |||
| ListEvaluators | 授予列出评估者的权限 | 列表 | |||
| ListEvents | 授予权限以列出事件 | 列表 | |||
| ListGatewayTargets | 授予权限以列出现有网关目标 | 列表 | |||
| ListGateways | 授予权限以列出现有网关 | 列表 | |||
| ListMemories | 授予权限以列出内存资源 | 列表 | |||
| ListMemoryExtractionJobs | 授予列出该内存的提取任务的权限 | 列表 | |||
| ListMemoryRecords | 授予权限以列出内存记录 | 列表 | |||
| ListOauth2CredentialProviders | 授予列出令牌库中所有 OAuth2 凭证提供者的权限 | 读取 | |||
| ListOnlineEvaluationConfigs | 授予列出在线评估配置的权限 | 列表 | |||
| ListPolicies | 授予在策略引擎中列出策略的权限 | 列表 | |||
| ListPolicyEngines | 授予列出策略引擎的权限 | 列表 | |||
| ListPolicyGenerationAssets | 授予列出生成请求中生成的策略资产的权限 | 列表 | |||
| ListPolicyGenerations | 授予列出策略生成请求的权限 | 列表 | |||
| ListSessions | 授予权限以列出会话 | 列表 | |||
| ListTagsForResource | 授予列出 Bedrock-AgentCore 资源标签的权限 | 列表 | |||
| ListWorkloadIdentities | 授予列出调用者所有工作负载身份的权限 AWS 账户 | 读取 | |||
| ManageAdminPolicy [仅权限] | 授予创建或修改适用于网关资源的通配符策略的权限 | 权限管理 | |||
| ManageResourceScopedPolicy [仅权限] | 授予创建或修改适用于特定网关资源的策略的权限 | 权限管理 | |||
| PartiallyAuthorizeActions [仅权限] | 授予对 Cedar 策略进行部分评估的权限,以授权呼叫者列出允许他们调用的工具 | 权限管理 | |||
| PutResourcePolicy | 授予为 Bedrock 资源创建或更新基于资源的策略的权限 | 写入 | |||
| RetrieveMemoryRecords | 授予权限以通过语义查询检索内存记录 | 列表 | |||
| SetTokenVaultCMK | 授予将客户托管密钥 (CMK) 或服务托管密钥与特定密钥关联的权限 TokenVault | 读取 | |||
| StartBrowserSession | 授予权限以开启新的浏览器会话 | 写入 | |||
| StartCodeInterpreterSession | 授予权限以开启新的代码解释器会话 | 写入 | |||
| StartMemoryExtractionJob | 授予启动内存提取作业的权限 | 写入 | |||
| StartPolicyGeneration | 授予启动 AI 支持的策略生成请求的权限 | 写入 | |||
| StopBrowserSession | 授予权限以停止浏览器会话 | 写入 | |||
| StopCodeInterpreterSession | 授予权限以停止代码解释器会话 | 写入 | |||
| StopRuntimeSession | 授予权限以停止运行时会话 | 写入 | |||
| SynchronizeGatewayTargets [仅权限] | 授予权限以启用网关搜索 | 权限管理 | |||
| TagResource | 授予标记基AgentCore 岩资源的权限 | 标签 | |||
| UntagResource | 授予取消标记基岩资源的权限 AgentCore | 标签 | |||
| UpdateAgentRuntime | 授予权限以更新代理运行时 | 写入 |
iam:PassRole |
||
| UpdateAgentRuntimeEndpoint | 授予权限以更新代理运行时端点 | 写入 | |||
| UpdateApiKeyCredentialProvider | 授予权限以更新现有 API 密钥凭证提供商 | 写入 | |||
| UpdateBrowserStream | 授予权限以更新浏览器会话流的状态 | 写入 | |||
| UpdateEvaluator | 授予更新评估者的权限 | 写入 | |||
| UpdateGateway | 授予权限以更新现有网关 | 写入 |
iam:PassRole |
||
| UpdateGatewayTarget | 授予权限以更新现有网关目标 | 写入 | |||
| UpdateMemory | 授予权限以更新内存资源 | 写入 |
iam:PassRole |
||
| UpdateOauth2CredentialProvider | 授予更新现有 OAuth2 凭证提供者的权限 | 写入 | |||
| UpdateOnlineEvaluationConfig | 授予更新在线评估配置的权限 | 写入 |
iam:PassRole |
||
| UpdatePolicy | 授予更新现有政策的权限 | 写入 | |||
| UpdatePolicyEngine | 授予更新策略引擎的权限 | 写入 | |||
| UpdateWorkloadIdentity | 授予权限以更新现有工作负载身份的元数据 | 写入 | |||
Amazon Bedrock AgentCore 定义的资源类型
以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息,请参阅资源类型表。
| 资源类型 | ARN | 条件键 |
|---|---|---|
| evaluator |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:evaluator/${EvaluatorId}
|
|
| online-evaluation-config |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:online-evaluation-config/${OnlineEvaluationConfigId}
|
|
| memory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:memory/${MemoryId}
|
|
| gateway |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:gateway/${GatewayId}
|
|
| workload-identity |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}/workload-identity/${WorkloadIdentityName}
|
|
| oauth2credentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/oauth2credentialprovider/${Name}
|
|
| apikeycredentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/apikeycredentialprovider/${Name}
|
|
| runtime |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}
|
|
| runtime-endpoint |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}/runtime-endpoint/${Name}
|
|
| code-interpreter-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:code-interpreter-custom/${CodeInterpreterId}
|
|
| code-interpreter |
arn:${Partition}:bedrock-agentcore:${Region}:aws:code-interpreter/${CodeInterpreterId}
|
|
| browser-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:browser-custom/${BrowserId}
|
|
| browser |
arn:${Partition}:bedrock-agentcore:${Region}:aws:browser/${BrowserId}
|
|
| workload-identity-directory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}
|
|
| token-vault |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}
|
|
| policy-engine |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:policy-engine/${PolicyEngineId}
|
|
| policy |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:policy-engine/${PolicyEngineId}/policy/${PolicyId}
|
|
| policy-generation |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:policy-engine/${PolicyEngineId}/policy-generation/${PolicyGenerationId}
|
Amazon Bedrock AgentCore 的条件键
Amazon Bedrock AgentCore 定义以下可以在 IAM 策略的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅条件键表。
要查看适用于所有服务的全局条件键,请参阅 AWS 全局条件上下文键。
| 条件键 | 描述 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 根据每个必需标签的允许值集,筛选对创建请求的访问权限 | 字符串 |
| aws:ResourceTag/${TagKey} | 根据与资源关联的标签值,筛选对操作的访问权限 | 字符串 |
| aws:TagKeys | 根据在请求中是否具有必需标签,筛选对创建请求的访问权限 | ArrayOfString |
| bedrock-agentcore:GatewayAuthorizerType | 按网关上的 authorizerType 属性筛选访问权限 | 字符串 |
| bedrock-agentcore:InboundJwtClaim/aud | 按请求中传递的 JWT 中的受众声明(aud)筛选访问权限 | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/client_id | 按请求中传递的 JWT 中的 client_id 声明筛选访问权限 | 字符串 |
| bedrock-agentcore:InboundJwtClaim/iss | 按请求中传递的 JWT 中的发布者(iss)声明筛选访问权限 | 字符串 |
| bedrock-agentcore:InboundJwtClaim/scope | 按请求中传递的 JWT 中的范围声明筛选访问权限 | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/sub | 按请求中传递的 JWT 中的主体声明(sub)筛选访问权限 | 字符串 |
| bedrock-agentcore:actorId | 按参与者 ID 筛选访问权限 | 字符串 |
| bedrock-agentcore:namespace | 按命名空间筛选访问权限 | 字符串 |
| bedrock-agentcore:sessionId | 按会话 ID 筛选访问权限 | 字符串 |
| bedrock-agentcore:strategyId | 按内存策略 ID 筛选访问权限 | 字符串 |
| bedrock-agentcore:userid | 按请求中传递的静态用户 ID 值筛选访问权限 | 字符串 |