Actions, ressources et clés de condition pour AWS IoT 1-Click

AWS IoT 1-Click (préfixe de service : iot1click) 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 1-Click

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
AssociateDeviceWithPlacement	Accorde l'autorisation d'associer un périphérique à un placement	Écriture	project*
ClaimDevicesByClaimCode	Accorde l'autorisation d'enregistrer un lot de périphériques avec un code d'enregistrement	Lecture
CreatePlacement	Accorde l'autorisation de créer un placement dans un projet	Écriture	project*
CreateProject	Accorde l'autorisation de créer un projet.	Écriture	project*
				aws:RequestTag/${TagKey} aws:TagKeys
DeletePlacement	Accorde l'autorisation de supprimer un placement d'un projet	Écriture	project*
DeleteProject	Accorde l'autorisation de supprimer un projet	Écriture	project*
DescribeDevice	Accorde l'autorisation de décrire un périphérique	Lecture	device*
DescribePlacement	Accorde l'autorisation de décrire un placement	Lecture	project*
DescribeProject	Accorde l'autorisation de décrire un projet	Lecture	project*
DisassociateDeviceFromPlacement	Accorde l'autorisation de dissocier un périphérique d'un placement	Écriture	project*
FinalizeDeviceClaim	Accorde l'autorisation de finaliser un enregistrement de périphérique	Lecture	device*
				aws:RequestTag/${TagKey} aws:TagKeys
GetDeviceMethods	Accorde l'autorisation d'obtenir les méthodes disponibles d'un périphérique	Lecture	device*
GetDevicesInPlacement	Accorde l'autorisation d'obtenir les périphériques associés à un placement	Lecture	project*
InitiateDeviceClaim	Accorde l'autorisation d'initialiser un enregistrement de périphérique	Lecture	device*
InvokeDeviceMethod	Accorde l'autorisation d'invoquer une méthode de périphérique	Écriture	device*
ListDeviceEvents	Accorde l'autorisation de répertorier des événements passés publiés par un périphérique	Lecture	device*
ListDevices	Accorde l'autorisation de répertorier tous les périphériques	Liste
ListPlacements	Accorde l'autorisation de répertorier des placements dans un projet	Lecture	project*
ListProjects	Accorde l'autorisation de répertorier tous les projets.	Liste
ListTagsForResource	Accorde l'autorisation de répertorier les balises d'une ressource	Lecture	device
			project
TagResource	Accorde l'autorisation d'ajouter ou de mettre à jour les balises d'une ressource	Balisage	device
			project
				aws:RequestTag/${TagKey} aws:TagKeys
UnclaimDevice	Accorde l'autorisation d'annuler l'enregistrement d'un périphérique	Lecture	device*
UntagResource	Accorde l'autorisation de supprimer les balises données (métadonnées) d'une ressource	Balisage	device
			project
				aws:TagKeys
UpdateDeviceState	Accorde l'autorisation de mettre à jour l'état du périphérique	Écriture	device*
UpdatePlacement	Accorde l'autorisation de mettre à jour un placement	Écriture	project*
UpdateProject	Met à jour un projet.	Écriture	project*

Types de ressources définis par AWS IoT 1-Click

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
device	arn:${Partition}:iot1click:${Region}:${Account}:devices/${DeviceId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:iot1click:${Region}:${Account}:projects/${ProjectName}	aws:ResourceTag/${TagKey}

Clés de condition pour AWS IoT 1-Click

AWS IoT 1-Click 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 les actions en fonction des balises qui sont transmises dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre les actions en fonction des balises associées à la ressource.	Chaîne
aws:TagKeys	Filtre les actions en fonction des clés de balise qui sont transmises dans la demande	ArrayOfString