Actions, ressources et clés de condition pour AWS IoT Greengrass V2 - Référence de l'autorisation de service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

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

Références :

Actions définies par AWS IoT Greengrass V2

Vous pouvez spécifier les actions suivantes dans l'Actionélément d'une déclaration de IAM politique. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'APIopération ou à la CLI commande 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 spécifier un type ARN de ressource de ce type dans une instruction comportant 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 d'une IAM politique, vous devez inclure un modèle ARN ou 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
AssociateServiceRoleToAccount Accorde l'autorisation d'associer un rôle à votre compte. AWS IoT Greengrass utilise ce rôle pour accéder à vos fonctions Lambda et à vos ressources IoT AWS Gestion des autorisations

iam:PassRole

BatchAssociateClientDeviceWithCoreDevice Accorde l'autorisation d'associer une liste d'appareils de client à un appareil principal Écrire

coreDevice*

BatchDisassociateClientDeviceFromCoreDevice Accorde l'autorisation de dissocier une liste d'appareils de client d'un appareil principal Écrire

coreDevice*

CancelDeployment Accorde l'autorisation d'annuler un déploiement Écriture

deployment*

iot:CancelJob

iot:DeleteThingShadow

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

iot:UpdateJob

iot:UpdateThingShadow

CreateComponentVersion Accorde l'autorisation de créer un composant Écriture

component*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDeployment Accorde l'autorisation de créer un déploiement Écriture

aws:RequestTag/${TagKey}

aws:TagKeys

iot:CancelJob

iot:CreateJob

iot:DeleteThingShadow

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

iot:UpdateJob

iot:UpdateThingShadow

DeleteComponent Accorde l'autorisation de supprimer un composant Écrire

componentVersion*

DeleteCoreDevice Accorde l'autorisation de supprimer un appareil principal AWS IoT Greengrass, qui est un objet AWS IoT. Cette opération supprime l'appareil Core de la liste des appareils Core. Cette opération ne supprime pas l' AWS IoT Écrire

coreDevice*

iot:DescribeJobExecution

DeleteDeployment Accorde l'autorisation de supprimer un déploiement. Pour supprimer un déploiement actif, il est nécessaire de commencer par l'annuler Écrire

deployment*

iot:DeleteJob

DescribeComponent Accorde l'autorisation de récupérer les métadonnées d'une version d'un composant Lecture

componentVersion*

DisassociateServiceRoleFromAccount Accorde l'autorisation de dissocier le rôle de service d'un compte. Sans rôle de service, les déploiements ne fonctionnent pas Écrire
GetComponent Accorde l'autorisation d'obtenir une recette d'une version d'un composant Lecture

componentVersion*

GetComponentVersionArtifact Accorde l'autorisation d'obtenir le pré-signé URL pour télécharger un artefact de composant public Lecture

componentVersion*

GetConnectivityInfo Accorde l'autorisation de récupérer les informations de connectivité d'un appareil noyau Greengrass Lecture

connectivityInfo*

iot:GetThingShadow

GetCoreDevice Accorde l'autorisation de récupérer les métadonnées d'un appareil AWS IoT Greengrass central Lecture

coreDevice*

GetDeployment Accorde l'autorisation d'obtenir un déploiement Lecture

deployment*

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

GetServiceRoleForAccount Accorde l'autorisation de récupérer le rôle de service attaché à un compte Lecture
ListClientDevicesAssociatedWithCoreDevice Accorde l'autorisation de récupérer une liste paginée d'appareils clients associés à un appareil principal AWS IoT Greengrass Liste

coreDevice*

ListComponentVersions Accorde l'autorisation de récupérer la liste paginée de toutes les versions d'un composant Liste

component*

ListComponents Accorde l'autorisation de récupérer la liste paginée des résumés de composants Liste
ListCoreDevices Autorise la récupération d'une liste paginée des principaux AWS appareils IoT Greengrass Liste
ListDeployments Accorde l'autorisation de récupérer la liste paginée des déploiements Liste

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

ListEffectiveDeployments Autorise l'extraction d'une liste paginée des tâches de déploiement envoyées par IoT AWS Greengrass aux principaux appareils IoT AWS Greengrass Liste

coreDevice*

iot:DescribeJob

iot:DescribeJobExecution

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

ListInstalledComponents Accorde l'autorisation de récupérer une liste paginée des composants exécutés par un appareil AWS IoT Greengrass principal Liste

coreDevice*

ListTagsForResource Accorde l'autorisation de répertorier les balises d'une ressource Lecture

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

ResolveComponentCandidates Accorde l'autorisation de répertorier les composants qui répondent aux exigences d'un déploiement en matière de composants, de version et de plateforme Liste

componentVersion*

TagResource Accorde l'autorisation d'ajouter des balises à une ressource. Balisage

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource Accorde l'autorisation de supprimer des identifications d'une ressource. Balisage

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

UpdateConnectivityInfo Accorde l'autorisation de mettre à jour les informations de connectivité d'un noyau Greengrass. Tous les périphériques appartenant au groupe disposant de ce noyau reçoivent ces informations leur permettant de trouver l'emplacement du noyau et de s'y connecter Écrire

connectivityInfo*

iot:GetThingShadow

iot:UpdateThingShadow

Types de ressources définis par AWS IoT Greengrass V2

Les types de ressources suivants sont définis par ce service et peuvent être utilisés dans l'Resourceélément des déclarations de politique d'IAMautorisation. 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
connectivityInfo arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
component arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}

aws:ResourceTag/${TagKey}

componentVersion arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}

aws:ResourceTag/${TagKey}

coreDevice arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}

aws:ResourceTag/${TagKey}

deployment arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}

aws:ResourceTag/${TagKey}

Clés de condition pour AWS IoT Greengrass V2

AWS IoT Greengrass V2 définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une IAM politique. 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 vérifiant les paires clé-valeur de balise incluses dans la demande Chaîne
aws:ResourceTag/${TagKey} Filtre l'accès en vérifiant les paires clé-valeur de balise associées à une ressource spécifique Chaîne
aws:TagKeys Filtre l'accès en vérifiant les clés de balise transmises dans la demande ArrayOfString