Gestion d'une AWS IoT règle - AWS IoT Core
Marquer une règleAfficher une règleSuppression d'une règle

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.

Gestion d'une AWS IoT règle

Vous pouvez utiliser les actions suivantes pour gérer vos AWS IoT règles.

Dans cette rubrique :

Marquer une règle

Pour ajouter un niveau de spécificité à vos règles nouvelles ou existantes, vous pouvez appliquer le balisage. Le balisage utilise des paires clé-valeur dans vos règles pour vous permettre de mieux contrôler comment et où vos règles sont appliquées à vos AWS IoT ressources et services. Par exemple, vous pouvez limiter le champ d'application de votre règle pour qu'elle s'applique uniquement à votre environnement bêta pour les tests préliminaires (Key=environment, Value=beta) ou pour capturer tous les messages envoyés au iot/test sujet depuis un point de terminaison spécifique uniquement et les stocker dans un compartiment Amazon S3.

Pour un exemple qui montre comment accorder des autorisations de balisage pour une règle, imaginez un utilisateur qui exécute la commande suivante pour créer une règle et la baliser afin qu'elle ne s'applique qu'à son environnement bêta.

Dans l'exemple, remplacez :

  • MyTopicRuleName avec le nom de la règle.

  • myrule.json avec le nom du document de politique.

aws iot create-topic-rule 
    --rule-name MyTopicRuleName 
    --topic-rule-payload file://myrule.json
    --tags "environment=beta"

Pour cet exemple, vous devez utiliser la IAM politique suivante :

{
    "Version": "2012-10-17",
    "Statement": 
    {
        "Action": [ "iot:CreateTopicRule", "iot:TagResource" ],
        "Effect": "Allow",
        "Resource": [
            "arn:aws:iot:us-east-1:123456789012:rule/MyTopicRuleName"
        ]
    }
}

L'exemple ci-dessus montre une nouvelle règle appelée MyTopicRuleName qui s'applique uniquement à votre environnement bêta. La iot:TagResource dans la déclaration de politique avec MyTopicRuleName spécifiquement appelé permet le marquage lors de la création ou de la mise à jour MyTopicRuleName. Le paramètre --tags "environment=beta" utilisé lors de la création de la règle limite le champ d'application MyTopicRuleName à votre environnement bêta uniquement. Si vous supprimez le paramètre --tags "environment=beta", ensuite MyTopicRuleName s'appliquera à tous les environnements.

Pour plus d'informations sur la création de IAM rôles et de politiques spécifiques à une AWS IoT règle, voir Accorder à une AWS IoT règle l'accès dont elle a besoin

Pour obtenir des informations générales sur le balisage des ressources, veuillez consulter . Marquer vos ressources AWS IoT.

Afficher une règle

Utilisez la list-topic-rulescommande pour répertorier vos règles :

aws iot list-topic-rules

Utilisez la get-topic-rulecommande pour obtenir des informations sur une règle :

aws iot get-topic-rule --rule-name myrule

Suppression d'une règle

Lorsque vous avez terminé avec une règle, vous pouvez la supprimer.

Pour supprimer une règle (AWS CLI)

Utilisez la delete-topic-rulecommande pour supprimer une règle :

aws iot delete-topic-rule --rule-name myrule