Ações, recursos e chaves de condição para o Amazon Bedrock Agentcore - Referência de autorização do serviço

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 para o 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 nas políticas de permissão do IAM.

Referências:

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, 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 os níveis de acesso, consulte Níveis de acesso nos resumos das 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 a telemetria vendida para um recurso Gerenciamento de permissões

memory*

BatchCreateMemoryRecords Concede permissão para criar um ou mais registros de memória Gravar

memory*

bedrock-agentcore:namespace

BatchDeleteMemoryRecords Concede permissão para excluir um ou mais registros de memória Gravar

memory*

BatchUpdateMemoryRecords Concede permissão para atualizar um ou mais registros de memória Gravar

memory*

bedrock-agentcore:namespace

CompleteResourceTokenAuth Concede permissão para recuperar o token de acesso com OAuth2 o fluxo 3LO para acessar recursos externos Leitura

oauth2credentialprovider*

token-vault*

workload-identity*

workload-identity-directory*

bedrock-agentcore:InboundJwtClaim/iss

bedrock-agentcore:InboundJwtClaim/sub

bedrock-agentcore:InboundJwtClaim/aud

bedrock-agentcore:InboundJwtClaim/scope

bedrock-agentcore:InboundJwtClaim/client_id

bedrock-agentcore:userid

ConnectBrowserAutomationStream Concede permissão para se conectar a um fluxo de automação do navegador Leitura
ConnectBrowserLiveViewStream Concede permissão para se conectar a uma transmissão ao vivo do navegador Leitura
CreateAgentRuntime Concede permissão para criar um novo tempo de execução do agente Gravar

aws:RequestTag/${TagKey}

aws:TagKeys

bedrock-agentcore:subnets

bedrock-agentcore:securityGroups

iam:PassRole

CreateAgentRuntimeEndpoint Concede permissão para criar um novo endpoint de tempo de execução do agente Gravar

runtime*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateApiKeyCredentialProvider Concede permissão para criar um novo provedor de credenciais de chave de API Gravar

apikeycredentialprovider*

token-vault*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateBrowser Concede permissão para criar um novo navegador personalizado Gravar

aws:RequestTag/${TagKey}

aws:TagKeys

bedrock-agentcore:subnets

bedrock-agentcore:securityGroups

CreateCodeInterpreter Concede permissão para criar um novo interpretador de código personalizado Gravar

aws:RequestTag/${TagKey}

aws:TagKeys

bedrock-agentcore:subnets

bedrock-agentcore:securityGroups

CreateEvent Concede permissão para criar um evento Gravar

memory*

bedrock-agentcore:sessionId

bedrock-agentcore:actorId

CreateGateway Concede permissão para criar um novo gateway Gravar

aws:RequestTag/${TagKey}

aws:TagKeys

iam:PassRole

CreateGatewayTarget Concede permissão para criar um novo alvo em um gateway existente Gravar

gateway*

CreateMemory Concede permissão para criar um recurso de memória Gravar

aws:RequestTag/${TagKey}

aws:TagKeys

iam:PassRole

CreateOauth2CredentialProvider Concede permissão para criar um novo provedor de credenciais para acessar recursos externos com protocolo OAuth2 Gravar

oauth2credentialprovider*

token-vault*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWorkloadIdentity Concede permissão para criar uma nova identidade de carga de trabalho Gravar

workload-identity*

workload-identity-directory*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteAgentRuntime Concede permissão para excluir um tempo de execução do agente Gravar

runtime*

DeleteAgentRuntimeEndpoint Concede permissão para excluir um endpoint de tempo de execução do agente Gravar

runtime*

runtime-endpoint*

DeleteApiKeyCredentialProvider Concede permissão para excluir um provedor de credenciais de chave de API registrado Gravar

apikeycredentialprovider*

token-vault*

DeleteBrowser Concede permissão para excluir um navegador personalizado Gravar

browser-custom*

DeleteCodeInterpreter Concede permissão para excluir um interpretador de código personalizado Gravar

code-interpreter-custom*

DeleteEvent Concede permissão para excluir um evento Gravar

memory*

bedrock-agentcore:sessionId

bedrock-agentcore:actorId

DeleteGateway Concede permissão para excluir um gateway existente Gravar

gateway*

DeleteGatewayTarget Concede permissão para excluir um alvo de gateway existente Gravar

gateway*

DeleteMemory Concede permissão para excluir um recurso de memória Gravar

memory*

DeleteMemoryRecord Concede permissão para excluir um registro de memória Gravar

memory*

DeleteOauth2CredentialProvider Concede permissão para excluir um provedor de OAuth2 credenciais registrado Gravar

oauth2credentialprovider*

token-vault*

DeleteWorkloadIdentity Concede permissão para excluir uma identidade de carga de trabalho registrada Gravar

workload-identity*

workload-identity-directory*

GetAgentCard Concede permissão para recuperar um cartão de agente para A2A Leitura

runtime*

runtime-endpoint*

GetAgentRuntime Concede permissão para obter detalhes do tempo de execução de um agente Leitura

runtime*

GetAgentRuntimeEndpoint Concede permissão para obter detalhes de um endpoint de tempo de execução do agente Leitura

runtime*

runtime-endpoint*

GetApiKeyCredentialProvider Concede permissão para buscar um provedor de credenciais de chave de API registrado pelo nome Leitura

apikeycredentialprovider*

token-vault*

GetBrowser Concede permissão para obter detalhes de um navegador Leitura

browser-custom*

GetBrowserSession Concede permissão para obter detalhes de uma sessão do navegador Leitura

browser*

browser-custom*

GetCodeInterpreter Concede permissão para obter detalhes de um interpretador de código Leitura

code-interpreter-custom*

GetCodeInterpreterSession Concede permissão para obter detalhes de uma sessão de intérprete de código Leitura

code-interpreter*

code-interpreter-custom*

GetEvent Concede permissão para buscar um evento Leitura

memory*

bedrock-agentcore:sessionId

bedrock-agentcore:actorId

GetGateway Concede permissão para recuperar um gateway existente Leitura

gateway*

GetGatewayTarget Concede permissão para recuperar um destino de gateway existente Leitura

gateway*

GetMemory Concede permissão para buscar detalhes de um recurso de memória Leitura

memory*

GetMemoryRecord Concede permissão para buscar um registro de memória Leitura

memory*

GetOauth2CredentialProvider Concede permissão para buscar um provedor de OAuth2 credenciais registrado pelo nome Leitura

oauth2credentialprovider*

token-vault*

GetResourceApiKey Concede permissão para recuperar uma chave de API associada a um provedor de credenciais de chave de API Leitura

apikeycredentialprovider*

token-vault*

workload-identity*

workload-identity-directory*

GetResourceOauth2Token Concede permissão para recuperar o token de acesso com fluxo OAuth2 2LO ou 3LO para acessar recursos externos Leitura

oauth2credentialprovider*

token-vault*

workload-identity*

workload-identity-directory*

GetTokenVault Concede permissão para buscar a configuração atual do TokenVault, incluindo as configurações de criptografia Leitura

token-vault*

GetWorkloadAccessToken Concede permissão para recuperar um token de acesso à carga de trabalho para cargas de trabalho agentes que não atuam em nome de um usuário Gravar

workload-identity*

workload-identity-directory*

GetWorkloadAccessTokenForJWT Concede permissão para recuperar um token de acesso à carga de trabalho para cargas de trabalho agentes que atuam em nome do usuário com o token JWT Gravar

workload-identity*

workload-identity-directory*

bedrock-agentcore:InboundJwtClaim/iss

bedrock-agentcore:InboundJwtClaim/sub

bedrock-agentcore:InboundJwtClaim/aud

bedrock-agentcore:InboundJwtClaim/scope

bedrock-agentcore:InboundJwtClaim/client_id

GetWorkloadAccessTokenForUserId Concede permissão para recuperar um token de acesso à carga de trabalho para cargas de trabalho agentes que atuam em nome do usuário com ID de usuário Gravar

workload-identity*

workload-identity-directory*

bedrock-agentcore:userid

GetWorkloadIdentity Concede permissão para buscar detalhes de uma identidade específica da carga de trabalho, incluindo seu nome e retorno permitido OAuth2 URLs Leitura

workload-identity*

workload-identity-directory*

InvokeAgentRuntime Concede permissão para invocar um endpoint de tempo de execução do agente Gravar

runtime*

runtime-endpoint*

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

runtime*

runtime-endpoint*

InvokeCodeInterpreter Concede permissão para invocar uma sessão de intérprete de código Gravar

code-interpreter*

code-interpreter-custom*

InvokeGateway [somente permissão] Concede permissão para invocar um gateway Gerenciamento de permissões

gateway*

ListActors Concede permissão para listar atores Lista

memory*

ListAgentRuntimeEndpoints Concede permissão para listar endpoints de tempo de execução do agente Lista
ListAgentRuntimeVersions Concede permissão para listar as versões de tempo de execução do agente Lista
ListAgentRuntimes Concede permissão para listar os tempos de execução do agente Lista
ListApiKeyCredentialProviders Concede permissão para listar todos os provedores de credenciais de chave de API no Token Vault Leitura

apikeycredentialprovider*

token-vault*

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 de intérprete de código Lista

code-interpreter*

code-interpreter-custom*

ListCodeInterpreters Concede permissão para listar intérpretes de código Lista
ListEvents Concede permissão para listar eventos Lista

memory*

bedrock-agentcore:sessionId

bedrock-agentcore:actorId

ListGatewayTargets Concede permissão para listar alvos de gateway existentes Lista

gateway*

ListGateways Concede permissão para listar gateways existentes Lista
ListMemories Concede permissão para listar recursos de memória Lista
ListMemoryRecords Concede permissão para listar registros de memória Lista

memory*

bedrock-agentcore:namespace

bedrock-agentcore:strategyId

ListOauth2CredentialProviders Concede permissão para listar todos os provedores de OAuth2 credenciais no Token Vault Leitura

oauth2credentialprovider*

token-vault*

ListSessions Concede permissão para listar sessões Lista

memory*

bedrock-agentcore:actorId

ListTagsForResource Concede permissão para listar tags para um recurso Bedrock AgentCore Lista

apikeycredentialprovider

browser-custom

code-interpreter-custom

gateway

memory

oauth2credentialprovider

runtime

runtime-endpoint

token-vault

workload-identity

workload-identity-directory

ListWorkloadIdentities Concede permissão para listar todas as identidades de carga de trabalho na do chamador Conta da AWS Leitura

workload-identity*

workload-identity-directory*

RetrieveMemoryRecords Concede permissão para recuperar registros de memória por meio de consulta semática Lista

memory*

bedrock-agentcore:namespace

bedrock-agentcore:strategyId

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 Leitura

token-vault*

StartBrowserSession Concede permissão para iniciar uma nova sessão do navegador Gravar

browser*

browser-custom*

StartCodeInterpreterSession Concede permissão para iniciar uma nova sessão de intérprete de código Gravar

code-interpreter*

code-interpreter-custom*

StopBrowserSession Concede permissão para interromper uma sessão do navegador Gravar

browser*

browser-custom*

StopCodeInterpreterSession Concede permissão para interromper uma sessão de intérprete de código Gravar

code-interpreter*

code-interpreter-custom*

StopRuntimeSession Concede permissão para interromper uma sessão em tempo de execução Gravar

runtime*

runtime-endpoint*

SynchronizeGatewayTargets [somente permissão] Concede permissão para habilitar a pesquisa em gateways Gerenciamento de permissões

gateway*

TagResource Concede permissão para marcar um recurso Bedrock AgentCore Tags

apikeycredentialprovider

browser-custom

code-interpreter-custom

gateway

memory

oauth2credentialprovider

runtime

runtime-endpoint

token-vault

workload-identity

workload-identity-directory

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource Concede permissão ao recurso Untag a Bedrock- AgentCore Tags

apikeycredentialprovider

browser-custom

code-interpreter-custom

gateway

memory

oauth2credentialprovider

runtime

runtime-endpoint

token-vault

workload-identity

workload-identity-directory

aws:TagKeys

UpdateAgentRuntime Concede permissão para atualizar o tempo de execução de um agente Gravar

runtime*

iam:PassRole

bedrock-agentcore:subnets

bedrock-agentcore:securityGroups

UpdateAgentRuntimeEndpoint Concede permissão para atualizar um endpoint de tempo de execução do agente Gravar

runtime*

runtime-endpoint*

UpdateApiKeyCredentialProvider Concede permissão para atualizar um provedor de credenciais de chave de API existente Gravar

apikeycredentialprovider*

token-vault*

UpdateBrowserStream Concede permissão para atualizar o status do fluxo da sessão do navegador Gravar

browser*

browser-custom*

UpdateGateway Concede permissão para atualizar um gateway existente Gravar

gateway*

iam:PassRole

UpdateGatewayTarget Concede permissão para atualizar um destino de gateway existente Gravar

gateway*

UpdateMemory Concede permissão para atualizar um recurso de memória Gravar

memory*

iam:PassRole

UpdateOauth2CredentialProvider Concede permissão para atualizar um provedor de OAuth2 credenciais existente Gravar

oauth2credentialprovider*

token-vault*

UpdateWorkloadIdentity Concede permissão para atualizar os metadados de uma identidade de carga de trabalho existente Gravar

workload-identity*

workload-identity-directory*

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.

Tipos de recursos ARN Chaves de condição
memory arn:${Partition}:bedrock-agentcore:${Region}:${Account}:memory/${MemoryId}

aws:ResourceTag/${TagKey}

gateway arn:${Partition}:bedrock-agentcore:${Region}:${Account}:gateway/${GatewayId}

aws:ResourceTag/${TagKey}

workload-identity arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}/workload-identity/${WorkloadIdentityName}

aws:ResourceTag/${TagKey}

oauth2credentialprovider arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/oauth2credentialprovider/${Name}

aws:ResourceTag/${TagKey}

apikeycredentialprovider arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/apikeycredentialprovider/${Name}

aws:ResourceTag/${TagKey}

runtime arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}

aws:ResourceTag/${TagKey}

runtime-endpoint arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}/runtime-endpoint/${Name}

aws:ResourceTag/${TagKey}

code-interpreter-custom arn:${Partition}:bedrock-agentcore:${Region}:${Account}:code-interpreter-custom/${CodeInterpreterId}

aws:ResourceTag/${TagKey}

code-interpreter arn:${Partition}:bedrock-agentcore:${Region}:aws:code-interpreter/${CodeInterpreterId}
browser-custom arn:${Partition}:bedrock-agentcore:${Region}:${Account}:browser-custom/${BrowserId}

aws:ResourceTag/${TagKey}

browser arn:${Partition}:bedrock-agentcore:${Region}:aws:browser/${BrowserId}
workload-identity-directory arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}

aws:ResourceTag/${TagKey}

token-vault arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}

aws:ResourceTag/${TagKey}

Chaves de condição para Amazon Bedrock Agentcore

O Amazon Bedrock Agentcore define as seguintes chaves de condição que podem ser usadas no Condition elemento 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 ver as chaves de condição globais que estão disponíveis para todos os serviços, consulte chaves de contexto de condição AWS global.

Chaves de condição Descrição Type
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 declaração de público (aud) no JWT passado na solicitação ArrayOfString
bedrock-agentcore:InboundJwtClaim/client_id Filtra o acesso pela declaração client_id no JWT passado na solicitação String
bedrock-agentcore:InboundJwtClaim/iss Filtra o acesso pela declaração do emissor (iss) presente no JWT passado na solicitação String
bedrock-agentcore:InboundJwtClaim/scope Filtra o acesso pela declaração de escopo no JWT passado na solicitação ArrayOfString
bedrock-agentcore:InboundJwtClaim/sub Filtra o acesso pela declaração de assunto (sub) no JWT passada na solicitação String
bedrock-agentcore:actorId Filtra o acesso por ID de ator String
bedrock-agentcore:namespace Filtra o acesso por namespace String
bedrock-agentcore:securityGroups Filtra o acesso pelo ID dos grupos de segurança configurados para o AgentCore tempo de execução ArrayOfString
bedrock-agentcore:sessionId Filtra o acesso por ID de sessão String
bedrock-agentcore:strategyId Filtra o acesso por ID de estratégia de memória String
bedrock-agentcore:subnets Filtra o acesso pelo ID das sub-redes configuradas para o tempo de execução AgentCore ArrayOfString
bedrock-agentcore:userid Filtra o acesso pelo valor estático do ID do usuário passado na solicitação String