Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Operazioni, risorse e chiavi di condizione per Amazon Q in Connect
Amazon Q in Connect (prefisso del servizio: wisdom) fornisce le seguenti operazioni, risorse, azioni e chiavi di condizione specifiche del servizio da utilizzare nelle politiche di autorizzazione IAM.
Riferimenti:
-
Scopri come configurare questo servizio.
-
Visualizza un elenco delle operazioni API disponibili per questo servizio.
-
Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.
-
Visualizza riferimento programmatico all'autorizzazione del servizio
per questo servizio.
Argomenti
Operazioni API definite da Amazon Q in Connect
La tabella seguente associa le operazioni API alle azioni IAM che autorizzano. Sono elencate solo le chiavi di condizione che hanno valori statici per l'API e l'azione specificate; per il set completo di chiavi di condizione supportate da ciascuna azione, consulta Tabella delle azioni.
| Operazione | Client SDK | Azione IAM | Chiave di condizione | Valori possibili | Livello di accesso |
|---|---|---|---|---|---|
|
ActivateMessageTemplate |
qconnect |
Scrittura |
|||
|
CreateAIAgent |
qconnect |
Scrittura |
|||
Etichettatura, scrittura |
|||||
|
CreateAIAgentVersion |
qconnect |
Scrittura |
|||
|
CreateAIGuardrail |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateAIGuardrailVersion |
qconnect |
Scrittura |
|||
|
CreateAIPrompt |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateAIPromptVersion |
qconnect |
Scrittura |
|||
|
CreateAssistant |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateAssistantAssociation |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Scrittura |
|||
|
CreateContent |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateContentAssociation |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateKnowledgeBase |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateMessageTemplate |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateMessageTemplateAttachment |
qconnect |
Scrittura |
|||
|
CreateMessageTemplateVersion |
qconnect |
Scrittura |
|||
|
CreateQuickResponse |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateSession |
qconnect |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
DeactivateMessageTemplate |
qconnect |
Scrittura |
|||
|
DeleteAIAgent |
qconnect |
Scrittura |
|||
|
DeleteAIAgentVersion |
qconnect |
Scrittura |
|||
|
DeleteAIGuardrail |
qconnect |
Scrittura |
|||
|
DeleteAIGuardrailVersion |
qconnect |
Scrittura |
|||
|
DeleteAIPrompt |
qconnect |
Scrittura |
|||
|
DeleteAIPromptVersion |
qconnect |
Scrittura |
|||
|
DeleteAssistant |
qconnect |
Scrittura |
|||
|
DeleteAssistantAssociation |
qconnect |
Scrittura |
|||
|
DeleteContent |
qconnect |
Scrittura |
|||
|
DeleteContentAssociation |
qconnect |
Scrittura |
|||
|
DeleteImportJob |
qconnect |
Scrittura |
|||
|
DeleteKnowledgeBase |
qconnect |
Scrittura |
|||
|
DeleteMessageTemplate |
qconnect |
Scrittura |
|||
|
DeleteMessageTemplateAttachment |
qconnect |
Scrittura |
|||
|
DeleteQuickResponse |
qconnect |
Scrittura |
|||
|
GetAIAgent |
qconnect |
Lettura |
|||
|
GetAIGuardrail |
qconnect |
Lettura |
|||
|
GetAIPrompt |
qconnect |
Lettura |
|||
|
GetAssistant |
qconnect |
Lettura |
|||
|
GetAssistantAssociation |
qconnect |
Lettura |
|||
|
GetContent |
qconnect |
Lettura |
|||
|
GetContentAssociation |
qconnect |
Lettura |
|||
|
GetContentSummary |
qconnect |
Lettura |
|||
|
GetImportJob |
qconnect |
Lettura |
|||
|
GetKnowledgeBase |
qconnect |
Lettura |
|||
|
GetMessageTemplate |
qconnect |
Lettura |
|||
|
GetNextMessage |
qconnect |
Lettura |
|||
|
GetQuickResponse |
qconnect |
Lettura |
|||
|
GetRecommendations |
qconnect |
Lettura |
|||
|
GetSession |
qconnect |
Lettura |
|||
|
ListAIAgentVersions |
qconnect |
List |
|||
|
ListAIAgents |
qconnect |
List |
|||
|
ListAIGuardrailVersions |
qconnect |
List |
|||
|
ListAIGuardrails |
qconnect |
List |
|||
|
ListAIPromptVersions |
qconnect |
List |
|||
|
ListAIPrompts |
qconnect |
List |
|||
|
ListAssistantAssociations |
qconnect |
List |
|||
|
ListAssistants |
qconnect |
List |
|||
|
ListContentAssociations |
qconnect |
List |
|||
|
ListContents |
qconnect |
List |
|||
|
ListImportJobs |
qconnect |
List |
|||
|
ListKnowledgeBases |
qconnect |
List |
|||
|
ListMessageTemplateVersions |
qconnect |
List |
|||
|
ListMessageTemplates |
qconnect |
List |
|||
|
ListMessages |
qconnect |
List |
|||
|
ListModels |
qconnect |
List |
|||
|
ListQuickResponses |
qconnect |
List |
|||
|
ListSpans |
qconnect |
List |
|||
|
ListTagsForResource |
qconnect |
Lettura |
|||
|
NotifyRecommendationsReceived |
qconnect |
Scrittura |
|||
|
PutFeedback |
qconnect |
Scrittura |
|||
|
QueryAssistant |
qconnect |
Lettura |
|||
|
RemoveAssistantAIAgent |
qconnect |
Scrittura |
|||
|
RemoveKnowledgeBaseTemplateUri |
qconnect |
Scrittura |
|||
|
RenderMessageTemplate |
qconnect |
Lettura |
|||
Lettura |
|||||
|
Retrieve |
qconnect |
Lettura |
|||
|
SearchContent |
qconnect |
Lettura |
|||
|
SearchMessageTemplates |
qconnect |
Lettura |
|||
|
SearchQuickResponses |
qconnect |
Lettura |
|||
Lettura |
|||||
|
SearchSessions |
qconnect |
Lettura |
|||
|
SendMessage |
qconnect |
Scrittura |
|||
|
StartContentUpload |
qconnect |
Scrittura |
|||
|
StartImportJob |
qconnect |
Scrittura |
|||
|
TagResource |
qconnect |
Etichettare, scrivere |
|||
|
UntagResource |
qconnect |
Etichettare, scrivere |
|||
|
UpdateAIAgent |
qconnect |
Scrittura |
|||
|
UpdateAIGuardrail |
qconnect |
Scrittura |
|||
|
UpdateAIPrompt |
qconnect |
Scrittura |
|||
|
UpdateAssistantAIAgent |
qconnect |
Scrittura |
|||
|
UpdateContent |
qconnect |
Scrittura |
|||
|
UpdateKnowledgeBaseTemplateUri |
qconnect |
Scrittura |
|||
|
UpdateMessageTemplate |
qconnect |
Scrittura |
|||
|
UpdateMessageTemplateMetadata |
qconnect |
Scrittura |
|||
|
UpdateQuickResponse |
qconnect |
Scrittura |
|||
|
UpdateSession |
qconnect |
Scrittura |
|||
|
UpdateSessionData |
qconnect |
Scrittura |
|||
|
CreateAssistant |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateAssistantAssociation |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
iam:PassedToService |
wisdom.amazonaws.com |
Scrittura |
|||
|
CreateContent |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateKnowledgeBase |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateQuickResponse |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
CreateSession |
wisdom |
Scrittura |
|||
Etichettare, scrivere |
|||||
|
DeleteAssistant |
wisdom |
Scrittura |
|||
|
DeleteAssistantAssociation |
wisdom |
Scrittura |
|||
|
DeleteContent |
wisdom |
Scrittura |
|||
|
DeleteImportJob |
wisdom |
Scrittura |
|||
|
DeleteKnowledgeBase |
wisdom |
Scrittura |
|||
|
DeleteQuickResponse |
wisdom |
Scrittura |
|||
|
GetAssistant |
wisdom |
Lettura |
|||
|
GetAssistantAssociation |
wisdom |
Lettura |
|||
|
GetContent |
wisdom |
Lettura |
|||
|
GetContentSummary |
wisdom |
Lettura |
|||
|
GetImportJob |
wisdom |
Lettura |
|||
|
GetKnowledgeBase |
wisdom |
Lettura |
|||
|
GetQuickResponse |
wisdom |
Lettura |
|||
|
GetRecommendations |
wisdom |
Lettura |
|||
|
GetSession |
wisdom |
Lettura |
|||
|
ListAssistantAssociations |
wisdom |
List |
|||
|
ListAssistants |
wisdom |
List |
|||
|
ListContents |
wisdom |
List |
|||
|
ListImportJobs |
wisdom |
List |
|||
|
ListKnowledgeBases |
wisdom |
List |
|||
|
ListQuickResponses |
wisdom |
List |
|||
|
ListTagsForResource |
wisdom |
Lettura |
|||
|
NotifyRecommendationsReceived |
wisdom |
Scrittura |
|||
|
QueryAssistant |
wisdom |
Lettura |
|||
|
RemoveKnowledgeBaseTemplateUri |
wisdom |
Scrittura |
|||
|
SearchContent |
wisdom |
Lettura |
|||
|
SearchQuickResponses |
wisdom |
Lettura |
|||
Lettura |
|||||
|
SearchSessions |
wisdom |
Lettura |
|||
|
StartContentUpload |
wisdom |
Scrittura |
|||
|
StartImportJob |
wisdom |
Scrittura |
|||
|
TagResource |
wisdom |
Etichettare, scrivere |
|||
|
UntagResource |
wisdom |
Etichettare, scrivere |
|||
|
UpdateContent |
wisdom |
Scrittura |
|||
|
UpdateKnowledgeBaseTemplateUri |
wisdom |
Scrittura |
|||
|
UpdateQuickResponse |
wisdom |
Scrittura |
Operazioni definite da Amazon Q in Connect
Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Per ogni azione, la tabella elenca i tipi di risorse e le chiavi di condizione supportate da tale azione. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.
| Operazioni | Description | Tipi di risorsa (*obbligatorio) | Chiavi di condizione | Livello di accesso |
|---|---|---|---|---|
Concede l'autorizzazione per attivare un modello di messaggio |
Scrittura |
|||
Concede il permesso di creare un agente ai |
Scrittura |
|||
Concede il permesso di creare una versione dell'agente ai |
Scrittura |
|||
Concede il permesso di creare un guardrail ai |
Scrittura |
|||
Concede il permesso di creare una versione del guardrail ai |
Scrittura |
|||
Concede il permesso di creare un prompt ai |
Scrittura |
|||
Concede il permesso di creare una versione del prompt ai |
Scrittura |
|||
Concede l'autorizzazione per creare un assistente |
Scrittura |
|||
Concede l'autorizzazione per creare un'associazione tra un assistente e un'altra risorsa |
Scrittura |
|||
Concede l'autorizzazione per creare un contenuto |
Scrittura |
|||
Concede il permesso di creare un'associazione di contenuti |
Scrittura |
|||
Concede l'autorizzazione per creare una knowledge base |
Scrittura |
|||
Concede l'autorizzazione a creare un modello di messaggio |
Scrittura |
|||
Concede l'autorizzazione a creare un allegato a un modello di messaggio |
Scrittura |
|||
Concede l'autorizzazione a creare una versione di un modello di messaggio |
Scrittura |
|||
Concede l'autorizzazione per creare una risposta veloce |
Scrittura |
|||
Concede l'autorizzazione per creare una sessione |
Scrittura |
|||
Concede l'autorizzazione a disattivare un modello di messaggio |
Scrittura |
|||
Concede il permesso di eliminare un agente ai |
Scrittura |
|||
Concede il permesso di eliminare una versione dell'agente ai |
Scrittura |
|||
Concede il permesso di eliminare un guardrail ai |
Scrittura |
|||
Concede il permesso di eliminare una versione del guardrail ai |
Scrittura |
|||
Concede il permesso di eliminare un prompt ai |
Scrittura |
|||
Concede il permesso di eliminare una versione del prompt ai |
Scrittura |
|||
Concede l'autorizzazione per eliminare un assistente |
Scrittura |
|||
Concede l'autorizzazione per eliminare un'associazione assistente |
Scrittura |
|||
Concede l'autorizzazione per eliminare un contenuto |
Scrittura |
|||
Concede il permesso di eliminare un'associazione di contenuti |
Scrittura |
|||
Concede l'autorizzazione per eliminare un processo di importazione di una knowledge base |
Scrittura |
|||
Concede l'autorizzazione per eliminare una knowledge base |
Scrittura |
|||
Concede il permesso di eliminare un modello di messaggio |
Scrittura |
|||
Concede il permesso di eliminare un allegato da un modello di messaggio |
Scrittura |
|||
Concede l'autorizzazione per eliminare una risposta veloce |
Scrittura |
|||
Concede il permesso di recuperare informazioni su un agente ai |
Lettura |
|||
Concede il permesso di recuperare informazioni su un guardrail aereo |
Lettura |
|||
Concede il permesso di recuperare informazioni su un prompt ai |
Lettura |
|||
Concede l'autorizzazione per richiamare le informazioni su un assistente |
Lettura |
|||
Concede l'autorizzazione per recuperare informazioni su un'associazione assistente |
Lettura |
|||
Concede l'autorizzazione per recuperare il contenuto, incluso un URL prefirmato per scaricare il contenuto |
Lettura |
|||
Concede il permesso di recuperare informazioni su un'associazione di contenuti |
Lettura |
|||
Concede l'autorizzazione per richiamare le informazioni di riepilogo sul contenuto |
Lettura |
|||
Concede l'autorizzazione per recuperare informazioni su un processo di importazione |
Lettura |
|||
Concede l'autorizzazione per recuperare informazioni sulla knowledge base |
Lettura |
|||
Concede il permesso di recuperare un modello di messaggio |
Lettura |
|||
Concede il permesso di recuperare il messaggio successivo in una sessione |
Lettura |
|||
Concede l'autorizzazione per recuperare un contenuto |
Lettura |
|||
Concede l'autorizzazione per recuperare i suggerimenti per la sessione specificata |
Lettura |
|||
Concede l'autorizzazione per richiamare le informazioni per una sessione specificata |
Lettura |
|||
Concede il permesso di elencare informazioni sulle versioni dell'agente ai |
List |
|||
Concede il permesso di elencare informazioni sugli agenti ai |
List |
|||
Concede il permesso di elencare informazioni sulle versioni di ai guardrail |
List |
|||
Concede il permesso di elencare informazioni su ai guardrail |
List |
|||
Concede il permesso di elencare informazioni sulle versioni di ai prompt |
List |
|||
Concede il permesso di elencare informazioni sui prompt ai |
List |
|||
Concede l'autorizzazione per elencare le informazioni sulle associazioni assistenti |
List |
|||
Concede l'autorizzazione per elencare le informazioni sugli assistenti |
List |
|||
Concede il permesso di elencare informazioni sulle associazioni di contenuti |
List |
|||
Concede l'autorizzazione per elencare i contenuti con una knowledge base |
List |
|||
Concede l'autorizzazione per elencare le informazioni sulle knowledge base |
List |
|||
Concede l'autorizzazione per elencare le informazioni sulle knowledge base |
List |
|||
Concede l'autorizzazione a elencare le versioni del modello di messaggio per il modello di messaggio specificato |
List |
|||
Concede l'autorizzazione a elencare i modelli di messaggio per una knowledge base |
List |
|||
Concede il permesso di elencare i messaggi in una sessione |
List |
|||
Concede il permesso di elencare i modelli disponibili per un assistente |
List |
|||
Concede l'autorizzazione per elencare la risposta veloce con una knowledge base |
List |
|||
Concede il permesso di elencare le tracce degli agenti AI per una sessione |
List |
|||
Concede l'autorizzazione per elencare i tag per la risorsa specificata |
Lettura |
|||
Concede l'autorizzazione per rimuovere i suggerimenti specificati dalla coda dei nuovi suggerimenti disponibili dell'assistente specificato |
Scrittura |
|||
Concede l'autorizzazione per inviare feedback |
Scrittura |
|||
Concede l'autorizzazione per eseguire una ricerca manuale rispetto all'assistente specificato |
Lettura |
|||
Concede il permesso di registrare una chiave KMS di replica per un assistente |
Scrittura |
|||
Concede il permesso di registrare una chiave KMS di replica per una knowledge base |
Scrittura |
|||
Concede il permesso di rimuovere un agente ai da un assistente |
Scrittura |
|||
Concede l'autorizzazione per rimuovere un modello URI da una knowledge base |
Scrittura |
|||
Concede il permesso di visualizzare un modello di messaggio |
Lettura |
|||
Concede l'autorizzazione a recuperare contenuti informativi da associazioni di assistenti specificate |
Lettura |
|||
Concede l'autorizzazione per ricercare contenuti che fanno riferimento a una knowledge base specificata. Può essere utilizzato per ottenere una risorsa di contenuto specifica in base al suo nome |
Lettura |
|||
Concede l'autorizzazione a cercare modelli di messaggio che fanno riferimento a una knowledge base specificata |
Lettura |
|||
Concede l'autorizzazione per ricercare risposte veloci che fanno riferimento a una knowledge base specificata. |
Lettura |
|||
Concede l'autorizzazione per ricercare le sessioni che fanno riferimento a un assistente specificato. Può essere utilizzato per ottenere una risorsa di sessione specifica in base al suo nome |
Lettura |
|||
Concede il permesso di inviare un messaggio |
Scrittura |
|||
Concede l'autorizzazione per ottenere un URL per caricare i contenuti in una knowledge base |
Scrittura |
|||
Concede l'autorizzazione per creare più risposte veloci |
Scrittura |
|||
Concede l'autorizzazione per aggiungere i tag specificati alla risorsa specificata |
Etichettatura, scrittura |
|||
Concede l'autorizzazione per rimuovere i tag specificati dalla risorsa specificata |
Etichettare, scrivere |
|||
Concede il permesso di aggiornare le informazioni su un agente di intelligenza artificiale |
Scrittura |
|||
Concede il permesso di aggiornare le informazioni su un guardrail ai |
Scrittura |
|||
Concede il permesso di aggiornare le informazioni su un prompt ai |
Scrittura |
|||
Concede il permesso di aggiornare le informazioni dell'assistente su un agente ai |
Scrittura |
|||
Concede l'autorizzazione per ottenere le informazioni sul contenuto |
Scrittura |
|||
Concede l'autorizzazione per aggiornare l'URI del modello di una knowledge base |
Scrittura |
|||
Concede il permesso di aggiornare il contenuto del modello di messaggio |
Scrittura |
|||
Concede il permesso di aggiornare i metadati del modello di messaggio |
Scrittura |
|||
Concede l'autorizzazione per aggiornare le informazioni o il contenuto della risposta veloce |
Scrittura |
|||
Concede il permesso di aggiornare una sessione |
Scrittura |
|||
Concede il permesso di aggiornare i dati memorizzati in una sessione |
Scrittura |
Permission-only azioni per Amazon Q in Connect
Le seguenti azioni sono definite da Amazon Q in Connect ma non sono direttamente richiamabili tramite alcuna operazione API. Possono essere utilizzate solo nelle dichiarazioni delle politiche IAM per concedere o negare le autorizzazioni.
| Operazioni | Description | Tipi di risorsa (*obbligatorio) | Chiavi di condizione | Livello di accesso |
|---|---|---|---|---|
Concede il permesso di configurare la distribuzione dei log venduti per un assistente |
Gestione delle autorizzazioni, scrittura |
Tipi di risorsa definiti da Amazon Q in Connect
I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM.
| Tipi di risorse | ARN | Chiavi di condizione |
|---|---|---|
arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId} |
||
arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId} |
Chiavi di condizione per Amazon Q in Connect
Amazon Q in Connect definisce le seguenti chiavi di condizione che possono essere utilizzate nell'elemento Condition di una policy IAM.
| Chiavi di condizione | Descrizione | Tipo |
|---|---|---|
Filtra l'accesso per i tag passati nella richiesta |
String |
|
Filtra l'accesso per i tag associati alla risorsa |
String |
|
Filtra l'accesso tramite le chiavi di tag passate nella richiesta |
ArrayOfString |
|
Filtra l'accesso tramite gli avvisi del profilo di routing di connessione associati alla risorsa |
ArrayOfARN |
|
Filtra l'accesso in base ai qualificatori trasmessi nella richiesta |
ArrayOfString |
|
Filtra l'accesso in base all'arn del profilo di routing della connessione passato nella richiesta |
ARN |