Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Q Business

Amazon Q Business (Servicepräfix: qbusiness) 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-Vorgänge an, die für diesen Service verfügbar sind.

• Erfahren Sie, wie Sie diesen Service und seine Ressourcen mithilfe von IAM-Berechtigungsrichtlinien schützen.

Von Amazon Q Business 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
AddUserLicenses	Gewährt die Berechtigung zum Hinzufügen eines oder mehrerer Benutzer für Lizenzen	Schreiben
BatchDeleteDocument	Gewährt die Berechtigung für Batch-Löschvorgänge für das Dokument	Schreiben	application*
			index*
BatchPutDocument	Gewährt die Berechtigung für Batch-Put-Vorgänge für das Dokument	Schreiben	application*
			index*
CancelSubscription	Erteilt die Erlaubnis, ein Abonnement zu kündigen	Schreiben	application*
			subscription*
Chat	Gewährt die Berechtigung zum Chatten über eine Anwendung	Lesen	application*
ChatSync	Gewährt die Berechtigung, mithilfe einer Anwendung synchron zu chatten	Lesen	application*
CreateApplication	Gewährt die Berechtigung zum Erstellen einer Anwendung	Schreiben		aws:RequestTag/${TagKey} aws:TagKeys
CreateDataSource	Gewährt die Berechtigung zum Erstellen einer Datenquelle für eine bestimmte Anwendung und einen bestimmten Index	Schreiben	application*
			index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	Gewährt die Berechtigung zum Erstellen eines Snapshots für eine gegebene Anwendung	Schreiben	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateLicense	Gewährt die Berechtigung zum Erstellen einer Lizenz	Schreiben
CreatePlugin	Gewährt die Berechtigung zum Erstellen eines Plugins für eine bestimmte Anwendung	Schreiben	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateRetriever	Gewährt die Berechtigung zum Erstellen eines Abrufers für eine bestimmte Anwendung	Schreiben	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSubscription	Erteilt die Erlaubnis, ein Abonnement zu erstellen	Schreiben	application*
CreateUser	Gewährt die Berechtigung zum Erstellen eines Benutzers	Schreiben	application*
CreateWebExperience	Gewährt die Berechtigung zum Erstellen eines Weberlebnisses für eine bestimmte Anwendung	Schreiben	application*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteApplication	Gewährt die Berechtigung zum Löschen einer Anwendung	Schreiben	application*
DeleteChatControlsConfiguration	Gewährt die Berechtigung zum Löschen einer Chat-Steuerungskonfiguration für eine Anwendung	Schreiben	application*
DeleteConversation	Gewährt die Berechtigung zum Löschen einer Konversation	Schreiben	application*
DeleteDataSource	Erteilt die Erlaubnis zum Löschen eines DataSource	Schreiben	application*
			data-source*
			index*
DeleteGroup	Gewährt die Berechtigung zum Löschen einer Gruppe	Schreiben	application*
			index*
DeleteIndex	Gewährt die Berechtigung zum Löschen eines Index	Schreiben	application*
			index*
DeletePlugin	Gewährt die Berechtigung zum Löschen eines Plugins	Schreiben	application*
			plugin*
DeleteRetriever	Gewährt die Berechtigung zum Löschen eines Abrufers	Schreiben	application*
			retriever*
DeleteUser	Gewährt die Berechtigung zum Löschen eines Benutzers	Schreiben	application*
DeleteWebExperience	Gewährt die Berechtigung zum Löschen einer Web-Erfahrung	Schreiben	application*
			web-experience*
GetApplication	Gewährt die Berechtigung zum Abrufen einer Anwendung	Lesen	application*
GetChatControlsConfiguration	Gewährt die Berechtigung zum Abrufen der Chat-Steuerungskonfiguration für eine Anwendung	Auflisten	application*
GetDataSource	Gewährt die Berechtigung zum Abrufen einer Datenquelle	Lesen	application*
			data-source*
			index*
GetGroup	Gewährt die Berechtigung zum Abrufen einer Gruppe	Lesen	application*
			index*
GetIndex	Gewährt die Berechtigung zum Abrufen eines Index	Lesen	application*
			index*
GetLicense	Gewährt die Berechtigung zum Abrufen einer Lizenz	Lesen	user-license*
GetPlugin	Gewährt die Berechtigung zum Abrufen eines Plugins	Lesen	application*
			plugin*
GetRetriever	Gewährt die Berechtigung zum Abrufen eines Abrufers	Lesen	application*
			retriever*
GetUser	Gewährt die Berechtigung zum Abrufen eines Benutzers	Lesen	application*
GetWebExperience	Gewährt die Berechtigung zum Abrufen einer Web–Erfahrung	Lesen	application*
			web-experience*
ListApplications	Gewährt die Berechtigung zum Auflisten von Anwendungen	Auflisten
ListConversations	Gewährt die Berechtigung zum Auflisten von Konversationen für eine Anwendung	Auflisten	application*
ListDataSourceSyncJobs	Gewährt die Berechtigung zum Abrufen des Verlaufs von Datenquellen-Synchronisierungsaufgaben	Auflisten	application*
			data-source*
			index*
ListDataSources	Gewährt die Berechtigung zum Auflisten der Datenquellen einer Anwendung und eines Index	Auflisten	application*
			index*
ListDocuments	Gewährt die Berechtigung zum Auflisten aller Dokumente	Auflisten	application*
			index*
ListGroups	Gewährt die Berechtigung zum Auflisten von Gruppen	Auflisten	application*
			index*
ListIndices	Gewährt die Berechtigung zum Auflisten der Indizes einer Anwendung	Auflisten	application*
ListMessages	Gewährt die Berechtigung zum Auflisten aller Nachrichten	Auflisten	application*
ListPlugins	Gewährt die Berechtigung zum Auflisten der Plugins einer Anwendung	Auflisten	application*
ListRetrievers	Gewährt die Berechtigung zum Auflisten der Abrufer einer Anwendung	Auflisten	application*
ListSubscriptions	Gewährt die Berechtigung zum Auflisten von Abonnements	Auflisten	application*
ListTagsForResource	Gewährt die Berechtigung zum Auflisten von Tags für eine Ressource	Lesen	application
			data-source
			index
			plugin
			retriever
			web-experience
ListUserLicenses	Gewährt die Berechtigung zum Auflisten von Lizenzen	Auflisten
ListWebExperiences	Gewährt die Berechtigung zum Auflisten der Web-Erfahrungen einer Anwendung	Auflisten	application*
PutFeedback	Gewährt die Berechtigung zum Abgeben eines Feedbacks zu einer Konversationsnachricht	Schreiben	application*
PutGroup	Gewährt die Berechtigungen zum Abgeben einer Benutzergruppe	Schreiben	application*
			index*
RemoveUserLicenses	Gewährt die Berechtigung zum Entfernen von Lizenzen für einen oder mehrere Benutzer	Schreiben
StartDataSourceSyncJob	Gewährt die Berechtigung zum Starten einer Datenquellen-Synchronisierungsaufgabe	Schreiben	application*
			data-source*
			index*
StopDataSourceSyncJob	Gewährt die Berechtigung zum Anhalten einer Datenquellen-Synchronisierungsaufgabe	Schreiben	application*
			data-source*
			index*
TagResource	Gewährt die Berechtigung zum Markieren einer Ressource mit bestimmten Schlüsselwertpaaren	Tagging	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Gewährt die Berechtigung, das Tag mit dem angegebenen Schlüssel aus einer Ressource zu entfernen	Tagging	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:TagKeys
UpdateApplication	Gewährt die Berechtigung zum Aktualisieren einer Anwendung	Schreiben	application*
UpdateChatControlsConfiguration	Gewährt die Berechtigung zum Aktualisieren von Chat-Kontrollkonfigurationen für eine Anwendung	Schreiben	application*
UpdateDataSource	Erteilt die Erlaubnis zum Aktualisieren eines DataSource	Schreiben	application*
			data-source*
			index*
UpdateIndex	Gewährt die Berechtigung zum Aktualisieren eines Index	Schreiben	application*
			index*
UpdatePlugin	Gewährt die Berechtigung zum Aktualisieren eines Plugins	Schreiben	application*
			plugin*
UpdateRetriever	Gewährt die Berechtigung zum Aktualisieren eines Abrufers	Schreiben	application*
			retriever*
UpdateSubscription	Erteilt die Erlaubnis, ein Abonnement zu aktualisieren	Schreiben	application*
			subscription*
UpdateUser	Gewährt die Berechtigung zum Aktualisieren eines Benutzers	Schreiben	application*
UpdateWebExperience	Erteilt die Erlaubnis zum Aktualisieren eines WebExperience	Schreiben	application*
			web-experience*

Von Amazon Q Business 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}	aws:ResourceTag/${TagKey}
retriever	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}	aws:ResourceTag/${TagKey}
index	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}	aws:ResourceTag/${TagKey}
data-source	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}	aws:ResourceTag/${TagKey}
plugin	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}	aws:ResourceTag/${TagKey}
web-experience	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}	aws:ResourceTag/${TagKey}
user-license	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/user-license/${UserLicenseId}
subscription	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}

Bedingungsschlüssel für Amazon Q Business

Amazon Q Business 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 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