As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Ações, recursos e chaves de condição do Amazon Bedrock Agentcore
O Amazon Bedrock Agentcore (prefixo do serviço: bedrock-agentcore) fornece os seguintes recursos, ações e chaves de contexto de condição específicos do serviço para uso em políticas de permissões do IAM.
Referências:
-
Saiba como configurar este serviço.
-
Visualize uma lista das operações de API disponíveis para este serviço.
-
Saiba como proteger esse serviço e seus recursos usando políticas de permissão do IAM.
Tópicos
Ações definidas pelo Amazon Bedrock Agentcore
Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.
A coluna Nível de acesso da tabela Ações descreve como a ação é classificada (lista, leitura, gravação, gerenciamento de permissões ou marcação). Esta classificação pode ajudar você a compreender o nível de acesso que uma ação concede quando a usa em uma política. Para obter mais informações sobre níveis de acesso, consulte Níveis de acesso em resumos de políticas.
A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.
A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.
A coluna Ações dependentes da tabela Ações mostra permissões adicionais que podem ser necessárias para chamar uma ação com êxito. Essas permissões podem ser necessárias além da permissão para a ação em si. Quando uma ação especifica ações dependentes, essas dependências podem se aplicar a recursos adicionais definidos para essa ação, não somente ao primeiro recurso listado na tabela.
nota
As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.
Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.
| Ações | Descrição | Nível de acesso | Tipos de recursos (*necessários) | Chaves de condição | Ações dependentes |
|---|---|---|---|---|---|
| AllowVendedLogDeliveryForResource [somente permissão] | Concede permissão para configurar telemetria fornecida para um recurso | Gerenciamento de permissões | |||
| AuthorizeAction [somente permissão] | Concede permissão para avaliar as políticas da Cedar para solicitações de autorização | Gerenciamento de permissões | |||
| BatchCreateMemoryRecords | Concede permissão para criar um ou mais registros de memória | Gravar | |||
| BatchDeleteMemoryRecords | Concede permissão para excluir um ou mais registros de memória | Gravar | |||
| BatchUpdateMemoryRecords | Concede permissão para atualizar um ou mais registros de memória | Gravar | |||
| CompleteResourceTokenAuth | Concede permissão para recuperar o token de acesso com OAuth2 o fluxo 3LO para acessar recursos externos | Ler | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud bedrock-agentcore:InboundJwtClaim/scope |
|||||
| ConnectBrowserAutomationStream | Concede permissão para se conectar a um fluxo de automação do navegador | Ler | |||
| ConnectBrowserLiveViewStream | Concede permissão para se conectar a uma transmissão ao vivo do navegador | Ler | |||
| CreateAgentRuntime | Concede permissão para criar um runtime do agente | Gravar |
iam:PassRole |
||
| CreateAgentRuntimeEndpoint | Concede permissão para criar um endpoint de runtime do agente | Gravar | |||
| CreateApiKeyCredentialProvider | Concede permissão para criar um provedor de credenciais de chaves de API | Gravar | |||
| CreateBrowser | Concede permissão para criar um navegador personalizado | Gravar | |||
| CreateCodeInterpreter | Concede permissão para criar um interpretador de código personalizado | Gravar | |||
| CreateEvaluator | Concede permissão para criar um novo avaliador | Gravar | |||
| CreateEvent | Concede permissão para criar um evento | Gravar | |||
| CreateGateway | Concede permissão para criar um novo gateway | Gravar |
iam:PassRole |
||
| CreateGatewayTarget | Concede permissão para criar um destino em um gateway existente | Gravar | |||
| CreateMemory | Concede permissão para criar um recurso de memória | Gravar |
iam:PassRole |
||
| CreateOauth2CredentialProvider | Concede permissão para criar um novo provedor de credenciais para acessar recursos externos com protocolo OAuth2 | Gravar | |||
| CreateOnlineEvaluationConfig | Concede permissão para criar uma nova configuração de avaliação on-line | Gravar |
iam:PassRole |
||
| CreatePolicy | Concede permissão para criar uma nova política em um mecanismo de políticas | Gravar | |||
| CreatePolicyEngine | Concede permissão para criar um novo mecanismo de políticas | Gravar | |||
| CreateWorkloadIdentity | Concede permissão para criar uma identidade de workload | Gravar | |||
| DeleteAgentRuntime | Concede permissão para excluir um runtime de agente | Gravar | |||
| DeleteAgentRuntimeEndpoint | Concede permissão para excluir um endpoint de runtime de agente | Gravar | |||
| DeleteApiKeyCredentialProvider | Concede permissão para excluir um provedor de credenciais de chaves de API registrado | Gravar | |||
| DeleteBrowser | Concede permissão para excluir um navegador personalizado | Gravar | |||
| DeleteCodeInterpreter | Concede permissão para excluir um interpretador de código personalizado | Gravar | |||
| DeleteEvaluator | Concede permissão para excluir um avaliador | Gravar | |||
| DeleteEvent | Concede permissão para excluir um evento | Gravar | |||
| DeleteGateway | Concede permissão para excluir um gateway existente | Gravar | |||
| DeleteGatewayTarget | Concede permissão para excluir um destino de gateway existente | Gravar | |||
| DeleteMemory | Concede permissão para excluir um recurso de memória | Gravar | |||
| DeleteMemoryRecord | Concede permissão para excluir um registro de memória | Gravar | |||
| DeleteOauth2CredentialProvider | Concede permissão para excluir um provedor de OAuth2 credenciais registrado | Gravar | |||
| DeleteOnlineEvaluationConfig | Concede permissão para excluir uma configuração de avaliação on-line | Gravar | |||
| DeletePolicy | Concede permissão para excluir uma política | Gravar | |||
| DeletePolicyEngine | Concede permissão para excluir um mecanismo de política | Gravar | |||
| DeleteResourcePolicy | Concede permissão para excluir a política baseada em recursos para um recurso do Bedrock | Gravar | |||
| DeleteWorkloadIdentity | Concede permissão para excluir uma identidade de workload registrada | Gravar | |||
| Evaluate | Concede permissão para executar uma avaliação usando um avaliador | Gravar | |||
| GetAgentCard | Concede permissão para recuperar um cartão de agente para A2A | Ler | |||
| GetAgentRuntime | Concede permissão para obter detalhes de um runtime de agente | Ler | |||
| GetAgentRuntimeEndpoint | Concede permissão para obter detalhes de um endpoint de runtime de agente | Ler | |||
| GetApiKeyCredentialProvider | Concede permissão para buscar um provedor de credenciais de chaves de API registrado pelo nome | Ler | |||
| GetBrowser | Concede permissão para obter detalhes de um navegador | Ler | |||
| GetBrowserSession | Concede permissão para obter detalhes de uma sessão do navegador | Ler | |||
| GetCodeInterpreter | Concede permissão para obter detalhes de um interpretador de código | Ler | |||
| GetCodeInterpreterSession | Concede permissão para obter detalhes de uma sessão do interpretador de código | Ler | |||
| GetEvaluator | Concede permissão para obter detalhes de um avaliador | Ler | |||
| GetEvent | Concede permissão para buscar um evento | Ler | |||
| GetGateway | Concede permissão para recuperar um gateway existente | Ler | |||
| GetGatewayTarget | Concede permissão para recuperar um destino de gateway existente | Ler | |||
| GetMemory | Concede permissão para buscar detalhes para um recurso de memória | Ler | |||
| GetMemoryRecord | Concede permissão para buscar um registro de memória | Ler | |||
| GetOauth2CredentialProvider | Concede permissão para buscar um provedor de OAuth2 credenciais registrado pelo nome | Ler | |||
| GetOnlineEvaluationConfig | Concede permissão para obter detalhes de uma configuração de avaliação on-line | Ler | |||
| GetPolicy | Concede permissão para recuperar uma política | Ler | |||
| GetPolicyEngine | Concede permissão para recuperar um mecanismo de política | Ler | |||
| GetPolicyGeneration | Concede permissão para recuperar o status e os resultados de uma solicitação de geração de política | Ler | |||
| GetResourceApiKey | Concede permissão para recuperar uma chave de API associada a um provedor de credenciais de chaves de API | Ler | |||
| GetResourceOauth2Token | Concede permissão para recuperar o token de acesso com fluxo OAuth2 2LO ou 3LO para acessar recursos externos | Ler | |||
| GetResourcePolicy | Concede permissão para recuperar a política baseada em recursos para um recurso do Bedrock | Ler | |||
| GetTokenVault | Concede permissão para buscar a configuração atual do TokenVault, incluindo as configurações de criptografia | Ler | |||
| GetWorkloadAccessToken | Concede permissão para recuperar um token de acesso de workload para workloads de agentes que não atuam em nome de um usuário | Gravar | |||
| GetWorkloadAccessTokenForJWT | Concede permissão para recuperar um token de acesso de workload para workloads de agentes que atuam em nome do usuário com o token JWT | Gravar | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud |
|||||
| GetWorkloadAccessTokenForUserId | Concede permissão para recuperar um token de acesso de workload para workloads de agentes que atuam em nome do usuário com ID de usuário | Gravar | |||
| GetWorkloadIdentity | Concede permissão para buscar detalhes de uma identidade específica da carga de trabalho, incluindo seu nome e retorno permitido OAuth2 URLs | Ler | |||
| InvokeAgentRuntime | Concede permissão para invocar um endpoint de runtime de agente | Gravar | |||
| InvokeAgentRuntimeForUser | Concede permissão para invocar um endpoint de tempo de execução do agente com X-Amzn-Bedrock-AgentCore - header Runtime-User-Id | Gravar | |||
| InvokeAgentRuntimeWithWebSocketStream | Concede permissão para invocar um endpoint de tempo de execução do agente com stream WebSocket | Gravar | |||
| InvokeAgentRuntimeWithWebSocketStreamForUser | Concede permissão para invocar um endpoint de tempo de execução do agente com WebSocket stream e com X-Amzn-Bedrock-AgentCore - header Runtime-User-Id | Gravar | |||
| InvokeCodeInterpreter | Concede permissão para invocar uma sessão de interpretador de código | Gravar | |||
| InvokeGateway [somente permissão] | Concede permissão para invocar um gateway | Gerenciamento de permissões | |||
| ListActors | Concede permissão para listar Actors | Lista | |||
| ListAgentRuntimeEndpoints | Concede permissão para listar endpoints de runtime de agente | Lista | |||
| ListAgentRuntimeVersions | Concede permissão para listar versões de runtime de agente | Lista | |||
| ListAgentRuntimes | Concede permissão para listar runtimes de agente | Lista | |||
| ListApiKeyCredentialProviders | Concede permissão para listar todos os provedores de credenciais de chaves de API no Token Vault | Ler | |||
| ListBrowserSessions | Concede permissão para listar sessões do navegador | Lista | |||
| ListBrowsers | Concede permissão para listar navegadores | Lista | |||
| ListCodeInterpreterSessions | Concede permissão para listar sessões do interpretador de código | Lista | |||
| ListCodeInterpreters | Concede permissão para listar interpretadores de código | Lista | |||
| ListEvaluators | Concede permissão para listar avaliadores | Lista | |||
| ListEvents | Concede permissão para listar eventos | Lista | |||
| ListGatewayTargets | Concede permissão para listar destinos de gateway existentes | Lista | |||
| ListGateways | Concede permissão para listar gateways existentes | Lista | |||
| ListMemories | Concede permissão para listar recursos de memória | Lista | |||
| ListMemoryExtractionJobs | Concede permissão para listar trabalhos de extração para essa memória | Lista | |||
| ListMemoryRecords | Concede permissão para listar registros de memória | Lista | |||
| ListOauth2CredentialProviders | Concede permissão para listar todos os provedores de OAuth2 credenciais no Token Vault | Ler | |||
| ListOnlineEvaluationConfigs | Concede permissão para listar configurações de avaliação on-line | Lista | |||
| ListPolicies | Concede permissão para listar políticas em um mecanismo de políticas | Lista | |||
| ListPolicyEngines | Concede permissão para listar mecanismos de políticas | Lista | |||
| ListPolicyGenerationAssets | Concede permissão para listar ativos de política gerados a partir de uma solicitação de geração | Lista | |||
| ListPolicyGenerations | Concede permissão para listar solicitações de geração de políticas | Lista | |||
| ListSessions | Concede permissão para listar sessões | Lista | |||
| ListTagsForResource | Concede permissão para listar tags para um recurso Bedrock AgentCore | Lista | |||
| ListWorkloadIdentities | Concede permissão para listar todas as identidades de carga de trabalho na do chamador Conta da AWS | Ler | |||
| ManageAdminPolicy [somente permissão] | Concede permissão para criar ou modificar políticas curinga que se aplicam aos recursos do gateway | Gerenciamento de permissões | |||
| ManageResourceScopedPolicy [somente permissão] | Concede permissão para criar ou modificar políticas que se aplicam a recursos específicos do gateway | Gerenciamento de permissões | |||
| PartiallyAuthorizeActions [somente permissão] | Concede permissão para realizar uma avaliação parcial das políticas do Cedar para autorizar um chamador a listar as ferramentas para as quais ele pode ligar | Gerenciamento de permissões | |||
| PutResourcePolicy | Concede permissão para criar ou atualizar a política baseada em recursos para um recurso da Bedrock | Gravar | |||
| RetrieveMemoryRecords | Concede permissão para recuperar registros de memória por meio de consultas do Sematic | Lista | |||
| SetTokenVaultCMK | Concede permissão para associar uma Chave Gerenciada pelo Cliente (CMK) ou uma Chave Gerenciada pelo Serviço a uma Chave Gerenciada pelo Cliente a uma Chave Gerenciada pelo Cliente TokenVault | Ler | |||
| StartBrowserSession | Concede permissão para iniciar uma sessão do navegador | Gravar | |||
| StartCodeInterpreterSession | Concede permissão para iniciar uma sessão do interpretador de código | Gravar | |||
| StartMemoryExtractionJob | Concede permissão para iniciar o trabalho de extração de memória | Gravar | |||
| StartPolicyGeneration | Concede permissão para iniciar uma solicitação de geração de políticas baseada em IA | Gravar | |||
| StopBrowserSession | Concede permissão para interromper uma sessão do navegador | Gravar | |||
| StopCodeInterpreterSession | Concede permissão para interromper uma sessão do interpretador de código | Gravar | |||
| StopRuntimeSession | Concede permissão para interromper uma sessão de runtime | Gravar | |||
| SynchronizeGatewayTargets [somente permissão] | Concede permissão para habilitar a pesquisa em gateways | Gerenciamento de permissões | |||
| TagResource | Concede permissão para marcar um recurso Bedrock AgentCore | Tags | |||
| UntagResource | Concede permissão ao recurso Untag a Bedrock- AgentCore | Tags | |||
| UpdateAgentRuntime | Concede permissão para atualizar um runtime de agente | Gravar |
iam:PassRole |
||
| UpdateAgentRuntimeEndpoint | Concede permissão para atualizar um endpoint de runtime de agente | Gravar | |||
| UpdateApiKeyCredentialProvider | Concede permissão para atualizar um provedor de credenciais de chaves de API existente | Gravar | |||
| UpdateBrowserStream | Concede permissão para atualizar o status de um fluxo de sessões do navegador | Gravar | |||
| UpdateEvaluator | Concede permissão para atualizar um avaliador | Gravar | |||
| UpdateGateway | Concede permissão para atualizar um gateway existente | Gravar |
iam:PassRole |
||
| UpdateGatewayTarget | Concede permissão para atualizar um destino de gateway existente | Gravar | |||
| UpdateMemory | Concede permissão para atualizar um recurso de memória | Gravar |
iam:PassRole |
||
| UpdateOauth2CredentialProvider | Concede permissão para atualizar um provedor de OAuth2 credenciais existente | Gravar | |||
| UpdateOnlineEvaluationConfig | Concede permissão para atualizar uma configuração de avaliação on-line | Gravar |
iam:PassRole |
||
| UpdatePolicy | Concede permissão para atualizar uma política existente | Gravar | |||
| UpdatePolicyEngine | Concede permissão para atualizar um mecanismo de políticas | Gravar | |||
| UpdateWorkloadIdentity | Concede permissão para atualizar os metadados de uma identidade de workload existente | Gravar | |||
Tipos de recursos definidos pelo Amazon Bedrock AgentCore
Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.
| Resource types | ARN | Chaves de condição |
|---|---|---|
| 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}
|
Chaves de condição do Amazon Bedrock AgentCore
O Amazon Bedrock Agentcore define as seguintes chaves de condição que podem ser usadas no elemento Condition de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.
Para exibir as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de contexto de condição globais da AWS.
| Chaves de condição | Descrição | Tipo |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra o acesso ao criar solicitações com base no conjunto de valores permitidos para cada uma das etiquetas obrigatórias | Segmento |
| aws:ResourceTag/${TagKey} | Filtra o acesso às ações com base no valor da etiqueta associada ao recurso | String |
| aws:TagKeys | Filtra o acesso ao criar solicitações com base na presença de etiquetas obrigatórias na solicitação | ArrayOfString |
| bedrock-agentcore:GatewayAuthorizerType | Filtra o acesso pelo atributo authorizerType em um Gateway | String |
| bedrock-agentcore:InboundJwtClaim/aud | Filtra o acesso pela solicitação audience (aud) no JWT transmitido na solicitação | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/client_id | Filtra o acesso pela solicitação client_id no JWT transmitido na solicitação | String |
| bedrock-agentcore:InboundJwtClaim/iss | Filtra o acesso pela solicitação issuer (aud) no JWT transmitido na solicitação | String |
| bedrock-agentcore:InboundJwtClaim/scope | Filtra o acesso pela solicitação scope no JWT transmitido na solicitação | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/sub | Filtra o acesso pela solicitação subject (sub) no JWT transmitido na solicitação | String |
| bedrock-agentcore:actorId | Filtra o acesso por Actor Id | String |
| bedrock-agentcore:namespace | Filtra o acesso por namespace | String |
| bedrock-agentcore:sessionId | Filtra o acesso por Session Id | String |
| bedrock-agentcore:strategyId | Filtra o acesso por Memory Strategy Id | String |
| bedrock-agentcore:userid | Filtra o acesso pelo valor de ID do usuário estático transmitido na solicitação | String |
