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
Amazon Q (Servicepräfix: q
) 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-Operationen 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 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.
In der Spalte Zugriffsebene der Tabelle Aktionen wird beschrieben, wie die Aktion klassifiziert ist (Liste, Lesen, Berechtigungsverwaltung oder Tagging). Diese Klassifizierung gibt an, welche Zugriffsebene die betreffende Aktion gewährt, wenn Sie sie in einer Richtlinie verwenden. Weitere Informationen zu Zugriffsebenen finden Sie unter Zugriffsebenen in Richtlinienzusammenfassungen.
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 |
---|---|---|---|---|---|
AssociateConnectorResource [nur Berechtigung] | Erteilt die Erlaubnis, eine AWS Ressource mit einem Amazon Q-Connector zu verknüpfen | Schreiben | |||
CreateAssignment [nur Berechtigung] | Erteilt die Erlaubnis, eine Benutzer- oder Gruppenzuweisung für ein Amazon Q-Entwicklerprofil zu erstellen | Schreiben | |||
CreateAuthGrant [nur Berechtigung] | Erteilt die Erlaubnis, OAuth Benutzer in Amazon Q zu erstellen | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
CreateOAuthAppConnection [nur Berechtigung] | Erteilt die Erlaubnis, eine OAuth Anwendung in Amazon Q zu registrieren | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
CreatePlugin [nur Berechtigung] | Erteilt die Erlaubnis, ein Drittanbieter-Plugin in Amazon Q zu erstellen und zu konfigurieren | Schreiben | |||
DeleteAssignment [nur Berechtigung] | Erteilt die Berechtigung zum Löschen einer Benutzer- oder Gruppenzuweisung für ein Amazon Q-Entwicklerprofil | Schreiben | |||
DeleteConversation [nur Berechtigung] | Erteilt die Erlaubnis, eine Konversation mit Amazon Q zu löschen | Schreiben | |||
DeleteOAuthAppConnection [nur Berechtigung] | Erteilt die Erlaubnis, eine OAuth Anwendung in Amazon Q zu löschen | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
DeletePlugin [nur Berechtigung] | Erteilt die Erlaubnis, ein konfiguriertes Plugin in Amazon Q zu löschen | Schreiben | |||
GenerateCodeFromCommands [nur Berechtigung] | Erteilt die Erlaubnis, Code aus CLI-Befehlen in Amazon Q zu generieren | Lesen | |||
GenerateCodeRecommendations [nur Berechtigung] | Erteilt die Erlaubnis, Codeempfehlungen in Amazon Q zu generieren | Lesen | |||
GetConnector [nur Berechtigung] | Erteilt die Erlaubnis, Informationen über einen bestimmten Amazon Q-Connector anzuzeigen | Lesen | |||
GetConversation [nur Berechtigung] | Gewährt die Berechtigung zum Abrufen einzelner Nachrichten, die einer bestimmten Konversation mit Amazon Q zugeordnet sind | Lesen | |||
GetIdentityMetadata [nur Berechtigung] | Erteilt Amazon Q die Erlaubnis, die Identitätsmetadaten abzurufen | Lesen | |||
GetPlugin [nur Berechtigung] | Erlaubt die Erlaubnis, Informationen über ein bestimmtes konfiguriertes Amazon Q-Plugin anzuzeigen | Lesen | |||
GetTroubleshootingResults [nur Berechtigung] | Gewährt die Berechtigung zum Abrufen von Ergebnissen zur Fehlerbehebung mit Amazon Q | Lesen | |||
ListConversations [nur Berechtigung] | Erteilt die Erlaubnis, einzelne Konversationen aufzulisten, die mit einem bestimmten Amazon Q-Benutzer verknüpft sind | Lesen | |||
ListDashboardMetrics [nur Berechtigung] | Erteilt die Berechtigung zum Lesen von Metriken zum Auffüllen des Amazon Q-Dashboards | Auflisten | |||
ListPluginProviders [nur Berechtigung] | Erteilt die Erlaubnis, verfügbare Plugins in Amazon Q aufzulisten | Auflisten | |||
ListPlugins [nur Berechtigung] | Erteilt die Erlaubnis, konfigurierte Plugins in Amazon Q aufzulisten | Auflisten | |||
ListTagsForResource [nur Berechtigung] | Erteilt die Erlaubnis, alle mit einer Amazon Q-Ressource verknüpften Tags aufzulisten | Auflisten | |||
PassRequest [nur Berechtigung] | Erteilt die Erlaubnis, Amazon Q die Durchführung von Aktionen in Ihrem Namen zu gestatten | Schreiben | |||
RejectConnector [nur Berechtigung] | Erteilt die Erlaubnis, eine Verbindungsanfrage für einen Amazon Q-Connector abzulehnen | Schreiben | |||
SendEvent [nur Berechtigung] | Erteilt die Erlaubnis, asynchrone Amazon Q-Aktionen auszulösen | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
SendMessage [nur Berechtigung] | Gewährt die Berechtigung zum Senden einer Nachricht an Amazon Q | Schreiben | |||
StartConversation [nur Berechtigung] | Gewährt die Berechtigung zum Starten einer Konversation mit Amazon Q | Schreiben | |||
StartTroubleshootingAnalysis [nur Berechtigung] | Gewährt die Berechtigung zum Starten einer Analyse zur Fehlerbehebung mit Amazon Q | Schreiben | |||
StartTroubleshootingResolutionExplanation [nur Berechtigung] | Gewährt die Berechtigung zum Starten einer Erläuterung der Problemlösung mit Amazon Q | Schreiben | |||
TagResource [nur Berechtigung] | Erteilt die Erlaubnis, Tags mit einer Amazon Q-Ressource zu verknüpfen | Tagging | |||
UntagResource [nur Berechtigung] | Erteilt die Erlaubnis, Tags zu entfernen, die mit einer Amazon Q-Ressource verknüpft sind | Tagging | |||
UpdateAuthGrant [nur Berechtigung] | Erteilt die Erlaubnis, OAuth Benutzer in Amazon Q zu aktualisieren | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
UpdateConversation [nur Berechtigung] | Erteilt die Erlaubnis, eine Konversation mit Amazon Q zu aktualisieren | Schreiben | |||
UpdateOAuthAppConnection [nur Berechtigung] | Erteilt die Erlaubnis, eine OAuth Anwendung in Amazon Q zu aktualisieren | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
||
UpdatePlugin [nur Berechtigung] | Erteilt die Erlaubnis, ein Drittanbieter-Plugin in Amazon Q zu aktualisieren | Schreiben | |||
UpdateTroubleshootingCommandResult [nur Berechtigung] | Erteilt die Erlaubnis, das Ergebnis eines Fehlerbehebungsbefehls mit Amazon Q zu aktualisieren | Schreiben | |||
UsePlugin [nur Berechtigung] | Erteilt die Erlaubnis zur Verwendung von Amazon Q-Plugins | Schreiben | |||
VerifyOAuthAppConnection [nur Berechtigung] | Erteilt die Erlaubnis, eine OAuth Anwendung in Amazon Q zu verifizieren | Schreiben |
kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo |
Von Amazon Q 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.
Bedingungsschlüssel für Amazon Q
Amazon Q definiert die folgenden Bedingungsschlüssel, die im Condition
Element 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).
Informationen zu den globalen Bedingungsschlüsseln, die für alle Services verfügbar sind, finden Sie unter Kontextschlüssel für AWS globale Bedingungen.
Bedingungsschlüssel | Beschreibung | Typ |
---|---|---|
aws:RequestTag/${TagKey} | Filtert den Zugriff durch die Tags, die in der Anfrage übergeben werden | String |
aws:ResourceTag/${TagKey} | Filtert den Zugriff nach den Tags, die mit der Amazon Q-Ressource verknüpft sind | String |
aws:TagKeys | Filtert den Zugriff basierend auf den Tag-Schlüssel, die in der Anfrage übergeben werden | ArrayOfString |
identitystore:GroupId | Filtert den Zugriff nach der IAM Identity Center-Gruppen-ID | ArrayOfString |
identitystore:UserId | Filtert den Zugriff nach der IAM-Identity-Center-Benutzer-ID | ArrayOfString |