Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Lex

Amazon Lex (Servicepräfix: lex) 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.

Von Amazon Lex 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
CreateBotVersion	Erstellt eine neue Version basierend auf der $LATEST-Version des angegebenen Bots	Schreiben	bot version*
CreateIntentVersion	Erstellt eine neue Version basierend auf der $LATEST-Version der angegebenen Absicht	Schreiben	intent version*
CreateSlotTypeVersion	Erstellt eine neue Version basierend auf der $LATEST-Version des angegebenen Slot-Typs	Schreiben	slottype version*
DeleteBot	Löscht alle Versionen eines Bots	Schreiben	bot version*
DeleteBotAlias	Löscht einen Alias für den angegebenen Bot	Schreiben	bot alias*
DeleteBotChannelAssociation	Löscht das Mapping zwischen dem Alias eines Amazon-Lex-Bots und einer Messaging-Plattform	Schreiben	channel*
DeleteBotVersion	Löscht eine bestimmte Version eines Bots	Schreiben	bot version*
DeleteIntent	Löscht alle Versionen einer Absicht	Schreiben	intent version*
DeleteIntentVersion	Löscht eine bestimmte Version einer Absicht	Schreiben	intent version*
DeleteSession	Entfernt Sitzungsinformationen für einen angegebenen Bot, Alias und eine Benutzer-ID	Schreiben	bot alias
			bot version
DeleteSlotType	Löscht alle Versionen eines Slot-Typs	Schreiben	slottype version*
DeleteSlotTypeVersion	Löscht eine bestimmte Version eines Slot-Typs	Schreiben	slottype version*
DeleteUtterances	Löscht die Informationen, die Amazon Lex für Äußerungen auf einem bestimmten Bot und mit einer bestimmten userId verwaltet	Schreiben	bot version*
GetBot	Gibt Informationen für einen bestimmten Bot zurück. Neben dem Bot-Namen muss die Bot-Version oder der Bot-Alias angegeben werden	Lesen	bot alias
			bot version
GetBotAlias	Gibt Informationen zu einem Amazon-Lex-Bot-Alias zurück	Lesen	bot alias*
GetBotAliases	Gibt eine Liste der Alias für einen bestimmten Amazon-Lex-Bot zurück	Auflisten
GetBotChannelAssociation	Gibt Informationen zum Mapping zwischen dem Alias eines Amazon-Lex-Bots und einer Messaging-Plattform zurück	Lesen	channel*
GetBotChannelAssociations	Gibt eine Liste aller Channels zurück, die einem einzelnen Bot zugeordnet sind	Auflisten	channel*
GetBotVersions	Gibt Informationen zu allen Versionen eines bestimmten Bots zurück	Auflisten	bot version*
GetBots	Gibt Informationen zur $LATEST-Version aller Bots zurück, die dem vom Client bereitgestellten Filter entsprechen	Auflisten
GetBuiltinIntent	Gibt Informationen zu einer integrierten Absicht zurück	Lesen
GetBuiltinIntents	Ruft eine Liste der integrierten Absichten ab, die den angegebenen Kriterien entsprechen	Lesen
GetBuiltinSlotTypes	Ruft eine Liste der integrierten Slot-Typen ab, die den angegebenen Kriterien entsprechen	Lesen
GetExport	Exportiert Amazon-Lex-Ressourcen in einem angeforderten Format	Lesen	bot version*
GetImport	Ruft Informationen über einen mit StartImport gestarteten Importauftrag ab	Lesen
GetIntent	Gibt Informationen zu einer bestimmten Absicht zurück. Neben dem Namen muss auch die Version der Absicht angegeben werden	Lesen	intent version*
GetIntentVersions	Gibt Informationen zu allen Versionen einer bestimmten Absicht zurück	Auflisten	intent version*
GetIntents	Gibt Informationen zur $LATEST-Version aller Absichten zurück, die dem vom Client bereitgestellten Filter entsprechen	Auflisten
GetMigration	Gewährt die Berechtigung zum Anzeigen einer laufenden oder abgeschlossenen Migration	Lesen
GetMigrations	Gewährt die Berechtigung zum Anzeigen der Liste der Migrationen von Amazon Lex v1 zu Amazon Lex v2	Auflisten
GetSession	Gibt Sitzungsinformationen für einen angegebenen Bot, Alias und eine Benutzer-ID zurück	Lesen	bot alias
			bot version
GetSlotType	Gibt Informationen hinsichtlich einer bestimmten Version eines Slot-Typs zurück. Neben dem Namen muss auch die Version des Slot-Typs angegeben werden	Lesen	slottype version*
GetSlotTypeVersions	Gibt Informationen zu allen Versionen eines bestimmten Slot-Typs zurück	Auflisten	slottype version*
GetSlotTypes	Gibt Informationen zur $LATEST-Version aller Slot-Typen zurück, die dem vom Client bereitgestellten Filter entsprechen	Auflisten
GetUtterancesView	Gibt eine Ansicht der aggregierten Äußerungsdaten für Versionen eines Bots in einem aktuellen Zeitraum zurück	Auflisten	bot version*
ListTagsForResource	Listet Tags für eine Lex-Ressource auf	Lesen	bot
			bot alias
			channel
PostContent	Sendet eine Benutzereingabe (Text oder Sprache) an Amazon Lex	Schreiben	bot alias
			bot version
PostText	Sendet eine Benutzereingabe (nur Text) an Amazon Lex	Schreiben	bot alias
			bot version
PutBot	Erstellt oder aktualisiert die $LATEST-Version eines Amazon-Lex-Konversations-Bots	Schreiben	bot version*
				aws:TagKeys aws:RequestTag/${TagKey}
PutBotAlias	Erstellt oder aktualisiert einen Alias für einen bestimmten Bot	Schreiben	bot alias*
				aws:TagKeys aws:RequestTag/${TagKey}
PutIntent	Erstellt oder aktualisiert die $LATEST-Version einer Absicht	Schreiben	intent version*
PutSession	Erstellt eine neue Sitzung oder ändert eine bestehende Sitzung mit einem Amazon-Lex-Bot	Schreiben	bot alias
			bot version
PutSlotType	Erstellt oder aktualisiert die $LATEST-Version eines Slot-Typs	Schreiben	slottype version*
StartImport	Startet einen Auftrag zum Importieren einer Ressource in Amazon Lex	Schreiben
StartMigration	Gewährt die Berechtigung, einen Bot von Amazon Lex v1 zu Amazon Lex v2 zu migrieren	Schreiben	bot version*
TagResource	Fügt Tags zu einer Lex-Ressource hinzu oder überschreibt sie	Markieren	bot
			bot alias
			channel
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Entfernt Tags aus einer Lex-Ressource	Markieren	bot
			bot alias
			channel
				aws:TagKeys aws:RequestTag/${TagKey}

Von Amazon Lex 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 "Actions" (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
bot	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}	aws:ResourceTag/${TagKey}
bot version	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}	aws:ResourceTag/${TagKey}
bot alias	arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}	aws:ResourceTag/${TagKey}
channel	arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}	aws:ResourceTag/${TagKey}
intent version	arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
slottype version	arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}

Bedingungsschlüssel für Amazon Lex

Amazon Lex 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 basierend auf den Tags in der Anforderung.	Zeichenfolge
aws:ResourceTag/${TagKey}	Filtert den Zugriff über die Tags, die einer Lex-Ressource zugeordnet sind.	Zeichenfolge
aws:TagKeys	Filtert den Zugriff basierend auf dem Satz von Tag-Schlüsseln in der Anforderung	ArrayOfString
lex:associatedIntents	Ermöglicht das Steuern des Zugriffs basierend auf in der Anforderung enthaltenen Absichten	ArrayOfString
lex:associatedSlotTypes	Ermöglicht das Steuern des Zugriffs basierend auf in der Anforderung enthaltenen Slot-Typen	ArrayOfString
lex:channelType	Ermöglicht das Steuern des Zugriffs basierend auf in der Anforderung enthaltenen Channel-Typen	Zeichenfolge