Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Usar perfis vinculados ao serviço para o Amazon Lex V2

Modo de foco
Usar perfis vinculados ao serviço para o Amazon Lex V2 - Guia do desenvolvedor

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á.

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á.

O Amazon Lex V2 usa funções AWS Identity and Access Management vinculadas a serviços (IAM). Um perfil vinculado ao serviço é um tipo especial de perfil do IAM vinculado diretamente ao Amazon Lex V2. As funções vinculadas ao serviço são predefinidas pelo Amazon Lex V2 e incluem todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome.

Um perfil vinculado ao serviço facilita a configuração do Amazon Lex V2 porque você não precisa adicionar as permissões necessárias manualmente. O Amazon Lex V2 define as permissões dos perfis vinculados ao serviço e, a não ser que esteja definido de outra forma, somente o Amazon Lex V2 poderá assumir os perfis. As permissões definidas incluem a política de confiança e a política de permissões, e essa política não pode ser anexada a nenhuma outra entidade do IAM.

Para obter informações sobre outros serviços que oferecem suporte aos perfis vinculados ao serviço, consulte Serviços da AWS que funcionam com o IAM e procure os serviços com Sim na coluna Perfil vinculado ao serviço. Escolha um Sim com um link para exibir a documentação da função vinculada a serviço desse serviço.

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua um perfil vinculado a serviço. Para mais informações, consulte Permissões de perfil vinculado ao serviço no Guia do usuário do IAM.

Você pode excluir um perfil vinculado ao serviço somente depois de excluir os recursos relacionados. Isso protege seus recursos do Amazon Lex V2, pois você não pode remover por engano as permissões para acessar os recursos.

Criar um perfil vinculado ao serviço para o Amazon Lex V2

Você não precisa criar manualmente uma função vinculada ao serviço, porque o Amazon Lex V2 cria a função vinculada ao serviço para você quando você executa a ação relevante (consulte Permissões de perfil vinculado ao serviço para o Amazon Lex V2 para obter mais informações) na AWS Management Console API, ou. AWS CLI AWS

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, você poderá usar esse mesmo processo para criar um novo perfil em sua conta.

Editar um perfil vinculado ao serviço do Amazon Lex V2

O Amazon Lex V2 não permite que você edite perfis vinculados ao serviço. Depois que você criar um perfil vinculado ao serviço, não poderá alterar o nome do perfil, pois várias entidades podem fazer referência ao perfil. No entanto, você poderá editar a descrição de um perfil usando o IAM. Para mais informações, consulte Editar uma função vinculada ao serviço no Guia do usuário do IAM.

Excluir um perfil vinculado ao serviço do Amazon Lex V2

Se você não precisar mais usar um atributo ou serviço que requer uma função vinculada a serviço, é recomendável excluí-la. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de seu perfil vinculado ao serviço antes de excluí-lo manualmente.

nota

Se o serviço do Amazon Lex V2 estiver usando o perfil quando você tentar excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para ver as etapas para excluir recursos para perfis vinculados ao serviço específicos no Amazon Lex V2, consulte a seção específica do perfil em Permissões de perfil vinculado ao serviço para o Amazon Lex V2.

Como excluir manualmente o perfil vinculado ao serviço usando o IAM

Depois de excluir recursos relacionados a uma função vinculada ao serviço, use o console do IAM AWS CLI, a ou a AWS API para excluir a função. Para obter mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.

Permissões de perfil vinculado ao serviço para o Amazon Lex V2

O Amazon Lex V2 usa perfis vinculados ao serviço com os prefixos a seguir.

AWSServiceRoleForLexRobôs V2_

A função AWSService RoleForLex V2Bots_ dá permissões para conectar seu bot a outros serviços necessários. Esse perfil inclui uma política de confiança para permitir que o serviço lexv2.amazonaws.com assuma o perfil e permissões para realizar as ações a seguir.

  • Use o Amazon Polly para sintetizar a fala em todos os recursos do Amazon Lex V2 que a ação permite.

  • Se um bot estiver configurado para usar a análise de sentimento do Amazon Comprehend, detecte o sentimento em todos os recursos do Amazon Lex V2 que a ação permite.

  • Se um bot estiver configurado para armazenar logs de áudio em um bucket do S3, coloque os objetos em um bucket especificado.

  • Se um bot estiver configurado para armazenar logs de áudio e texto, crie um fluxo de logs e coloque os logs em um grupo de logs especificado.

  • Se um bot estiver configurado para usar uma AWS KMS chave para criptografar dados, gere uma chave de dados específica.

  • Se um bot estiver configurado para usar a intenção KendraSearchIntent, consulte o acesso a um índice específico do Amazon Kendra.

Para criar o perfil

O Amazon Lex V2 cria uma nova função AWSService RoleForLex V2Bots_ com um sufixo aleatório na sua conta toda vez que você cria um bot. O Amazon Lex V2 modifica o perfil quando você adiciona recursos adicionais a um bot. Por exemplo, se você adicionar a análise de sentimento do Amazon Comprehend a um bot, o Amazon Lex V2 adicionará a permissão para a ação lex:DetectSentiment ao perfil de serviço.

Para excluir o perfil
  1. Faça login no AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. No painel de navegação esquerdo, selecione Bots e escolha o bot cujo perfil vinculado ao serviço você deseja excluir.

  3. Selecione qualquer versão do bot.

  4. O perfil de runtime das permissões do IAM está nos Detalhes da versão.

  5. Volte à página Bots e selecione o botão de opção ao lado do bot a ser excluído.

  6. Selecione Ação e escolha Excluir.

  7. Siga as etapas em Excluir uma função vinculada ao serviço para excluir o perfil do IAM.

AWSServiceRoleForLexCanais V2_

A função AWSService RoleForLex V2Channels_ dá permissão para listar bots em uma conta e chamar uma conversa para um bot. APIs Esse perfil inclui uma política de confiança para permitir que o serviço channels.lexv2.amazonaws.com assuma o perfil. Se um bot estiver configurado para usar um canal para se comunicar com um serviço de mensagens, a política de permissões da função AWSService RoleForLex V2Channels_ permite que o Amazon Lex V2 conclua as seguintes ações.

  • Listar as permissões de todos os bots em uma conta.

  • Reconhecer texto, obter sessão e colocar permissões de sessão em um alias de bot especificado.

Para criar o perfil

Quando você cria uma integração de canais para implantar um bot em uma plataforma de mensagens, o Amazon Lex V2 cria um novo perfil vinculado ao serviço em sua conta para cada canal com um sufixo aleatório.

Para excluir o perfil
  1. Faça login no AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. No painel de navegação esquerdo, selecione Bots.

  3. Escolha um bot.

  4. No painel de navegação esquerdo, escolha Integrações de canais em Implantações.

  5. Selecione um canal cujo perfil vinculado ao serviço você deseja excluir.

  6. O perfil de runtime de permissões do IAM está na Configuração geral.

  7. Escolha Excluir e selecione Excluir novamente para excluir o canal.

  8. Siga as etapas em Excluir uma função vinculada ao serviço para excluir o perfil do IAM.

AWSServiceRoleForLexReplicação V2

A função AWSService RoleForLex V2Replication dá permissão para replicar bots em uma segunda região. Essa função inclui uma política de confiança para permitir que o serviço replication.lexv2.amazonaws.com assuma a função e também inclui a política AmazonLexReplicationPolicy AWS gerenciada, que permite permissões para as seguintes ações.

  • Passe os perfis do IAM do bot para o bot de réplica para duplicar as permissões apropriadas para o bot de réplica.

  • Crie e gerencie bots e recursos de bots (versões, aliases, intenções, slots, vocabulários personalizados etc.) em outras regiões.

Para criar o perfil

Quando você ativa a resiliência global para um bot, o Amazon Lex V2 cria a função vinculada ao serviço AWSService RoleForLex V2Replication em sua conta. Verifique se você tem as permissões corretas para conceder ao serviço Amazon Lex V2 permissões para criar o perfil vinculado ao serviço.

Para excluir os recursos do Amazon Lex V2 usados pelo AWSService RoleForLex V2Replication para que você possa excluir a função
  1. Faça login no AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. Escolha um bot para o qual a resiliência global esteja habilitada.

  3. Selecione Resiliência global em Implantação.

  4. Selecione Desabilitar a resiliência global.

  5. Repita o processo para todos os bots que tiverem a resiliência global habilitada.

  6. Siga as etapas em Excluir uma função vinculada ao serviço para excluir o perfil do IAM.

Regiões com suporte a perfis vinculados ao serviço do Amazon Lex V2.

O Amazon Lex V2 é compatível com perfis vinculados ao serviço em todas as regiões em que o serviço está disponível. Para mais informações, consulte Regiões e endpoints da AWS.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.