Balisage de vos ressources AWS IoT Wireless

Pour vous aider à gérer et organiser vos appareils, passerelles, destinations et profils, vous pouvez éventuellement attribuer vos propres métadonnées à chacune de ces ressources sous la forme de balises. Cette section décrit les balises et montre comment les créer. AWS IoT Wireless ne possède pas de groupes de facturation et utilise les mêmes groupes de facturation qu’AWS IoT Core. Pour plus d’informations, consultez Groupes de facturation dans la documentation d’AWS IoT Core.

Principes de base des étiquettes

Lorsque vous possédez plusieurs ressources AWS IoT Wireless du même type, vous pouvez utiliser des balises pour classer vos ressources de différentes manières (par exemple, par objectif, propriétaire ou environnement). Cela vous permet d’identifier rapidement une ressource en fonction des balises qui lui ont été attribuées.

Chaque balise est constituée d'une clé et d'une valeur facultative que vous définissez. Par exemple, vous pouvez définir un ensemble de balises pour un groupe d’appareils LoRaWAN pour lesquels le micrologiciel de l’appareil est actuellement mis à jour. Pour mieux gérer vos ressources, nous vous recommandons de créer un ensemble cohérent de clés de balise répondant à vos besoins pour chaque type de ressource.

Vous pouvez rechercher et filtrer les ressources en fonction des balises que vous ajoutez ou appliquez. Vous pouvez également utiliser des balises pour contrôler l’accès à vos ressources en utilisant des politiques IAM et des balises de groupe de facturation pour classer et suivre vos coûts.

Création et gestion de balises

Vous pouvez créer et gérer des balises à l’aide de l’éditeur de balises dans la AWS Management Console, AWS IoT Wireless ou l’AWS CLI.

Utilisation de la console

Pour faciliter l’utilisation, l’éditeur de balises de la AWS Management Console offre un moyen central et unifié de créer et de gérer vos balises. Pour plus d’informations, consultez Utilisation de l’éditeur de balises dans Utilisation de la AWS Management Console.

Utilisation de l’API ou de la CLI

Vous pouvez également utiliser l’API ou l’interface de ligne de commande et associer des balises à des appareils sans fil, des passerelles, des profils et des destinations lors de leur création en utilisant le champ Tags dans les commandes suivantes :

Mise à jour de balises ou élaboration d’une liste de balises pour les ressources

Vous pouvez ajouter, modifier ou supprimer des balises pour les ressources existantes qui prennent en charge le balisage à l'aide des commandes suivantes :

Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. Vous pouvez définir la valeur d’une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d’une balise sur null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur. Si vous supprimez une ressource, toutes les balises associées à celle-ci sont également supprimées.

Limites et restrictions liées aux balises

Les restrictions de base suivantes s’appliquent aux balises :

Utilisation des balises avec des politiques IAM

Pour spécifier les ressources qu’un utilisateur peut créer, modifier ou utiliser, vous pouvez appliquer des autorisations au niveau des ressources basées sur des balises dans les politiques IAM que vous utilisez pour les actions d’API AWS IoT Wireless. Pour contrôler l’accès des utilisateurs (autorisations) en fonction des balises d’une ressource, utilisez l’élément Condition (également appelé bloc Condition) avec les clés et valeurs de contexte de condition suivantes dans une politique IAM.

Pour de plus amples informations, veuillez consulter Contrôle de l'accès à l'aide d’étiquettes dans le AWS Identity and Access ManagementGuide de l'utilisateur. La section Référence de stratégie JSON IAM de ce guide fournit la syntaxe détaillée, des descriptions, ainsi que des exemples des éléments, des variables et de la logique d'évaluation des stratégies JSON dans IAM.

L'exemple de stratégie suivant applique deux restrictions basées sur des balises. Un utilisateur IAM restreint par cette stratégie :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": "iot:CreateMulticastGroup",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:RequestTag/env": "prod"
        }
      }
    },
    {
      "Effect": "Deny",
      "Action": [
        "iot:CreateMulticastGroup",
        "iot:UpdateMulticastGroup",
        "iot:GetMulticastGroup",
        "iot:ListMulticastGroups"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/env": "prod"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:CreateMulticastGroup",
        "iot:UpdateMulticastGroup",
        "iot:GetMulticastGroup",
        "iot:ListMulticastGroups"
      ],
      "Resource": "*"
    }
  ]
}

Vous pouvez également spécifier plusieurs valeurs de balise pour une clé de balise donnée en les plaçant dans une liste, comme suit :

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