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.

Acción de invocación de una función de Lambda

La acción de Lambda llama al código a través de una función de Lambda y, opcionalmente, se lo notifica a usted a través de Amazon SNS. Esta acción tiene las siguientes opciones y requisitos.

Escritura de la función de Lambda

Para procesar el correo electrónico, la función de Lambda se puede invocar de manera asíncrona (es decir, utilizando el tipo de invocación Event). El objeto de evento transferido a su función de Lambda contendrá metadatos pertenecientes al evento de correo electrónico de entrada. También puede utilizar los metadatos para acceder al contenido del mensaje desde su bucket de Amazon S3.

Si desea controlar realmente el flujo de correo electrónico, debe invocar la función de Lambda de forma síncrona (es decir, utilizando el tipo de invocación RequestResponse) y la función de Lambda debe llamar al método callback con dos argumentos: el primer argumento es null y el segundo argumento es una propiedad disposition que se establece en STOP_RULE, STOP_RULE_SET o CONTINUE. Si el segundo argumento es null o no tiene una propiedad disposition válida, el flujo de correo continúa y se procesan acciones y reglas adicionales, que es lo mismo que con CONTINUE.

Por ejemplo, puede detener el conjunto de reglas de recepción escribiendo la siguiente línea al final del código de la función de Lambda:

callback( null, { "disposition" : "STOP_RULE_SET" });

Para obtener ejemplos de código de AWS Lambda, consulte Ejemplos de funciones de Lambda. Para ver ejemplos de casos de uso de alto nivel, consulte Ejemplos de casos de uso.

Formato de entrada

Amazon SES transfiere información a la función de Lambda en formato JSON. El objeto de nivel superior contiene una matriz Records, que se rellena con las propiedades eventSource, eventVersion y ses. El objeto ses contiene objetos receipt y mail, que tienen exactamente el mismo formato que en las notificaciones de Amazon SNS descritas en Contenido de las notificaciones.

Los datos que Amazon SES transmite a Lambda incluyen metadatos acerca del mensaje, así como varios encabezados de correo electrónico. Sin embargo, no contiene el cuerpo del mensaje.

A continuación, se ofrece una vista de alto nivel de la estructura de la entrada que Amazon SES proporciona a la función de Lambda.

{
   "Records": [
      {
        "eventSource": "aws:ses",
        "eventVersion": "1.0",
        "ses": {
           "receipt": {
               <same contents as SNS notification>
            },
           "mail": {
               <same contents as SNS notification>
           }
         }
     }
   ]
}

Return values

La función de Lambda puede controlar el flujo de correo electrónico devolviendo uno de los siguientes valores: