S3

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

Requisitos

Esta regla tiene los siguientes requisitos:

• Un rol de IAM que AWS IoT 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 únicamente

cannedacl

(Opcional) La lista de control de acceso (ACL) predefinida de Amazon S3 que controla el acceso al objeto identificado mediante la clave de objeto. Para obtener más información, incluidos los valores permitidos, consulte ACL predefinidas.

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 rol de IAM 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 ejemplo de JSON 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": "my-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Véase también

• ¿Qué es Amazon S3 en la Guía del usuario de Amazon Simple Storage Service