Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administrar una regla AWS IoT
<a name="iot-managae-rule"></a>

Puede utilizar las siguientes acciones para gestionar AWS IoT las reglas.

**Topics**
+ [Etiquetado de una regla](#iot-create-rule-tagging)
+ [Visualización de una regla](#iot-view-rules)
+ [Eliminación de una regla](#iot-delete-rule)

## Etiquetado de una regla
<a name="iot-create-rule-tagging"></a>

Para añadir otro nivel de especificidad a sus reglas nuevas o existentes, puede aplicar el etiquetado. El etiquetado aprovecha los pares clave-valor de sus reglas para proporcionarle un mayor control sobre cómo y dónde se aplican las reglas a sus AWS IoT recursos y servicios. Por ejemplo, puede limitar el alcance de la regla para que solo se aplique en su entorno beta para las pruebas previas al lanzamiento (`Key=environment, Value=beta`) o para capturar todos los mensajes enviados al `iot/test` tema únicamente desde un punto de conexión específico y almacenarlos en un bucket de Amazon S3.

### Ejemplo de política de IAM
<a name="iot-create-rule-tagging-iam-example"></a>

Para ver un ejemplo que muestre cómo conceder permisos de etiquetado a una regla, piense en un usuario que ejecute el siguiente comando para crear una regla y etiquetarla para aplicarla únicamente a su entorno beta.

En el ejemplo, sustituya:
+ *MyTopicRuleName*con el nombre de la regla.
+ *myrule.json*con el nombre del documento de política.

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

Para este ejemplo, debe utilizar la siguiente política de IAM:

****  

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

El ejemplo anterior muestra una regla recién creada llamada `MyTopicRuleName` que solo se aplica a su entorno beta. El `iot:TagResource` en la declaración de política con `MyTopicRuleName` específicamente llamado permite el etiquetado al crear o actualizar `MyTopicRuleName`. El parámetro `--tags "environment=beta"` utilizado al crear la regla limita el alcance de `MyTopicRuleName` únicamente a su entorno beta. Si elimina el parámetro`--tags "environment=beta"`, `MyTopicRuleName` se aplicará a todos los entornos.

Para obtener más información sobre la creación de funciones y políticas de IAM específicas para una regla AWS IoT , consulte [Otorgar a una AWS IoT regla el acceso que requiere](iot-create-role.md)

Para obtener información general sobre el etiquetado de recursos, consulte [Etiquetar sus recursos AWS IoT](tagging-iot.md).

## Visualización de una regla
<a name="iot-view-rules"></a>

Usa el [list-topic-rules](https://docs.aws.amazon.com/cli/latest/reference/iot/list-topic-rules.html)comando para enumerar tus reglas:

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

Usa el [get-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/get-topic-rule.html)comando para obtener información sobre una regla:

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

## Eliminación de una regla
<a name="iot-delete-rule"></a>

Cuando ya no necesite una regla, puede eliminarla.

**Para eliminar una regla (AWS CLI)**  
Usa el [delete-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-topic-rule.html)comando para eliminar una regla:

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