S3 - AWS IoT Core
RequisitosParámetrosEjemplosVéase también

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.

S3

La acción S3 (s3) escribe los datos de un MQTT mensaje en un bucket de Amazon Simple Storage Service (Amazon S3).

Requisitos

Esta regla tiene los siguientes requisitos:

  • Un IAM rol que AWS IoT se puede asumir para realizar la s3:PutObject operación. Para obtener más información, consulte Otorgar a una AWS IoT regla el acceso que requiere.

    En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.

  • Si utiliza un servicio AWS KMS gestionado por el cliente AWS KMS key para cifrar los datos en reposo en Amazon S3, el servicio debe tener permiso para utilizarlos AWS KMS key en nombre de la persona que llama. Para obtener más información, consulte AWS Administrado AWS KMS keys y administrado por el cliente AWS KMS keys en la Guía para desarrolladores de Amazon Simple Storage Service.

Parámetros

Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:

bucket

El bucket de Amazon S3 en el que se escribirán los datos.

Admite plantillas de sustitución: API y AWS CLI solo

cannedacl

(Opcional) El Amazon S3 predeterminado ACL que controla el acceso al objeto identificado por la clave del objeto. Para obtener más información, incluidos los valores permitidos, consulte Bloqueado ACL.

Admite plantillas de sustitución: No

key

La ruta al archivo en el que se escriben los datos.

Considere un ejemplo en el que se encuentra este parámetro ${topic()}/${timestamp()} y la regla recibe un mensaje donde se encuentra el tema some/topic. Si la marca de tiempo actual es 1460685389, esta acción escribe los datos en un archivo llamado 1460685389 en la carpeta some/topic del bucket de S3

nota

Si usa una clave estática, AWS IoT sobrescribe un solo archivo cada vez que se invoque la regla. Le recomendamos que utilice la marca de tiempo del mensaje u otro identificador de mensaje único para que se guarde un nuevo archivo en Amazon S3 por cada mensaje recibido.

Admite plantillas de sustitución: Sí

roleArn

El IAM rol que permite el acceso al bucket de Amazon S3. Para obtener más información, consulte Requisitos.

Admite plantillas de sustitución: No

Ejemplos

El siguiente JSON ejemplo define una acción de S3 en una AWS IoT regla.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "s3": {
                    "bucketName": "amzn-s3-demo-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Véase también