Administrar una regla AWS IoT

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

En este tema:

• Etiquetar una regla
• Visualización de una regla
• Eliminar una regla

Etiquetar una regla

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 las reglas para proporcionarle un mayor control sobre cómo y dónde se aplican las reglas a sus recursos y servicios. AWS IoT 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.

IAMejemplo de política

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 usar la siguiente IAM política:

{
    "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 IAM funciones y políticas específicas para una AWS IoT regla, consulte Otorgar a una AWS IoT regla el acceso que requiere

Para obtener información general sobre el etiquetado de recursos, consulte Etiquetar sus recursos AWS IoT.

Visualización de una regla

Usa el list-topic-rulescomando para enumerar tus reglas:

aws iot list-topic-rules

Usa el get-topic-rulecomando para obtener información sobre una regla:

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

Eliminar una regla

Cuando ya no necesite una regla, puede eliminarla.

Para eliminar una regla (AWS CLI)

Usa el delete-topic-rulecomando para eliminar una regla:

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