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 Business Q Apps
Amazon Q Business Q Apps (Servicepräfix:qapps) stellt die folgenden dienstspezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel zur 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 Business Q Apps 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 |
|---|---|---|---|---|---|
| AssociateLibraryItemReview | Erteilt die Erlaubnis, eine Bewertung eines Bibliothekselements in der Q Business-Anwendungsumgebung zuzuordnen | Schreiben | |||
| AssociateQAppWithUser | Erteilt die Berechtigung, Q App einem Benutzer in der Q Business-Anwendungsumgebung zuzuordnen | Schreiben | |||
| BatchCreateCategory | Erteilt die Erlaubnis, die Kategorien einer Bibliothek in der Q Business-Anwendungsumgebung zu erstellen | Schreiben | |||
| BatchDeleteCategory | Erteilt die Berechtigung zum Löschen der Kategorien einer Bibliothek in der Q Business-Anwendungsumgebung | Schreiben | |||
| BatchUpdateCategory | Erteilt die Berechtigung, die Kategorien einer Bibliothek in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| CopyQApp [nur Berechtigung] | Erteilt die Erlaubnis, Q App in die Q Business-Anwendungsumgebung zu kopieren | Schreiben | |||
| CreateLibraryItem | Erteilt die Erlaubnis, ein Bibliothekselement in der Q Business-Anwendungsumgebung zu erstellen | Schreiben | |||
| CreateLibraryItemReview [nur Berechtigung] | Erteilt die Berechtigung, eine Überprüfung eines Bibliothekselements in der Q Business-Anwendungsumgebung zu erstellen | Schreiben | |||
| CreatePresignedUrl | Erteilt die Berechtigung, eine vorsignierte URL für das Hochladen einer Datei in eine Q App- oder Q App-Sitzung in der Q Business-Anwendungsumgebung zu erstellen | Schreiben | |||
| CreateQApp | Erteilt die Erlaubnis, Q App in der Q Business-Anwendungsumgebung zu erstellen | Schreiben | |||
| CreateSubscriptionToken [nur Berechtigung] | Erteilt die Erlaubnis, ein Q App-Eventbus-Thema in der Q Business-Anwendungsumgebung zu abonnieren | Schreiben | |||
| DeleteLibraryItem | Erteilt die Berechtigung zum Löschen eines Bibliothekselements in der Q Business-Anwendungsumgebung | Schreiben | |||
| DeleteQApp | Erteilt die Erlaubnis, Q App in der Q Business-Anwendungsumgebung zu löschen | Schreiben | |||
| DescribeQAppPermissions | Erteilt die Erlaubnis, Q App-Sharing-Berechtigungen in der Q Business-Anwendungsumgebung zu erhalten | Lesen | |||
| DisassociateLibraryItemReview | Erteilt die Erlaubnis, die Zuordnung einer Überprüfung eines Bibliothekselements in der Q Business-Anwendungsumgebung aufzuheben | Schreiben | |||
| DisassociateQAppFromUser | Erteilt die Erlaubnis, die Zuordnung von Q App zu einem Benutzer in der Q Business-Anwendungsumgebung aufzuheben | Schreiben | |||
| ExportQAppSessionData | Erteilt die Erlaubnis, Q App-Sitzungsdaten in die Q Business-Anwendungsumgebung zu exportieren | Schreiben | |||
| GetLibraryItem | Erteilt die Erlaubnis, ein Bibliothekselement in der Q Business-Anwendungsumgebung abzurufen | Lesen | |||
| GetQApp | Erteilt die Erlaubnis, Q App in der Q Business-Anwendungsumgebung abzurufen | Lesen | |||
| GetQAppSession | Erteilt die Erlaubnis, eine Q App-Sitzung in der Q Business-Anwendungsumgebung zu starten | Lesen | |||
| GetQAppSessionMetadata | Erteilt die Erlaubnis, Metadaten einer Q App-Sitzung in der Q Business-Anwendungsumgebung abzurufen | Lesen | |||
| ImportDocument | Erteilt die Erlaubnis, ein Dokument in die Q App oder Q App Session in der Q Business-Anwendungsumgebung zu importieren | Schreiben | |||
| ImportDocumentToQApp [nur Berechtigung] | Erteilt die Erlaubnis, ein Dokument in Q App in der Q Business-Anwendungsumgebung zu importieren | Schreiben | |||
| ImportDocumentToQAppSession [nur Berechtigung] | Erteilt die Erlaubnis, ein Dokument in eine Q App-Sitzung in der Q Business-Anwendungsumgebung zu importieren | Schreiben | |||
| ListCategories | Erteilt die Erlaubnis, Kategorien in der Q Business-Anwendungsumgebung aufzulisten | Auflisten | |||
| ListLibraryItems | Erteilt die Berechtigung, Bibliothekselemente in der Q Business-Anwendungsumgebung aufzulisten | Auflisten | |||
| ListQAppSessionData | Erteilt die Erlaubnis, Q App-Sitzungsdaten in der Q Business-Anwendungsumgebung abzurufen | Lesen | |||
| ListQApps | Erteilt die Erlaubnis, Q Apps in der Q Business-Anwendungsumgebung aufzulisten | Auflisten | |||
| ListTagsForResource | Gewährt die Berechtigung zum Auflisten von Tags für eine Ressource | Lesen | |||
| PredictProblemStatementFromConversation [nur Berechtigung] | Erteilt die Berechtigung, eine Problemstellung anhand des Konversationsprotokolls in der Q Business-Anwendungsumgebung vorherzusagen | Schreiben | |||
| PredictQApp | Erteilt die Berechtigung, Q App anhand eines Konversationsprotokolls oder einer Problembeschreibung in der Q Business-Anwendungsumgebung vorherzusagen | Schreiben | |||
| PredictQAppFromProblemStatement [nur Berechtigung] | Erteilt die Berechtigung, Q App-Metadaten anhand einer Problembeschreibung in der Q Business-Anwendungsumgebung vorherzusagen | Schreiben | |||
| StartQAppSession | Erteilt die Erlaubnis, eine Q App-Sitzung in der Q Business-Anwendungsumgebung zu starten | Schreiben | |||
| StopQAppSession | Erteilt die Erlaubnis, die Q App-Sitzung in der Q Business-Anwendungsumgebung zu beenden | Schreiben | |||
| TagResource | Gewährt die Berechtigung zum Markieren einer Ressource mit bestimmten Schlüsselwertpaaren | Tagging | |||
| UntagResource | Gewährt die Berechtigung, das Tag mit dem angegebenen Schlüssel aus einer Ressource zu entfernen | Tagging | |||
| UpdateLibraryItem | Erteilt die Erlaubnis, ein Bibliothekselement in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| UpdateLibraryItemMetadata | Erteilt die Berechtigung, die Metadaten eines Bibliothekselements in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| UpdateQApp | Erteilt die Erlaubnis, Q App in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| UpdateQAppPermissions | Erteilt die Erlaubnis, Q App-Sharing-Berechtigungen in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| UpdateQAppSession | Erteilt die Erlaubnis, die Q App-Sitzung in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben | |||
| UpdateQAppSessionMetadata | Erteilt die Erlaubnis, Metadaten der Q App-Sitzung in der Q Business-Anwendungsumgebung zu aktualisieren | Schreiben |
Von Amazon Q Business Q Apps 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 |
|---|---|---|
| application |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}
|
|
| qapp |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}
|
|
| qapp-session |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}/session/${SessionId}
|
Zustandstasten für Amazon Q Business Q Apps
Amazon Q Business Q Apps 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).
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 |
| qapps:AppIsPublished | Filtert den Zugriff danach, ob Q App veröffentlicht wurde | String |
| qapps:SessionIsShared | Filtert den Zugriff danach, ob eine Q-App-Sitzung gemeinsam genutzt wird | String |
| qapps:UserIsAppOwner | Filtert den Zugriff danach, ob der Anfragende Eigentümer einer Q App ist | String |
| qapps:UserIsSessionModerator | Filtert den Zugriff danach, ob der Anforderer ein Q App-Sitzungsmoderator ist | String |
