Ações Tipos de recursos Chaves de condição

Ações, recursos e chaves de condição do Amazon Q in Connect

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

Referências:

Saiba como configurar este serviço.
Veja uma lista das APIoperações disponíveis para esse serviço.
Saiba como proteger esse serviço e seus recursos usando políticas de IAM permissão.

Tópicos

Ações definidas pelo Amazon Q in Connect
Tipos de recursos definidos pelo Amazon Q in Connect
Chaves de condição do Amazon Q in Connect

Ações definidas pelo Amazon Q in Connect

Você pode especificar as seguintes ações no Action elemento de uma declaração de IAM política. Use políticas para conceder permissões para executar uma operação na AWS. Quando você usa uma ação em uma política, geralmente permite ou nega acesso à API operação ou ao CLI comando 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 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 declaraçã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 Resource elemento em uma IAM política, deverá incluir um padrão ARN ou 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.

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
ActivateMessageTemplate	Concede permissão para ativar um modelo de mensagem	Escrever	KnowledgeBase*
ActivateMessageTemplate	Concede permissão para ativar um modelo de mensagem	Escrever	MessageTemplate*
AllowVendedLogDeliveryForResource [somente permissão]	Concede permissão para configurar a entrega de logs fornecidos para um assistente	Gerenciamento de permissões	Assistant
CreateAIAgent	Concede permissão para criar um agente de IA	Escrever	Assistant*
CreateAIAgent	Concede permissão para criar um agente de IA	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIAgentVersion	Concede permissão para criar uma versão do agente de IA	Escrever	AIAgent*
			Assistant*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrail	Concede permissão para criar uma grade de proteção aérea	Escrever	Assistant*
CreateAIGuardrail	Concede permissão para criar uma grade de proteção aérea	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIGuardrailVersion	Concede permissão para criar uma versão de guardrail de inteligência artificial	Escrever	AIGuardrail*
			Assistant*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPrompt	Concede permissão para criar um prompt de IA	Escrever	Assistant*
CreateAIPrompt	Concede permissão para criar um prompt de IA	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateAIPromptVersion	Concede permissão para criar uma versão do prompt de IA	Escrever	AIPrompt*
			Assistant*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistant	Concede permissão para criar um assistente	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateAssistantAssociation	Concede permissão para criar uma associação entre um assistente e outro recurso	Escrever	Assistant*
CreateAssistantAssociation		Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateContent	Concede permissão para criar conteúdo	Escrever	KnowledgeBase*
CreateContent	Concede permissão para criar conteúdo	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateContentAssociation	Concede permissão para criar uma associação de conteúdo	Escrever	Content*
			KnowledgeBase*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateKnowledgeBase	Concede permissão para criar uma base de conhecimentos	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplate	Concede permissão para criar um modelo de mensagem	Escrever	KnowledgeBase*
CreateMessageTemplate	Concede permissão para criar um modelo de mensagem	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateMessageTemplateAttachment	Concede permissão para criar um anexo em um modelo de mensagem	Escrever	KnowledgeBase*
CreateMessageTemplateAttachment		Escrever	MessageTemplate*
CreateMessageTemplateVersion	Concede permissão para criar uma versão de um modelo de mensagem	Escrever	KnowledgeBase*
CreateMessageTemplateVersion		Escrever	MessageTemplate*
CreateQuickResponse	Concede permissão para criar uma resposta rápida	Escrever	KnowledgeBase*
CreateQuickResponse	Concede permissão para criar uma resposta rápida	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
CreateSession	Concede permissão para criar uma sessão	Escrever	Assistant*
CreateSession	Concede permissão para criar uma sessão	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
DeactivateMessageTemplate	Concede permissão para desativar um modelo de mensagem	Escrever	KnowledgeBase*
DeactivateMessageTemplate	Concede permissão para desativar um modelo de mensagem	Escrever	MessageTemplate*
DeleteAIAgent	Concede permissão para excluir um agente de IA	Escrever	AIAgent*
DeleteAIAgent	Concede permissão para excluir um agente de IA	Escrever	Assistant*
DeleteAIAgentVersion	Concede permissão para excluir uma versão do agente de IA	Escrever	AIAgent*
DeleteAIAgentVersion	Concede permissão para excluir uma versão do agente de IA	Escrever	Assistant*
DeleteAIGuardrail	Concede permissão para excluir uma grade de proteção aérea	Escrever	AIGuardrail*
DeleteAIGuardrail	Concede permissão para excluir uma grade de proteção aérea	Escrever	Assistant*
DeleteAIGuardrailVersion	Concede permissão para excluir uma versão do ai guardrail	Escrever	AIGuardrail*
DeleteAIGuardrailVersion	Concede permissão para excluir uma versão do ai guardrail	Escrever	Assistant*
DeleteAIPrompt	Concede permissão para excluir um prompt de IA	Escrever	AIPrompt*
DeleteAIPrompt	Concede permissão para excluir um prompt de IA	Escrever	Assistant*
DeleteAIPromptVersion	Concede permissão para excluir uma versão do prompt de IA	Escrever	AIPrompt*
DeleteAIPromptVersion	Concede permissão para excluir uma versão do prompt de IA	Escrever	Assistant*
DeleteAssistant	Concede permissão para excluir um assistente	Escrever	Assistant*
DeleteAssistantAssociation	Concede permissão para excluir uma associação de assistente	Escrever	Assistant*
DeleteAssistantAssociation	Concede permissão para excluir uma associação de assistente	Escrever	AssistantAssociation*
DeleteContent	Concede permissão para excluir conteúdo	Escrever	Content*
DeleteContent	Concede permissão para excluir conteúdo	Escrever	KnowledgeBase*
DeleteContentAssociation	Concede permissão para excluir uma associação de conteúdo	Escrever	Content*
			ContentAssociation*
			KnowledgeBase*
DeleteImportJob	Concede permissão para excluir um trabalho de importação de uma base de conhecimento	Escrever	KnowledgeBase*
DeleteKnowledgeBase	Concede permissão para excluir uma base de conhecimentos	Escrever	KnowledgeBase*
DeleteMessageTemplate	Concede permissão para excluir um modelo de mensagem	Escrever	KnowledgeBase*
DeleteMessageTemplate	Concede permissão para excluir um modelo de mensagem	Escrever	MessageTemplate*
DeleteMessageTemplateAttachment	Concede permissão para excluir um anexo de um modelo de mensagem	Escrever	KnowledgeBase*
DeleteMessageTemplateAttachment		Escrever	MessageTemplate*
DeleteQuickResponse	Concede permissão para excluir uma resposta rápida	Escrever	KnowledgeBase*
DeleteQuickResponse	Concede permissão para excluir uma resposta rápida	Escrever	QuickResponse*
GetAIAgent	Concede permissão para recuperar informações sobre um agente de IA	Leitura	AIAgent*
GetAIAgent		Leitura	Assistant*
GetAIGuardrail	Concede permissão para recuperar informações sobre uma grade de proteção aérea	Leitura	AIGuardrail*
GetAIGuardrail		Leitura	Assistant*
GetAIPrompt	Concede permissão para recuperar informações sobre um prompt de IA	Leitura	AIPrompt*
GetAIPrompt		Leitura	Assistant*
GetAssistant	Concede permissão para recuperar informações sobre um assistente	Leitura	Assistant*
GetAssistantAssociation	Concede permissão para recuperar informações sobre uma associação de assistente	Leitura	Assistant*
GetAssistantAssociation		Leitura	AssistantAssociation*
GetContent	Concede permissão para recuperar conteúdo, incluindo um pré-assinado URL para baixar o conteúdo	Leitura	Content*
GetContent		Leitura	KnowledgeBase*
GetContentAssociation	Concede permissão para recuperar informações sobre uma associação de conteúdos	Leitura	Content*
			ContentAssociation*
			KnowledgeBase*
GetContentSummary	Concede permissão para recuperar informações resumidas sobre o conteúdo	Leitura	Content*
GetContentSummary		Leitura	KnowledgeBase*
GetImportJob	Concede permissão para recuperar informações sobre o trabalho de importação	Leitura	KnowledgeBase*
GetKnowledgeBase	Concede permissão para recuperar informações sobre a base de conhecimentos	Leitura	KnowledgeBase*
GetMessageTemplate	Concede permissão para recuperar um modelo de mensagem	Leitura	KnowledgeBase*
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
GetNextMessage	Concede permissão para recuperar a próxima mensagem em uma sessão	Leitura	Assistant*
GetNextMessage		Leitura	Session*
GetQuickResponse	Concede permissão para recuperar conteúdo	Leitura	KnowledgeBase*
GetQuickResponse	Concede permissão para recuperar conteúdo	Leitura	QuickResponse*
GetRecommendations	Concede permissão para recuperar recomendações para a sessão especificada	Leitura	Assistant*
GetSession	Concede permissão para recuperar informações para uma sessão especificada	Leitura	Assistant*
GetSession		Leitura	Session*
ListAIAgentVersions	Concede permissão para listar informações sobre versões do agente de IA	Listar	AIAgent*
ListAIAgentVersions		Listar	Assistant*
ListAIAgents	Concede permissão para listar informações sobre agentes de IA	Listar	Assistant*
ListAIGuardrailVersions	Concede permissão para listar informações sobre as versões do ai guardrail	Listar	AIGuardrail*
ListAIGuardrailVersions		Listar	Assistant*
ListAIGuardrails	Concede permissão para listar informações sobre grades de proteção de IA	Listar	Assistant*
ListAIPromptVersions	Concede permissão para listar informações sobre versões de prompt de IA	Listar	AIPrompt*
ListAIPromptVersions		Listar	Assistant*
ListAIPrompts	Concede permissão para listar informações sobre prompts de IA	Listar	Assistant*
ListAssistantAssociations	Concede permissão para listar informações sobre associações de assistente	Listar	Assistant*
ListAssistants	Concede permissão para listar informações sobre assistentes	Listar
ListContentAssociations	Concede permissão para listar informações sobre associações de conteúdo	Listar	Content*
ListContentAssociations		Listar	KnowledgeBase*
ListContents	Concede permissão para listar o conteúdo com uma base de conhecimentos	Listar	KnowledgeBase*
ListImportJobs	Concede permissão para listar informações sobre bases de conhecimentos	Listar	KnowledgeBase*
ListKnowledgeBases	Concede permissão para listar informações sobre bases de conhecimentos	Listar
ListMessageTemplateVersions	Concede permissão para listar versões de modelos de mensagens para o modelo de mensagem especificado	Listar	KnowledgeBase*
ListMessageTemplateVersions		Listar	MessageTemplate*
ListMessageTemplates	Concede permissão para listar os modelos de mensagem de uma base de conhecimentos	Listar	KnowledgeBase*
ListMessages	Concede permissão para listar mensagens em uma sessão	Listar	Assistant*
ListMessages	Concede permissão para listar mensagens em uma sessão	Listar	Session*
ListQuickResponses	Concede permissão para listar a resposta rápida com uma base de conhecimento	Listar	KnowledgeBase*
ListTagsForResource	Concede permissão para listar as etiquetas para o recurso especificado	Leitura
NotifyRecommendationsReceived	Concede permissão para remover as recomendações especificadas da fila de recomendações recém-disponíveis do assistente especificado	Escrever	Assistant*
PutFeedback	Concede permissão para enviar um comentário	Escrever	Assistant*
QueryAssistant	Concede permissão para realizar uma pesquisa manual no assistente especificado	Leitura	Assistant*
RemoveAssistantAIAgent	Concede permissão para remover um agente de IA de um assistente	Escrever	Assistant*
RemoveKnowledgeBaseTemplateUri	Concede permissão para remover um URI modelo de uma base de conhecimento	Escrever	KnowledgeBase*
RenderMessageTemplate	Concede permissão para renderizar um modelo de mensagem	Leitura	KnowledgeBase*		wisdom:GetMessageTemplate
			MessageTemplate*
				wisdom:MessageTemplate/RoutingProfileArn
SearchContent	Concede permissão para pesquisar conteúdo que faz referência a uma base de conhecimentos especificada. Pode ser usado para obter um recurso específico pelo nome	Leitura	KnowledgeBase*
SearchMessageTemplates	Concede permissão para pesquisar modelos de mensagens que fazem referência a uma base de conhecimento especificada	Leitura	KnowledgeBase*
SearchMessageTemplates		Leitura		wisdom:SearchFilter/RoutingProfileArn wisdom:SearchFilter/Qualifier
SearchQuickResponses	Concede permissão para procurar uma resposta rápida que faz referência a uma base de conhecimento especificada	Leitura	KnowledgeBase*		wisdom:GetQuickResponse
SearchQuickResponses		Leitura		wisdom:SearchFilter/RoutingProfileArn
SearchSessions	Concede permissão para pesquisar sessões que fazem referência a um assistente especificado. Pode ser usado para obter um recurso de sessão específico pelo nome	Leitura	Assistant*
SendMessage	Concede permissão para enviar uma mensagem	Escrever	Assistant*
SendMessage	Concede permissão para enviar uma mensagem	Escrever	Session*
StartContentUpload	Concede permissão para URL fazer upload de conteúdo para uma base de conhecimento	Escrever	KnowledgeBase*
StartImportJob	Concede permissão para criar várias respostas rápidas	Escrever	KnowledgeBase*
StartImportJob	Concede permissão para criar várias respostas rápidas	Escrever		aws:TagKeys aws:RequestTag/${TagKey}
TagResource	Concede permissão para adicionar as etiquetas especificadas ao recurso especificado	Tags	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			MessageTemplate
			QuickResponse
			Session
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	Concede permissão para remover as etiquetas especificadas do recurso especificado	Tags	Assistant
			AssistantAssociation
			Content
			ContentAssociation
			KnowledgeBase
			MessageTemplate
			QuickResponse
			Session
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateAIAgent	Concede permissão para atualizar informações sobre um agente de IA	Escrever	AIAgent*
UpdateAIAgent		Escrever	Assistant*
UpdateAIGuardrail	Concede permissão para atualizar informações sobre uma grade de proteção aérea	Escrever	AIGuardrail*
UpdateAIGuardrail		Escrever	Assistant*
UpdateAIPrompt	Concede permissão para atualizar informações sobre um prompt de IA	Escrever	AIPrompt*
UpdateAIPrompt		Escrever	Assistant*
UpdateAssistantAIAgent	Concede permissão para atualizar informações do assistente sobre um agente de IA	Escrever	Assistant*
UpdateContent	Concede permissão para atualizar as informações sobre o conteúdo	Escrever	Content*
UpdateContent		Escrever	KnowledgeBase*
UpdateKnowledgeBaseTemplateUri	Concede permissão para atualizar o modelo URI de uma base de conhecimento	Escrever	KnowledgeBase*
UpdateMessageTemplate	Concede permissão para atualizar o conteúdo do modelo de mensagem	Escrever	KnowledgeBase*
UpdateMessageTemplate		Escrever	MessageTemplate*
UpdateMessageTemplateMetadata	Concede permissão para atualizar os metadados do modelo de mensagem	Escrever	KnowledgeBase*
UpdateMessageTemplateMetadata		Escrever	MessageTemplate*
UpdateQuickResponse	Concede permissão para atualizar informações ou conteúdo sobre a resposta rápida	Escrever	KnowledgeBase*
UpdateQuickResponse		Escrever	QuickResponse*
UpdateSession	Concede permissão para atualizar uma sessão	Escrever	Assistant*
UpdateSession	Concede permissão para atualizar uma sessão	Escrever	Session*
UpdateSessionData	Concede permissão para atualizar dados armazenados em uma sessão	Escrever	Assistant*
UpdateSessionData		Escrever	Session*

Tipos de recursos definidos pelo Amazon Q in Connect

Os tipos de recursos a seguir são definidos por esse serviço e podem ser usados no Resource elemento das declarações de política de IAM permissão. 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
AIAgent	`arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}`	aws:ResourceTag/${TagKey}
AIPrompt	`arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}`	aws:ResourceTag/${TagKey}
AIGuardrail	`arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}`	aws:ResourceTag/${TagKey}
Assistant	`arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}`	aws:ResourceTag/${TagKey}
AssistantAssociation	`arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}`	aws:ResourceTag/${TagKey}
Content	`arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}`	aws:ResourceTag/${TagKey}
ContentAssociation	`arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}`	aws:ResourceTag/${TagKey}
KnowledgeBase	`arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}`	aws:ResourceTag/${TagKey}
MessageTemplate	`arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}`	aws:ResourceTag/${TagKey} wisdom:MessageTemplate/RoutingProfileArn
Session	`arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}`	aws:ResourceTag/${TagKey}
QuickResponse	`arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}`	aws:ResourceTag/${TagKey}

Chaves de condição do Amazon Q in Connect

O Amazon Q in Connect define as seguintes chaves de condição que podem ser usadas no Condition elemento de uma IAM política. É 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 condição globais disponíveis.

Chaves de condição	Descrição	Tipo
aws:RequestTag/${TagKey}	Filtra o acesso pelas etiquetas que são transmitidas na solicitação	Segmento
aws:ResourceTag/${TagKey}	Filtra o acesso pelas etiquetas associadas ao recurso	Segmento
aws:TagKeys	Filtra o acesso pelas chaves da etiqueta que são transmitidas na solicitação	ArrayOfString
wisdom:MessageTemplate/RoutingProfileArn	Filtra o acesso pelos ARNs do perfil de roteamento de conexão associados ao recurso	ArrayOfARN
wisdom:SearchFilter/Qualifier	Filtra o acesso pelos qualificadores que são transmitidos na solicitação	ArrayOfString
wisdom:SearchFilter/RoutingProfileArn	Filtra o acesso pelo ARN do perfil do roteamento de conexão que é passado na solicitação	ARN

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Aplicações do Amazon Q Business Q

Amazon QLDB