Administración de una regla de AWS IoT - AWS IoT Core
Etiquetado de una reglaVisualización de una reglaEliminación de una regla

Administración de una regla de AWS IoT

Puede utilizar las siguientes acciones para administrar las reglas de AWS IoT.

Etiquetado de 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.

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 por 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:

JSON
{
    "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 regla AWS IoT el acceso que requiere

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

Visualización de una regla

Ejecute el comando list-topic-rules para visualizar una lista de sus reglas:

aws iot list-topic-rules

Ejecute el comando get-topic-rule para obtener información acerca de una regla:

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

Eliminación de una regla

Cuando ya no necesite una regla, puede eliminarla.

Para eliminar una regla (AWS CLI)

Ejecute el comando delete-topic-rule para eliminar una regla:

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