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
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-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 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.
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 |
---|---|---|---|---|---|
AddUserLicenses | Gewährt die Berechtigung zum Hinzufügen eines oder mehrerer Benutzer für Lizenzen | Schreiben | |||
AllowVendedLogDeliveryForResource [nur Berechtigung] | Erteilt die Berechtigung zur Konfiguration der versendeten Protokollzustellung für die Amazon Q Business-Anwendungsressource | Berechtigungsverwaltung | |||
AssociatePermission | Erteilt die Erlaubnis, der Anwendung eine ressourcenbasierte Richtlinienerklärung zuzuordnen | Schreiben |
qbusiness:PutResourcePolicy |
||
BatchDeleteDocument | Gewährt die Berechtigung für Batch-Löschvorgänge für das Dokument | Schreiben | |||
BatchPutDocument | Gewährt die Berechtigung für Batch-Put-Vorgänge für das Dokument | Schreiben | |||
CancelSubscription | Erteilt die Erlaubnis, ein Abonnement zu kündigen | Schreiben | |||
Chat | Gewährt die Berechtigung zum Chatten über eine Anwendung | Lesen | |||
ChatSync | Gewährt die Berechtigung, mithilfe einer Anwendung synchron zu chatten | Lesen | |||
CheckDocumentAccess | Erteilt die Berechtigung, zu überprüfen, ob ein Benutzer Zugriff auf ein Dokument hat | Lesen | |||
CreateAnonymousWebExperienceUrl | Erteilt die Erlaubnis, eine eindeutige URL für ein anonymes Amazon Q Business-Weberlebnis zu erstellen | Schreiben | |||
CreateApplication | Gewährt die Berechtigung zum Erstellen einer Anwendung | Schreiben | |||
CreateChatResponseConfiguration | Erteilt der Anwendung die Erlaubnis, eine Konfiguration für Chat-Antworten zu erstellen | Schreiben | |||
CreateDataAccessor | Erteilt der Anwendung die Berechtigung DataAccessor zum Erstellen | Schreiben |
qbusiness:CreateDataAccessorWithTti |
||
CreateDataAccessorWithTti [nur Berechtigung] | Erteilt die Berechtigung, AWS IAM Identity Center Trusted Token Issuer auf der Grundlage der Anwendung DataAccessor zu erstellen | Schreiben | |||
CreateDataSource | Gewährt die Berechtigung zum Erstellen einer Datenquelle für eine bestimmte Anwendung und einen bestimmten Index | Schreiben | |||
CreateIndex | Gewährt die Berechtigung zum Erstellen eines Snapshots für eine gegebene Anwendung | Schreiben | |||
CreateIntegration | Erteilt die Berechtigung zum Erstellen einer neuen Integration für eine Q Business-Anwendung | Schreiben | |||
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 | |||
CreateRetriever | Gewährt die Berechtigung zum Erstellen eines Abrufers für eine bestimmte Anwendung | Schreiben | |||
CreateSubscription | Erteilt die Erlaubnis, ein Abonnement zu erstellen | Schreiben | |||
CreateUser | Gewährt die Berechtigung zum Erstellen eines Benutzers | Schreiben | |||
CreateWebExperience | Gewährt die Berechtigung zum Erstellen eines Weberlebnisses für eine bestimmte Anwendung | Schreiben | |||
DeleteApplication | Gewährt die Berechtigung zum Löschen einer Anwendung | Schreiben | |||
DeleteAttachment | Erteilt die Erlaubnis, einen Anhang im aktuellen Chat-Kontext zu löschen | Schreiben | |||
DeleteChatControlsConfiguration | Gewährt die Berechtigung zum Löschen einer Chat-Steuerungskonfiguration für eine Anwendung | Schreiben | |||
DeleteChatResponseConfiguration | Erteilt die Berechtigung zum Löschen einer Chat-Antwortkonfiguration | Schreiben | |||
DeleteConversation | Gewährt die Berechtigung zum Löschen einer Konversation | Schreiben | |||
DeleteDataAccessor | Erteilt die Erlaubnis zum Löschen DataAccessor | Schreiben | |||
DeleteDataSource | Erteilt die Erlaubnis zum Löschen eines DataSource | Schreiben | |||
DeleteGroup | Gewährt die Berechtigung zum Löschen einer Gruppe | Schreiben | |||
DeleteIndex | Gewährt die Berechtigung zum Löschen eines Index | Schreiben | |||
DeleteIntegration | Erteilt die Berechtigung zum Löschen einer Integration für eine Q Business-Anwendung | Schreiben | |||
DeletePlugin | Gewährt die Berechtigung zum Löschen eines Plugins | Schreiben | |||
DeleteRetriever | Gewährt die Berechtigung zum Löschen eines Abrufers | Schreiben | |||
DeleteUser | Gewährt die Berechtigung zum Löschen eines Benutzers | Schreiben | |||
DeleteWebExperience | Gewährt die Berechtigung zum Löschen einer Web-Erfahrung | Schreiben | |||
DisableAclOnDataSource [nur Berechtigung] | Erteilt die Berechtigung, den ACL-Crawl beim Erstellen der Amazon Q Business-Datenquellenressource zu deaktivieren | Schreiben | |||
DisassociatePermission | Erteilt die Erlaubnis, die Zuordnung der ressourcenbasierten Richtlinienerklärung zur Anwendung aufzuheben | Schreiben |
qbusiness:PutResourcePolicy |
||
GetApplication | Gewährt die Berechtigung zum Abrufen einer Anwendung | Lesen | |||
GetChatControlsConfiguration | Gewährt die Berechtigung zum Abrufen der Chat-Steuerungskonfiguration für eine Anwendung | Auflisten | |||
GetChatResponseConfiguration | Erteilt die Berechtigung zum Abrufen einer Chat-Antwortkonfiguration | Lesen | |||
GetDataAccessor | Erteilt die Erlaubnis zum Abrufen DataAccessor | Lesen | |||
GetDataSource | Gewährt die Berechtigung zum Abrufen einer Datenquelle | Lesen | |||
GetGroup | Gewährt die Berechtigung zum Abrufen einer Gruppe | Lesen | |||
GetIndex | Gewährt die Berechtigung zum Abrufen eines Index | Lesen | |||
GetIntegration | Erteilt die Erlaubnis, eine Integration für eine Q Business-Anwendung zu erhalten | Lesen | |||
GetLicense | Gewährt die Berechtigung zum Abrufen einer Lizenz | Lesen | |||
GetMedia | Erteilt die Berechtigung zum Abrufen der Medien, die einer Systemnachricht zugeordnet sind | Lesen | |||
GetPlugin | Gewährt die Berechtigung zum Abrufen eines Plugins | Lesen | |||
GetPolicy | Erteilt die Berechtigung, die ressourcenbasierte Richtlinie der Anwendung abzurufen | Lesen | |||
GetRetriever | Gewährt die Berechtigung zum Abrufen eines Abrufers | Lesen | |||
GetUser | Gewährt die Berechtigung zum Abrufen eines Benutzers | Lesen | |||
GetWebExperience | Gewährt die Berechtigung zum Abrufen einer Web–Erfahrung | Lesen | |||
ListApplications | Gewährt die Berechtigung zum Auflisten von Anwendungen | Auflisten | |||
ListAttachments | Erteilt die Berechtigung, Anlagen im aktuellen Chat-Kontext aufzulisten | Auflisten | |||
ListChatResponseConfigurations | Erteilt die Berechtigung, Chat-Antwortkonfigurationen für eine Anwendung aufzulisten | Auflisten | |||
ListConversations | Gewährt die Berechtigung zum Auflisten von Konversationen für eine Anwendung | Auflisten | |||
ListDataAccessors | Erteilt die Berechtigung zum Auflisten DataAccessors für die Anwendung | Auflisten | |||
ListDataSourceSyncJobs | Gewährt die Berechtigung zum Abrufen des Verlaufs von Datenquellen-Synchronisierungsaufgaben | Auflisten | |||
ListDataSources | Gewährt die Berechtigung zum Auflisten der Datenquellen einer Anwendung und eines Index | Auflisten | |||
ListDocuments | Gewährt die Berechtigung zum Auflisten aller Dokumente | Auflisten | |||
ListGroups | Gewährt die Berechtigung zum Auflisten von Gruppen | Auflisten | |||
ListIndices | Gewährt die Berechtigung zum Auflisten der Indizes einer Anwendung | Auflisten | |||
ListIntegrations | Erteilt die Berechtigung, alle Integrationen für eine Q Business-Anwendung aufzulisten | Auflisten | |||
ListMessages | Gewährt die Berechtigung zum Auflisten aller Nachrichten | Auflisten | |||
ListPluginActions | Erteilt die Erlaubnis, die Plugin-Aktionen eines Plugins innerhalb einer Anwendung aufzulisten | Lesen | |||
ListPluginTypeActions | Erteilt die Erlaubnis, alle Aktionen für einen Plugin-Typ aufzulisten | Lesen | |||
ListPluginTypeMetadata | Erteilt die Erlaubnis, alle Metadaten des Plugin-Typs aufzulisten | Lesen | |||
ListPlugins | Gewährt die Berechtigung zum Auflisten der Plugins einer Anwendung | Auflisten | |||
ListRetrievers | Gewährt die Berechtigung zum Auflisten der Abrufer einer Anwendung | Auflisten | |||
ListSubscriptions | Gewährt die Berechtigung zum Auflisten von Abonnements | Auflisten | |||
ListTagsForResource | Gewährt die Berechtigung zum Auflisten von Tags für eine Ressource | Lesen | |||
ListUserLicenses | Gewährt die Berechtigung zum Auflisten von Lizenzen | Auflisten | |||
ListWebExperiences | Gewährt die Berechtigung zum Auflisten der Web-Erfahrungen einer Anwendung | Auflisten | |||
PutFeedback | Gewährt die Berechtigung zum Abgeben eines Feedbacks zu einer Konversationsnachricht | Schreiben | |||
PutGroup | Gewährt die Berechtigungen zum Abgeben einer Benutzergruppe | Schreiben | |||
PutResourcePolicy [nur Berechtigung] | Erteilt die Berechtigung, ressourcenbasierte Richtlinienanweisungen in die Anwendung einzufügen | Schreiben | |||
RemoveUserLicenses | Gewährt die Berechtigung zum Entfernen von Lizenzen für einen oder mehrere Benutzer | Schreiben | |||
SearchRelevantContent | Erteilt die Erlaubnis, relevante Inhalte in der Amazon Q Business-Anwendung zu durchsuchen | Lesen | |||
StartDataSourceSyncJob | Gewährt die Berechtigung zum Starten einer Datenquellen-Synchronisierungsaufgabe | Schreiben | |||
StartDeployment | Erteilt die Erlaubnis, mit der Bereitstellung einer Integration zu beginnen | Schreiben | |||
StopDataSourceSyncJob | Gewährt die Berechtigung zum Anhalten einer Datenquellen-Synchronisierungsaufgabe | 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 | |||
UpdateApplication | Gewährt die Berechtigung zum Aktualisieren einer Anwendung | Schreiben | |||
UpdateChatControlsConfiguration | Gewährt die Berechtigung zum Aktualisieren von Chat-Kontrollkonfigurationen für eine Anwendung | Schreiben | |||
UpdateChatResponseConfiguration | Erteilt die Erlaubnis, eine Chat-Antwortkonfiguration zu aktualisieren | Schreiben | |||
UpdateDataAccessor | Erteilt die Erlaubnis zur Aktualisierung DataAccessor | Schreiben | |||
UpdateDataSource | Erteilt die Erlaubnis zum Aktualisieren eines DataSource | Schreiben | |||
UpdateIndex | Gewährt die Berechtigung zum Aktualisieren eines Index | Schreiben | |||
UpdateIntegration | Erteilt die Erlaubnis, eine Integration für eine Q Business-Anwendung zu aktualisieren | Schreiben | |||
UpdatePlugin | Gewährt die Berechtigung zum Aktualisieren eines Plugins | Schreiben | |||
UpdateRetriever | Gewährt die Berechtigung zum Aktualisieren eines Abrufers | Schreiben | |||
UpdateSubscription | Erteilt die Erlaubnis, ein Abonnement zu aktualisieren | Schreiben | |||
UpdateUser | Gewährt die Berechtigung zum Aktualisieren eines Benutzers | Schreiben | |||
UpdateWebExperience | Erteilt die Erlaubnis zum Aktualisieren eines WebExperience | Schreiben | |||
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}
|
|
integration |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/integration/${IntegrationId}
|
|
retriever |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}
|
|
index |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}
|
|
data-source |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}
|
|
plugin |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}
|
|
web-experience |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}
|
|
user-license |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/user-license/${UserLicenseId}
|
|
subscription |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}
|
|
data-accessor |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/data-accessor/${DataAccessorId}
|
|
chat-response-configuration |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/chat-response-configuration/${ChatResponseConfigurationId}
|
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 Condition keys (Bedingungsschlüssel).
Die globalen Bedingungsschlüssel, die für alle Dienste 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 | 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 |
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 |