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.

# Gérer une AWS IoT règle
<a name="iot-managae-rule"></a>

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

**Topics**
+ [Marquer une règle](#iot-create-rule-tagging)
+ [Afficher une règle](#iot-view-rules)
+ [Suppression d'une règle](#iot-delete-rule)

## Marquer une règle
<a name="iot-create-rule-tagging"></a>

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.

### Exemple de politique IAM
<a name="iot-create-rule-tagging-iam-example"></a>

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 politique IAM 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 rôles et de politiques IAM spécifiques à une AWS IoT règle, voir [Accorder à une AWS IoT règle l'accès dont elle a besoin](iot-create-role.md)

Pour obtenir des informations générales sur le balisage des ressources, veuillez consulter . [Marquer vos ressources AWS IoT](tagging-iot.md).

## Afficher une règle
<a name="iot-view-rules"></a>

Utilisez la [list-topic-rules](https://docs.aws.amazon.com/cli/latest/reference/iot/list-topic-rules.html)commande pour répertorier vos règles :

```
aws iot list-topic-rules
```

Utilisez la [get-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/get-topic-rule.html)commande pour obtenir des informations sur une règle :

```
aws iot get-topic-rule --rule-name {{myrule}}
```

## Suppression d'une règle
<a name="iot-delete-rule"></a>

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

**Pour supprimer une règle (AWS CLI)**  
Utilisez la [delete-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-topic-rule.html)commande pour supprimer une règle :

```
aws iot delete-topic-rule --rule-name {{myrule}}
```