AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Balisage de vos ressources AWS IoT Greengrass

Les balises peuvent vous aider à organiser et à gérer vos groupes AWS IoT Greengrass. Vous pouvez utiliser des balises pour attribuer des métadonnées à des groupes, des déploiements en masse, et des noyaux, des appareils et d'autres ressources qui sont ajoutés aux groupes. Les tags peuvent également être utilisés dans les politiques IAM pour définir un accès conditionnel à vos ressources Greengrass.

Principes de base des étiquettes

Les balises vous permettent de classer vos ressources AWS IoT Greengrass, par exemple, par objectif, par propriétaire et par environnement. Lorsque vous avez de nombreuses ressources de même type, vous pouvez identifier rapidement une ressource spécifique en fonction des balises qui lui sont associées. Une balise est constituée d'une clé et d'une valeur facultative que vous définissez. Nous vous recommandons de concevoir un ensemble de clés de balise pour chaque type de ressource. L’utilisation d’un ensemble de clés de balise cohérent facilite la gestion de vos ressources. Par exemple, vous pouvez définir un ensemble de balises pour vos groupes qui vous permet de suivre l'emplacement usine de vos principaux appareils. Pour plus d'informations, consultez Stratégies d'étiquette AWS.

Prise en charge du balisage dans la console AWS IoT

Vous pouvez créer, afficher et gérer des balises pour vos ressources Group dans la console AWS IoT. Avant de créer des balises, tenez compte des restrictions liées aux balises. Pour de plus amples informations, veuillez consulter Conventions de dénomination et d'utilisation des balises dans le Référence générale d'Amazon Web Services.

Prise en charge du balisage dans l'API AWS IoT Greengrass

Vous devez utiliser l'API AWS IoT Greengrass afin de créer et gérer des balises pour les ressources AWS IoT Greengrass qui prennent en charge le balisage. Avant de créer des balises, tenez compte des restrictions liées aux balises. Pour de plus amples informations, veuillez consulter Conventions de dénomination et d'utilisation des balises dans le Référence générale d'Amazon Web Services.

Le tableau suivant répertorie les ressources que vous pouvez baliser dans l'API AWS IoT Greengrass et ses actions Create et Get correspondantes.

Utilisez les actions suivantes afin de répertorier et de gérer des balises pour les ressources qui prennent en charge le balisage :

Vous pouvez ajouter ou supprimer des balises sur une ressource à tout moment. Pour modifier la valeur d'une clé de balise, ajoutez une balise à la ressource qui définit la même clé et la nouvelle valeur. La nouvelle valeur remplace l'ancienne valeur. Vous pouvez définir la valeur d'une balise sur une chaîne vide, mais pas sur null.

Lorsque vous supprimez une ressource, les balises associées à celle-ci sont également supprimées.

Utilisation des balises avec des politiques IAM

Dans vos politiques IAM, vous pouvez utiliser des balises de ressources pour contrôler l'accès et les autorisations des utilisateurs. Par exemple, des stratégies peuvent permettre aux utilisateurs de créer uniquement les ressources qui comportent une balise spécifique. Les stratégies peuvent également empêcher les utilisateurs de créer ou de modifier des ressources qui ont des balises spécifiques. Vous pouvez baliser des ressources au cours de la création (baliser lors de la création) afin de ne pas avoir à exécuter des scripts de balisage personnalisés plus tard. Lorsque de nouveaux environnements sont lancés avec des balises, les autorisations IAM correspondantes sont appliquées automatiquement.

Les clés de contexte de condition et les valeurs suivantes peuvent être utilisées dans l'élément Condition (également nommé bloc de Condition) de la stratégie.

Les clés de contexte de condition et les valeurs peuvent être utilisées uniquement sur les actions AWS IoT Greengrass qui agissent sur une ressource balisable. Ces actions prennent la ressource comme un paramètre obligatoire. Par exemple, vous pouvez définir un accès conditionnel sur GetGroupVersion. Vous ne pouvez pas définir d'accès conditionnel sur AssociateServiceRoleToAccount car aucune ressource balisable (par exemple, un groupe, une définition de noyau ou une définition d'appareil) n'est référencée dans la demande.

Pour plus d'informations, consultez la section Contrôle de l'accès à l'aide de balises et la référence de politique IAM JSON dans le guide de l'utilisateur IAM. La référence de politique JSON inclut une syntaxe détaillée, des descriptions et des exemples des éléments, des variables et de la logique d'évaluation des politiques JSON dans IAM.

Exemple de politiques IAM

L'exemple de stratégie suivant applique des autorisations reposant sur les balises qui limitent un utilisateur bêta aux actions sur les ressources bêta uniquement.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "greengrass:*",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "greengrass:ResourceTag/env": "beta"
                }
            }
        },
        {
            "Effect": "Deny",
            "Action": "greengrass:UntagResource",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "beta"
                }
            }
        }
    ]
}

Pour permettre aux utilisateurs de baliser lors de la création, vous devez leur accorder les autorisations appropriées. L'exemple de stratégie suivant inclut la "aws:RequestTag/env": "beta" condition sur les actions greengrass:TagResource et greengrass:CreateGroup, ce qui permet aux utilisateurs de créer un groupe uniquement s'ils balisent ce dernier avec env=beta. Cela oblige vraiment les utilisateurs à baliser les nouveaux groupes.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "greengrass:TagResource",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/env": "beta"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "greengrass:CreateGroup",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/env": "beta"
                }
            }
        }
    ]
}

L'extrait suivant vous montre comment spécifier plusieurs valeurs de balise pour une clé de balise donnée en les plaçant dans une liste :

"StringEquals" : {
    "greengrass:ResourceTag/env" : ["dev", "test"]
}

Consultez aussi