Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Q in Connect
Amazon Q in Connect (Servicepräfix: wisdom
) stellt die folgenden servicespezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel für die Verwendung in IAM-Berechtigungsrichtlinien bereit.
Referenzen:
-
Erfahren Sie, wie Sie diesen Service konfigurieren.
-
Zeigen Sie eine Liste der API-Produktionen an, die für diesen Service verfügbar sind.
-
Erfahren Sie, wie Sie diesen Service und seine Ressourcen mithilfe von IAM-Berechtigungsrichtlinien schützen.
Themen
Von Amazon Q in Connect definierte Aktionen
Sie können die folgenden Aktionen im Element Action
einer IAM-Richtlinienanweisung angeben. Verwenden Sie Richtlinien, um Berechtigungen zum Ausführen einer Operation in AWS zu erteilen. Wenn Sie eine Aktion in einer Richtlinie verwenden, erlauben oder verweigern Sie in der Regel den Zugriff auf die API-Operation oder den CLI-Befehl mit demselben Namen. Dabei kann es mitunter vorkommen, dass eine einzige Aktion den Zugriff auf mehr als eine Operation steuert. Alternativ erfordern einige Vorgänge mehrere verschiedene Aktionen.
Die Spalte Resource types (Ressourcentypen) der Aktionstabelle gibt an, ob die Aktion Berechtigungen auf Ressourcenebene unterstützt. Wenn es keinen Wert für diese Spalte gibt, müssen Sie alle Ressourcen ("*") im Element Resource
Ihrer Richtlinienanweisung angeben. Wenn die Spalte einen Ressourcentyp enthält, können Sie einen ARN dieses Typs in einer Anweisung mit dieser Aktion angeben. Wenn für die Aktion eine oder mehrere Ressourcen erforderlich sind, muss der Aufrufer die Erlaubnis haben, die Aktion mit diesen Ressourcen zu verwenden. Erforderliche Ressourcen sind in der Tabelle mit einem Sternchen (*) gekennzeichnet. Wenn Sie den Ressourcenzugriff mit dem Element Resource
in einer IAM-Richtlinie einschränken, müssen Sie für jeden erforderlichen Ressourcentyp einen ARN oder ein Muster angeben. Einige Aktionen unterstützen mehrere Ressourcentypen. Wenn der Ressourcentyp optional ist (nicht als erforderlich angegeben), können Sie sich für einen der optionalen Ressourcentypen entscheiden.
Die Spalte Bedingungsschlüssel der Tabelle der Aktionen enthält Schlüssel, die Sie im Element Condition
einer Richtlinienanweisung angeben können. Weitere Informationen zu den Bedingungsschlüsseln, die den Ressourcen für den Service zugeordnet sind, finden Sie in der Spalte Bedingungsschlüssel der Tabelle der Ressourcentypen.
Anmerkung
Die Ressourcenbedingungsschlüssel sind in der Tabelle Ressourcentypen enthalten. Sie finden einen Link zu dem Ressourcentyp, der für eine Aktion gilt, in der Spalte Ressourcentypen (*erforderlich) der Tabelle „Aktionen“. Der Ressourcentyp in der Tabelle „Ressourcentypen“ enthält die Spalte Bedingungsschlüssel. Das sind die Ressourcenbedingungsschlüssel, die für eine Aktion in der Tabelle „Aktionen“ gelten.
Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Aktionen
Aktionen | Beschreibung | Zugriffsebene | Ressourcentypen (*erforderlich) | Bedingungsschlüssel | Abhängige Aktionen |
---|---|---|---|---|---|
ActivateMessageTemplate | Erteilt die Erlaubnis, eine Nachrichtenvorlage zu aktivieren | Schreiben | |||
AllowVendedLogDeliveryForResource [nur Berechtigung] | Erteilt einem Assistenten die Erlaubnis, den Versand von Versandprotokollen zu konfigurieren | Berechtigungsverwaltung | |||
CreateAIAgent | Erteilt die Erlaubnis, einen AI-Agenten zu erstellen | Schreiben | |||
CreateAIAgentVersion | Erteilt die Erlaubnis, eine AI-Agent-Version zu erstellen | Schreiben | |||
CreateAIGuardrail | Erteilt die Erlaubnis, eine AI-Leitplanke zu erstellen | Schreiben | |||
CreateAIGuardrailVersion | Erteilt die Erlaubnis, eine AI-Guardrail-Version zu erstellen | Schreiben | |||
CreateAIPrompt | Erteilt die Erlaubnis, eine AI-Aufforderung zu erstellen | Schreiben | |||
CreateAIPromptVersion | Erteilt die Erlaubnis, eine AI-Prompt-Version zu erstellen | Schreiben | |||
CreateAssistant | Gewährt die Berechtigung zum Erstellen eines Assistenten | Schreiben | |||
CreateAssistantAssociation | Gewährt die Berechtigung zum Erstellen einer Verknüpfung zwischen einem Assistenten und einer anderen Ressource | Schreiben | |||
CreateContent | Gewährt die Berechtigung zum Erstellen von Inhalten | Schreiben | |||
CreateContentAssociation | Erteilt die Berechtigung zum Erstellen einer Inhaltsverknüpfung | Schreiben | |||
CreateKnowledgeBase | Gewährt die Berechtigung zum Erstellen einer Wissensdatenbank | Schreiben | |||
CreateMessageTemplate | Erteilt die Berechtigung zum Erstellen einer Nachrichtenvorlage | Schreiben | |||
CreateMessageTemplateAttachment | Erteilt die Berechtigung, einen Anhang zu einer Nachrichtenvorlage zu erstellen | Schreiben | |||
CreateMessageTemplateVersion | Erteilt die Berechtigung, eine Version einer Nachrichtenvorlage zu erstellen | Schreiben | |||
CreateQuickResponse | Gewährt die Berechtigung zum Erstellen einer schnellen Reaktion | Schreiben | |||
CreateSession | Gewährt die Berechtigung zum Erstellen einer neuen Sitzung | Schreiben | |||
DeactivateMessageTemplate | Erteilt die Berechtigung zum Deaktivieren einer Nachrichtenvorlage | Schreiben | |||
DeleteAIAgent | Erteilt die Erlaubnis, einen AI-Agenten zu löschen | Schreiben | |||
DeleteAIAgentVersion | Erteilt die Berechtigung zum Löschen einer AI-Agent-Version | Schreiben | |||
DeleteAIGuardrail | Erteilt die Erlaubnis zum Löschen einer AI-Leitplanke | Schreiben | |||
DeleteAIGuardrailVersion | Erteilt die Erlaubnis, eine AI-Guardrail-Version zu löschen | Schreiben | |||
DeleteAIPrompt | Erteilt die Erlaubnis, eine AI-Aufforderung zu löschen | Schreiben | |||
DeleteAIPromptVersion | Erteilt die Erlaubnis, eine AI-Prompt-Version zu löschen | Schreiben | |||
DeleteAssistant | Gewährt die Berechtigung zum Löschen eines Assistenten | Schreiben | |||
DeleteAssistantAssociation | Gewährt die Berechtigung zum Löschen einer Assistentenverbindung | Schreiben | |||
DeleteContent | Gewährt die Berechtigung zum Löschen von Inhalten | Schreiben | |||
DeleteContentAssociation | Erteilt die Berechtigung zum Löschen einer Inhaltsverknüpfung | Schreiben | |||
DeleteImportJob | Gewährt die Berechtigung zum Löschen eines Importauftrags einer Wissensdatenbank | Schreiben | |||
DeleteKnowledgeBase | Gewährt die Berechtigung zum Löschen einer Wissensdatenbank | Schreiben | |||
DeleteMessageTemplate | Erteilt die Berechtigung zum Löschen einer Nachrichtenvorlage | Schreiben | |||
DeleteMessageTemplateAttachment | Erteilt die Berechtigung zum Löschen eines Anhangs aus einer Nachrichtenvorlage | Schreiben | |||
DeleteQuickResponse | Gewährt die Berechtigung zum Löschen einer schnellen Reaktion | Schreiben | |||
GetAIAgent | Erteilt die Berechtigung zum Abrufen von Informationen über einen AI-Agenten | Lesen | |||
GetAIGuardrail | Erteilt die Erlaubnis, Informationen über eine KI-Leitplanke abzurufen | Lesen | |||
GetAIPrompt | Erteilt die Erlaubnis, Informationen über eine AI-Aufforderung abzurufen | Lesen | |||
GetAssistant | Gewährt die Berechtigung zum Abrufen von Informationen über einen Assistenten | Lesen | |||
GetAssistantAssociation | Gewährt die Berechtigung zum Abrufen von Informationen über eine Assistentenverbindung | Lesen | |||
GetContent | Gewährt die Berechtigung zum Abrufen von Inhalten, einschließlich einer vorsignierten URL zum Herunterladen des Inhalts | Lesen | |||
GetContentAssociation | Erteilt die Berechtigung zum Abrufen von Informationen über eine Inhaltsverknüpfung | Lesen | |||
GetContentSummary | Gewährt die Berechtigung zum Abrufen von zusammenfassenden Informationen über die Inhalte | Lesen | |||
GetImportJob | Gewährt die Berechtigung zum Abrufen von Informationen zu einem Importauftrag | Lesen | |||
GetKnowledgeBase | Gewährt die Berechtigung zum Abrufen von Informationen über die Wissensdatenbank | Lesen | |||
GetMessageTemplate | Erteilt die Berechtigung zum Abrufen einer Nachrichtenvorlage | Lesen | |||
GetNextMessage | Erteilt die Berechtigung zum Abrufen der nächsten Nachricht in einer Sitzung | Lesen | |||
GetQuickResponse | Gewährt die Berechtigung zum Abrufen von Inhalten | Lesen | |||
GetRecommendations | Gewährt die Berechtigung zum Abrufen von Empfehlungen für die angegebene Sitzung | Lesen | |||
GetSession | Gewährt die Berechtigung zum Abrufen von Informationen für eine angegebene Sitzung | Lesen | |||
ListAIAgentVersions | Erteilt die Berechtigung, Informationen über AI-Agent-Versionen aufzulisten | Auflisten | |||
ListAIAgents | Erteilt die Erlaubnis, Informationen über AI-Agenten aufzulisten | Auflisten | |||
ListAIGuardrailVersions | Erteilt die Erlaubnis, Informationen über AI-Guardrail-Versionen aufzulisten | Auflisten | |||
ListAIGuardrails | Erteilt die Erlaubnis, Informationen über AI-Guardrails aufzulisten | Auflisten | |||
ListAIPromptVersions | Erteilt die Erlaubnis, Informationen über AI-Prompt-Versionen aufzulisten | Auflisten | |||
ListAIPrompts | Erteilt die Erlaubnis, Informationen über AI-Eingabeaufforderungen aufzulisten | Auflisten | |||
ListAssistantAssociations | Gewährt die Berechtigung zum Auflisten von Informationen über Assistentenverbindungen | Auflisten | |||
ListAssistants | Gewährt die Berechtigung zum Auflisten von Informationen über Assistenten | Auflisten | |||
ListContentAssociations | Erteilt die Berechtigung, Informationen über Inhaltsverknüpfungen aufzulisten | Auflisten | |||
ListContents | Gewährt die Berechtigung zum Auflisten der Inhalte in einer Wissensdatenbank | Auflisten | |||
ListImportJobs | Gewährt die Berechtigung zum Auflisten von Informationen über Wissensdatenbanken | Auflisten | |||
ListKnowledgeBases | Gewährt die Berechtigung zum Auflisten von Informationen über Wissensdatenbanken | Auflisten | |||
ListMessageTemplateVersions | Erteilt die Berechtigung, Nachrichtenvorlagenversionen für die angegebene Nachrichtenvorlage aufzulisten | Auflisten | |||
ListMessageTemplates | Erteilt die Berechtigung, die Nachrichtenvorlagen für eine Wissensdatenbank aufzulisten | Auflisten | |||
ListMessages | Erteilt die Berechtigung, Nachrichten in einer Sitzung aufzulisten | Auflisten | |||
ListQuickResponses | Gewährt die Berechtigung zum Auflisten der schnellen Reaktion mit einer Wissensdatenbank | Auflisten | |||
ListTagsForResource | Gewährt die Berechtigung zum Auflisten der Tags für die angegebene Ressource | Lesen | |||
NotifyRecommendationsReceived | Gewährt die Berechtigung zum Entfernen der angegebenen Empfehlungen aus der Warteschlange der neu verfügbaren Empfehlungen des angegebenen Assistenten | Schreiben | |||
PutFeedback | Gewährt die Berechtigung zum Senden von Feedback | Schreiben | |||
QueryAssistant | Gewährt die Berechtigung zum Durchführen einer manuellen Suche nach dem angegebenen Assistenten | Lesen | |||
RemoveAssistantAIAgent | Erteilt die Berechtigung, einen AI-Agenten aus einem Assistenten zu entfernen | Schreiben | |||
RemoveKnowledgeBaseTemplateUri | Gewährt die Berechtigung zum Entfernen einer URI-Vorlage aus einer Wissensdatenbank | Schreiben | |||
RenderMessageTemplate | Erteilt die Berechtigung zum Rendern einer Nachrichtenvorlage | Lesen |
wisdom:GetMessageTemplate |
||
SearchContent | Gewährt die Berechtigung zum Suchen nach Inhalten, die auf eine bestimmte Wissensdatenbank verweisen. Kann verwendet werden, um eine bestimmte Inhaltsressource nach ihrem Namen zu finden | Lesen | |||
SearchMessageTemplates | Erteilt die Berechtigung, nach Nachrichtenvorlagen zu suchen, die auf eine angegebene Wissensdatenbank verweisen | Lesen | |||
SearchQuickResponses | Gewährt die Berechtigung zum Suchen nach schnellen Reaktionen, die auf eine bestimmte Wissensdatenbank verweisen | Lesen |
wisdom:GetQuickResponse |
||
SearchSessions | Gewährt die Berechtigung zum Suchen nach Sitzungen, die auf einen bestimmten Assistenten verweisen. Kann verwendet werden, um eine bestimmte Sitzungsressource nach ihrem Namen zu finden | Lesen | |||
SendMessage | Erteilt die Berechtigung zum Senden einer Nachricht | Schreiben | |||
StartContentUpload | Gewährt die Berechtigung zum Abrufen einer URL zum Hochladen von Inhalten in eine Wissensdatenbank | Schreiben | |||
StartImportJob | Gewährt die Berechtigung zum Erstellen mehrerer schneller Reaktionen | Schreiben | |||
TagResource | Gewährt die Berechtigung zum Hinzufügen der angegebenen Tags zur angegebenen Ressource | Tagging | |||
UntagResource | Gewährt die Berechtigung zum Entfernen der angegebenen Tags aus der angegebenen Ressource | Tagging | |||
UpdateAIAgent | Erteilt die Erlaubnis, Informationen über einen AI-Agenten zu aktualisieren | Schreiben | |||
UpdateAIGuardrail | Erteilt die Erlaubnis, Informationen über eine KI-Leitplanke zu aktualisieren | Schreiben | |||
UpdateAIPrompt | Erteilt die Erlaubnis, Informationen über eine AI-Aufforderung zu aktualisieren | Schreiben | |||
UpdateAssistantAIAgent | Erteilt die Berechtigung, Assistenteninformationen über einen AI-Agenten zu aktualisieren | Schreiben | |||
UpdateContent | Gewährt die Berechtigung zum Aktualisieren von Informationen über die Inhalte | Schreiben | |||
UpdateKnowledgeBaseTemplateUri | Gewährt die Berechtigung zum Aktualisieren einer URI-Vorlage einer Wissensdatenbank | Schreiben | |||
UpdateMessageTemplate | Erteilt die Berechtigung, den Inhalt der Nachrichtenvorlage zu aktualisieren | Schreiben | |||
UpdateMessageTemplateMetadata | Erteilt die Berechtigung zum Aktualisieren der Metadaten der Nachrichtenvorlage | Schreiben | |||
UpdateQuickResponse | Gewährt die Berechtigung zum Aktualisieren von Informationen oder Inhalten einer schnellen Reaktion | Schreiben | |||
UpdateSession | Erteilt die Berechtigung zum Aktualisieren einer Sitzung | Schreiben | |||
UpdateSessionData | Erteilt die Erlaubnis, in einer Sitzung gespeicherte Daten zu aktualisieren | Schreiben | |||
Von Amazon Q in Connect definierte Ressourcentypen
Die folgenden Ressourcentypen werden von diesem Service definiert und können im Element Resource
von IAM-Berechtigungsrichtlinienanweisungen verwendet werden. Jede Aktion in der Tabelle Aktionen identifiziert die Ressourcentypen, die mit der Aktion angegeben werden können. Ein Ressourcentyp kann auch definieren, welche Bedingungsschlüssel Sie in einer Richtlinie einschließen können. Diese Schlüssel werden in der letzten Spalte der Tabelle der Ressourcentypen angezeigt. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Resource types.
Ressourcentypen | ARN | Bedingungsschlüssel |
---|---|---|
AIAgent |
arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}
|
|
AIPrompt |
arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}
|
|
AIGuardrail |
arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}
|
|
Assistant |
arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}
|
|
AssistantAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}
|
|
Content |
arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}
|
|
ContentAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}
|
|
KnowledgeBase |
arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}
|
|
MessageTemplate |
arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}
|
|
Session |
arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}
|
|
QuickResponse |
arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}
|
Bedingungsschlüssel für Amazon Q in Connect
Amazon Q in Connect definiert die folgenden Bedingungsschlüssel, die im Element Condition
einer IAM-Richtlinie verwendet werden können. Diese Schlüssel können Sie verwenden, um die Bedingungen zu verfeinern, unter denen die Richtlinienanweisung angewendet wird. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Condition keys (Bedingungsschlüssel).
Eine Liste der globalen Bedingungsschlüssel, die für alle Services verfügbar sind, finden Sie unter Verfügbare globale Bedingungsschlüssel.
Bedingungsschlüssel | Beschreibung | Typ |
---|---|---|
aws:RequestTag/${TagKey} | Filtert den Zugriff durch die Tags, die in der Anfrage übergeben werden | Zeichenfolge |
aws:ResourceTag/${TagKey} | Filtert den Zugriff basierend auf den Tags, die der Ressource zugeordnet sind. | Zeichenfolge |
aws:TagKeys | Filtert den Zugriff basierend auf den Tag-Schlüssel, die in der Anfrage übergeben werden | ArrayOfString |
wisdom:MessageTemplate/RoutingProfileArn | Filtert den Zugriff nach den ARNS des Connect-Routing-Profils, die der Ressource zugeordnet sind | ArrayOfARN |
wisdom:SearchFilter/Qualifier | Filtert den Zugriff nach den Qualifikatoren, die in der Anfrage übergeben wurden | ArrayOfString |
wisdom:SearchFilter/RoutingProfileArn | Filtert den Zugriff nach dem Connect-Routing-Profil-ARN, der in der Anforderung übergeben wird | ARN |