Actions, ressources et clés de condition pour AWS IoT Events

AWS IoT Events (préfixe de service : iotevents) fournit les ressources, les actions et les clés de contexte de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.

Références :

• Découvrez comment configurer ce service.

• Affichez la liste des opérations d'API disponibles pour ce service.

• Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.

Actions définies par AWS IoT Events

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une stratégie, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions	Description	Niveau d'accès	Types de ressources (*obligatoire)	Clés de condition	Actions dépendantes
BatchAcknowledgeAlarm	Accorde l'autorisation d'envoyer une ou plusieurs demandes d'action d'acceptation à AWS IoT Events	Écrire	alarmModel*
BatchDeleteDetector	Accorde l'autorisation de supprimer une instance de détecteur dans le système AWS IoT Events	Écrire	detectorModel*
BatchDisableAlarm	Accorde l'autorisation de désactiver une ou plusieurs instances d'alarme	Écriture	alarmModel*
BatchEnableAlarm	Accorde l'autorisation d'activer une ou plusieurs instances d'alarme	Écriture	alarmModel*
BatchPutMessage	Accorde l'autorisation d'envoyer un ensemble de messages au système AWS IoT Events	Écriture	input*
BatchResetAlarm	Accorde l'autorisation de réinitialiser une ou plusieurs instances d'alarme	Écriture	alarmModel*
BatchSnoozeAlarm	Accorde l'autorisation de modifier une ou plusieurs instances d'alarme en mode Snooze	Écriture	alarmModel*
BatchUpdateDetector	Accorde l'autorisation de mettre à jour une instance de détecteur dans le système AWS IoT Events	Écriture	detectorModel*
CreateAlarmModel	Accorde l'autorisation de créer un modèle d'alarme pour surveiller un attribut d'entrée AWS IoT Events ou une propriété de ressource AWS IoT SiteWise	Écriture	alarmModel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDetectorModel	Accorde l'autorisation de créer un modèle de détecteur pour surveiller un attribut d'entrée AWS IoT Events	Écriture	detectorModel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateInput	Accorde l'autorisation de créer une entrée dans Iot Events	Écriture	input*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAlarmModel	Accorde l'autorisation de supprimer un modèle d'alarme	Écriture	alarmModel*
DeleteDetectorModel	Accorde l'autorisation de supprimer un modèle de détecteur	Écriture	detectorModel*
DeleteInput	Accorde l'autorisation de supprimer une entrée.	Écriture	input*
DescribeAlarm	Accorde l'autorisation de récupérer les informations sur une instance d'alarme	Lecture	alarmModel*
DescribeAlarmModel	Accorde l'autorisation de récupérer les informations sur un modèle d'alarme	Lecture	alarmModel*
DescribeDetector	Accorde l'autorisation de récupérer les informations sur une instance de détecteur	Lecture	detectorModel*
DescribeDetectorModel	Accorde l'autorisation de récupérer les informations sur un modèle de détecteur	Lire	detectorModel*
DescribeDetectorModelAnalysis	Accorde l'autorisation de récupérer les informations sur l'analyse d'un modèle de détecteur	Lire
DescribeInput	Accorde l'autorisation de récupérer les informations sur une entrée	Lecture	input*
DescribeLoggingOptions	Accorde l'autorisation de récupérer les paramètres actuels des options de journalisation AWS IoT Events	Lire
GetDetectorModelAnalysisResults	Accorde l'autorisation de récupérer les résultats de l'analyse du modèle de détecteur	Lire
ListAlarmModelVersions	Accorde l'autorisation de répertorier toutes les versions d'un modèle d'alarme	Liste	alarmModel*
ListAlarmModels	Accorde l'autorisation de répertorier les modèles d'alarmes que vous avez créés	Liste
ListAlarms	Accorde l'autorisation de récupérer les informations sur toutes les instances d'alarme par alarmModel	Liste	alarmModel*
ListDetectorModelVersions	Accorde l'autorisation de récupérer toutes les versions d'un modèle de détecteur	Liste	detectorModel*
ListDetectorModels	Accorde l'autorisation de récupérer les modèles de détecteur que vous avez créés	Liste
ListDetectors	Accorde l'autorisation de récupérer les informations sur toutes les instances de détecteur par detectormodel	Liste	detectorModel*
ListInputRoutings	Accorde l'autorisation de répertorier un ou plusieurs routages d'entrée	Liste
ListInputs	Accorde l'autorisation de répertorier les entrées que vous avez créées	Liste
ListTagsForResource	Accorde l'autorisation de récupérer les identifications (métadonnées) que vous avez affectées à la ressource	Lecture	alarmModel
			detectorModel
			input
PutLoggingOptions	Accorde l'autorisation de définir ou de mettre à jour les options de journalisation AWS IoT Events	Écrire
StartDetectorModelAnalysis	Accorde l'autorisation de démarrer l'analyse du modèle de détecteur	Écrire
TagResource	Accorde l'autorisation d'ajouter ou de modifier les balises d'une ressource donnée. Les balises sont des métadonnées qui peuvent être utilisées pour gérer une ressource.	Balisage	alarmModel
			detectorModel
			input
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation de supprimer les identifications données (métadonnées) de la ressource	Balisage	alarmModel
			detectorModel
			input
				aws:TagKeys
UpdateAlarmModel	Accorde l'autorisation de mettre à jour un modèle d'alarme	Écriture	alarmModel*
UpdateDetectorModel	Accorde l'autorisation de mettre à jour un modèle de détecteur	Écriture	detectorModel*
UpdateInput	Accorde l'autorisation de mettre à jour une entrée.	Écriture	input*
UpdateInputRouting	Accorde l'autorisation de mettre à jour le routage d'entrée	Écriture	input*

Types de ressources définis par AWS IoT Events

Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources	ARN	Clés de condition
detectorModel	arn:${Partition}:iotevents:${Region}:${Account}:detectorModel/${DetectorModelName}	aws:ResourceTag/${TagKey}
alarmModel	arn:${Partition}:iotevents:${Region}:${Account}:alarmModel/${AlarmModelName}	aws:ResourceTag/${TagKey}
input	arn:${Partition}:iotevents:${Region}:${Account}:input/${InputName}	aws:ResourceTag/${TagKey}

Clés de condition pour AWS IoT Events

AWS IoT Events définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une politique IAM. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition	Description	Type
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des paires clé-valeur de la balise dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des balises attachées à une ressource	Chaîne
aws:TagKeys	Filtrer les actions en fonction des clés de balise dans la demande	ArrayOfString
iotevents:keyValue	Filtre l'accès en fonction de l'InstanceId (clé-valeur) du message	Chaîne