Gestión de Transfer Family eventos mediante Amazon EventBridge - AWS Transfer Family

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.

Gestión de Transfer Family eventos mediante Amazon EventBridge

Amazon EventBridge es un servicio sin servidor que utiliza eventos para conectar los componentes de la aplicación, lo que puede facilitar la creación de aplicaciones escalables basadas en eventos. La arquitectura basada en eventos es un estilo de creación de sistemas de software poco acoplados que funcionan juntos emitiendo eventos y respondiendo a ellos. Los eventos representan un cambio en un recurso o entorno.

Como ocurre con muchos AWS servicios, Transfer Family genera y envía eventos al bus de eventos predeterminado. EventBridge Tenga en cuenta que el bus de eventos predeterminado se aprovisiona automáticamente en todas las AWS cuentas. Un bus de eventos es un enrutador que recibe eventos y los envía a cero o más destinos u objetivos. Usted especifica reglas para el bus de eventos que evalúa los eventos a medida que llegan. Cada regla comprueba si un evento coincide con el patrón de evento de la regla. Si el evento coincide, el bus de eventos envía el evento a uno o más destinos específicos.

AWS los servicios envían los eventos al bus de eventos EventBridge predeterminado. Si el evento coincide con el patrón de eventos de una regla, EventBridge envía el evento a los destinos especificados para esa regla.

Transfer Family eventos

Transfer Family envía automáticamente los eventos al bus de EventBridge eventos predeterminado. Puede crear reglas en el bus de eventos, donde cada regla incluya un patrón de eventos y uno o más objetivos. Los eventos que coinciden con el patrón de eventos de una regla se envían a los objetivos especificados haciendo todo lo posible; sin embargo, es posible que algunos eventos se entreguen fuera de orden.

Los siguientes eventos son generados por Transfer Family. Para obtener más información, consulte EventBridge los eventos en la Guía Amazon EventBridge del usuario.

SFTPFTPS, y eventos FTP del servidor

Tipo de detalle del evento Descripción

FTPSe completó la descarga del servidor de archivos

Se ha descargado correctamente un archivo para el FTP protocolo.

FTPFalló la descarga del servidor de archivos

Se produjo un error al intentar descargar un archivo para el FTP protocolo.

FTPSe completó la carga del servidor de archivos

Se ha cargado correctamente un archivo para el FTP protocolo.

FTPNo se pudo cargar el servidor de archivos

Se produjo un error al intentar cargar un archivo para el FTP protocolo.

FTPSSe completó la descarga del servidor de archivos

Se ha descargado correctamente un archivo para el FTPS protocolo.

FTPSFalló la descarga del servidor de archivos

Se produjo un error al intentar descargar un archivo para el FTPS protocolo.

FTPSSe completó la carga del servidor de archivos

Se ha cargado correctamente un archivo para el FTPS protocolo.

FTPSNo se pudo cargar el servidor de archivos

Se produjo un error al intentar cargar un archivo para el FTPS protocolo.

SFTPSe completó la descarga del archivo del servidor

Se ha descargado correctamente un archivo para el SFTP protocolo.

SFTPNo se pudo descargar el archivo del servidor

Se produjo un error al intentar descargar un archivo para el SFTP protocolo.

SFTPSe completó la carga del archivo del servidor

Se ha cargado correctamente un archivo para el SFTP protocolo.

SFTPNo se pudo cargar el archivo del servidor

Se produjo un error al intentar cargar un archivo para el SFTP protocolo.

SFTPeventos de conector

Tipo de detalle del evento Descripción

SFTPSe ha completado el envío del archivo de conector

La transferencia de archivos desde un conector a un SFTP servidor remoto se ha completado correctamente.

SFTPFalló el envío del archivo del conector

Falló la transferencia de un archivo desde un conector a un SFTP servidor remoto.

SFTPSe completó la recuperación del archivo del conector

La transferencia de archivos desde un SFTP servidor remoto a un conector se ha completado correctamente.

SFTPFalló la recuperación del archivo del conector

Falló la transferencia de un archivo desde un SFTP servidor remoto a un conector.

Eventos A2S

Tipo de detalle del evento Descripción

AS2Se completó la recepción de la carga útil

Se ha recibido la carga útil de un AS2 mensaje.

AS2Falló la recepción de la carga

No se ha recibido la carga útil de un AS2 mensaje.

AS2Se ha completado el envío de la carga

La carga útil de un AS2 mensaje se envió correctamente.

AS2Falló el envío de la carga

No se pudo enviar la carga útil de un AS2 mensaje.

AS2MDNRecepción completada

Se ha recibido la notificación de disposición de un AS2 mensaje.

AS2MDNFalló la recepción

No se ha recibido la notificación de disposición de un AS2 mensaje.

AS2MDNSe ha completado el envío

La notificación de disposición de un AS2 mensaje se envió correctamente.

AS2MDNFalló el envío

No se pudo enviar la notificación de disposición de un AS2 mensaje.

Envío de Transfer Family eventos mediante EventBridge reglas

Si desea que el bus de eventos EventBridge predeterminado envíe Transfer Family eventos a un destino, debe crear una regla que contenga un patrón de eventos que coincida con los datos de los Transfer Family eventos que desee.

Puede crear una regla siguiendo estos pasos generales:

  1. Cree un patrón de eventos para la regla que especifique lo siguiente:

    • Transfer Family es el origen de los eventos que evalúa la regla.

    • (Opcional) Cualquier otro dato de evento con el que compararlo.

    Para obtener más información, consulte Crear patrones de eventos para eventos Transfer Family.

  2. (Opcional) Cree un transformador de entrada que personalice los datos del evento antes EventBridge de enviar la información al objetivo de la regla.

    Para obtener más información, consulte Transformación de entrada en la Guía del usuario de EventBridge .

  3. Especifique los destinos a los que desea EventBridge entregar los eventos que coincidan con el patrón de eventos.

    Los objetivos pueden ser otros AWS servicios, aplicaciones de software como servicio (SaaS), API destinos u otros puntos finales personalizados. Para más información, consulte Destinos en la Guía del usuario de EventBridge .

Para obtener instrucciones detalladas sobre cómo crear reglas de bus de eventos, consulte Creación de reglas que reaccionan a eventos en la Guía del usuario de EventBridge .

Crear patrones de eventos para eventos Transfer Family

Cuando Transfer Family entrega un evento al bus de eventos predeterminado, EventBridge utiliza el patrón de eventos definido para cada regla para determinar si el evento debe enviarse a los destinos de la regla. Un patrón de eventos coincide con los datos de los eventos de Transfer Family deseados. Cada patrón de eventos es un JSON objeto que contiene lo siguiente:

  • Un atributo source que identifica el servicio que envía el evento. En el Transfer Family caso de los eventos, la fuente esaws.transfer.

  • (Opcional) Un detail-type atributo que contiene una matriz de los tipos de eventos que deben coincidir.

  • (Opcional) Un detail atributo que contiene cualquier otro dato de evento que pueda compararse.

Por ejemplo, el siguiente patrón de eventos coincide con todos los eventos de Transfer Family:

{ "source": ["aws.transfer"] }

El siguiente ejemplo de patrón de eventos coincide con todos los eventos SFTP del conector:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed", "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"] }

El siguiente ejemplo de patrón de eventos coincide con todos los eventos fallidos de Transfer Family:

{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }

El siguiente ejemplo de patrón de eventos coincide con las SFTP descargas realizadas correctamente por el usuario username:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }

Para obtener más información sobre la escritura de los patrones de eventos, consulte Patrones de eventos en la Guía del usuario de EventBridge .

Probar patrones de Transfer Family eventos para eventos en EventBridge

Puede usar el EventBridge Sandbox para definir y probar rápidamente un patrón de eventos, sin tener que completar el proceso más amplio de crear o editar una regla. Con el Sandbox, puede definir un patrón de eventos y usar un evento de muestra para confirmar que el patrón coincide con los eventos deseados. EventBridge le da la opción de crear una nueva regla mediante el uso de ese patrón de eventos directamente desde el entorno limitado.

Para obtener más información, consulte Probar un patrón de eventos mediante el EventBridge entorno aislado en la Guía del EventBridge usuario.

Amazon EventBridge permisos

Transfer Family no requiere ningún permiso adicional para entregar eventos a Amazon EventBridge.

Es posible que los destinos que especifique requieran permisos o una configuración específicos. Para obtener más información sobre el uso de servicios específicos para los destinos, consulte Destinos de Amazon EventBridge en la Guía del usuario de Amazon EventBridge .

EventBridge Recursos adicionales

Consulte los siguientes temas de la Guía del Amazon EventBridge usuario para obtener más información sobre EventBridge cómo procesar y administrar eventos.

  • Para obtener información detallada sobre cómo funcionan los buses de eventos, consulte bus de eventos de Amazon EventBridge.

  • Para obtener información sobre la estructura de los eventos, consulte Eventos.

  • Para obtener información sobre cómo crear patrones de eventos EventBridge para usarlos cuando se comparan eventos con reglas, consulte Patrones de eventos.

  • Para obtener información sobre la creación de reglas para especificar qué eventos procesa EventBridge , consulte Reglas.

  • Para obtener información sobre cómo especificar los servicios u otros destinos a los que se EventBridge envían los eventos coincidentes, consulte Objetivos.