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

Ações, recursos e chaves de condição do Amazon Lex

O Amazon Lex (prefixo do serviço: lex) fornece os seguintes recursos, ações e chaves de contexto de condição específicos ao serviço para uso em políticas de permissão do IAM.

Referências:

Ações definidas pelo Amazon Lex

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 Resource types (Tipos de recursos) 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 ("*") 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 declaração com essa ação. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você especificar um ARN de permissão no nível do recurso em uma instrução que esteja usando essa ação, ele deverá ser desse tipo. 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, mas não o outro.

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
CreateBotVersion Cria uma nova versão com base na versão $LATEST do bot especificado Write

bot version*

CreateIntentVersion Cria uma nova versão com base na versão $LATEST da intenção especificada Write

intent version*

CreateSlotTypeVersion Cria uma nova versão com base na versão $LATEST do tipo de slot especificado Write

slottype version*

DeleteBot Exclui todas as versões de um bot Write

bot version*

DeleteBotAlias Exclui um alias de um bot específico Write

bot alias*

DeleteBotChannelAssociation Exclui a associação entre um alias de bot do Amazon Lex e uma plataforma de sistema de mensagens Write

channel*

DeleteBotVersion Exclui uma versão específica de um bot Write

bot version*

DeleteIntent Exclui todas as versões de uma intenção Write

intent version*

DeleteIntentVersion Exclui uma versão específica de uma intenção Write

intent version*

DeleteSession Remove informações de sessão para um bot, alias e ID de usuário especificado Write

bot alias

bot version

DeleteSlotType Exclui todas as versões de um tipo de slot Write

slottype version*

DeleteSlotTypeVersion Exclui uma versão específica de um tipo de slot Write

slottype version*

DeleteUtterances Exclui as informações que o Amazon Lex mantém para enunciados em um bot e userId específicos Write

bot version*

GetBot Retorna informações para um bot específico. Além do nome do bot, a versão ou o alias do bot é necessário Read

bot alias

bot version

GetBotAlias Retorna informações sobre um alias de bot do Amazon Lex Read

bot alias*

GetBotAliases Retorna uma lista de alias para determinado bot do Amazon Lex List
GetBotChannelAssociation Retorna informações sobre a associação entre um bot do Amazon Lex e uma plataforma de sistema de mensagens Read

channel*

GetBotChannelAssociations Retorna uma lista de todos os canais associados a um único bot List

channel*

GetBotVersions Retorna informações sobre todas as versões de um bot específico List

bot version*

GetBots Retorna informações sobre a versão $LATEST de todos os bots, sujeitas a filtros fornecidos pelo cliente List
GetBuiltinIntent Retorna informações sobre uma intenção integrada Read
GetBuiltinIntents Obtém uma lista de intenções integradas que atendem aos critérios especificados Read
GetBuiltinSlotTypes Obtém uma lista dos tipos de slots integrados que atendem aos critérios especificados Read
GetExport Exporta o recurso do Amazon Lex em um formato solicitado Read

bot version*

GetImport Obtém informações sobre um trabalho de importação iniciado com StartImport Read
GetIntent Retorna informações sobre uma intenção específica. Além do nome da intenção, também é necessário especificar a versão da intenção Read

intent version*

GetIntentVersions Retorna informações sobre todas as versões de uma intenção específica List

intent version*

GetIntents Retorna informações sobre a versão $LATEST de todas as intenções, sujeitas a filtros fornecidos pelo cliente List
GetMigration Concede permissão para visualizar uma migração em andamento ou concluída Read
GetMigrations Concede permissão para visualizar a lista de migrações do Amazon Lex v1 para o Amazon Lex v2 List
GetSession Retorna informações de sessão para um bot, alias e ID de usuário especificado Read

bot alias

bot version

GetSlotType Retorna informações sobre uma versão específica de um tipo de slot. Além de especificar o nome do tipo de slot, também é necessário especificar a versão do tipo de slot Read

slottype version*

GetSlotTypeVersions Retorna informações sobre todas as versões de um tipo de slot específico List

slottype version*

GetSlotTypes Retorna informações sobre a versão $LATEST de todos os tipos de slots, sujeitas a filtros fornecidos pelo cliente List
GetUtterancesView Retorna uma visualização dos dados dos enunciados agregados das versões de um bot para um período recente List

bot version*

ListTagsForResource Lista etiquetas para um recurso do Lex Read

bot

bot alias

channel

PostContent Envia a entrada do usuário (texto ou fala) ao Amazon Lex Write

bot alias

bot version

PostText Envia a entrada do usuário (somente texto) ao Amazon Lex Write

bot alias

bot version

PutBot Cria ou atualiza a versão $LATEST de um bot de conversação do Amazon Lex Write

bot version*

aws:TagKeys

aws:RequestTag/${TagKey}

PutBotAlias Cria ou atualiza um alias para o bot específico Write

bot alias*

aws:TagKeys

aws:RequestTag/${TagKey}

PutIntent Cria ou atualiza a versão $LATEST de uma intenção Write

intent version*

PutSession Cria uma nova sessão ou modifica uma sessão existente com um bot do Amazon Lex Write

bot alias

bot version

PutSlotType Cria ou atualiza a versão $LATEST de um tipo de slot Write

slottype version*

StartImport Inicia um trabalho para importar um recurso para o Amazon Lex Write
StartMigration Concede permissão para migrar um bot do Amazon Lex v1 para o Amazon Lex v2 Write

bot version*

TagResource Adiciona ou substitui etiquetas a um recurso do Lex Marcação

bot

bot alias

channel

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource Remove etiquetas de um recurso do Lex Marcação

bot

bot alias

channel

aws:TagKeys

aws:RequestTag/${TagKey}

Tipos de recursos definidos pelo Amazon Lex

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. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos ARN Chaves de condição
bot arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}

aws:ResourceTag/${TagKey}

bot version arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}

aws:ResourceTag/${TagKey}

bot alias arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}

aws:ResourceTag/${TagKey}

channel arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}

aws:ResourceTag/${TagKey}

intent version arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
slottype version arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}

Chaves de condição do Amazon Lex

O Amazon Lex 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 visualizar as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.

Chaves de condição Descrição Type
aws:RequestTag/${TagKey} Filtra o acesso com base nas tags da solicitação. String
aws:ResourceTag/${TagKey} Filtra o acesso pelas etiquetas anexadas a um recurso do Lex. String
aws:TagKeys Filtra o acesso com base no conjunto de chaves da etiqueta na solicitação ArrayOfString
lex:associatedIntents Permite que você controle o acesso com base nas intenções incluídas na solicitação String
lex:associatedSlotTypes Permite que você controle o acesso com base nos tipos de slot incluídos na solicitação String
lex:channelType Permite que você controle o acesso com base no tipo de canal incluído na solicitação String