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.

Temas

• Transfer Family eventos
• Envío de Transfer Family eventos mediante reglas EventBridge
• Amazon EventBridge permisos
• EventBridge Recursos adicionales
• Transfer Family referencia detallada de los eventos

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.

Eventos de servidores SFTP, FTPS y FTP

Tipo de detalle del evento	Descripción
Se completó la descarga del servidor de archivos FTP	Se ha descargado correctamente un archivo para el protocolo FTP.
Falló la descarga del servidor de archivos FTP	Se produjo un error al intentar descargar un archivo para el protocolo FTP.
Se completó la carga del servidor de archivos FTP	Se ha cargado correctamente un archivo para el protocolo FTP.
Error al cargar el servidor de archivos FTP	Se produjo un error al intentar cargar un archivo para el protocolo FTP.
Se completó la descarga del servidor de archivos FTPS	Se ha descargado correctamente un archivo para el protocolo FTPS.
Falló la descarga del servidor de archivos FTPS	No se pudo descargar un archivo para el protocolo FTPS.
Se completó la carga del servidor de archivos FTPS	Se ha cargado correctamente un archivo para el protocolo FTPS.
Error al cargar el servidor de archivos FTPS	Se produjo un error al intentar cargar un archivo para el protocolo FTPS.
Se completó la descarga del archivo del servidor SFTP	Se ha descargado correctamente un archivo para el protocolo SFTP.
Falló la descarga del archivo del servidor SFTP	No se pudo descargar un archivo para el protocolo SFTP.
Se completó la carga del archivo del servidor SFTP	Se ha cargado correctamente un archivo para el protocolo SFTP.
No se pudo cargar el archivo del servidor SFTP	Se produjo un error al intentar cargar un archivo para el protocolo SFTP.

Eventos del conector SFTP

Tipo de detalle del evento	Descripción
Se ha completado el envío del archivo del conector SFTP	La transferencia de archivos desde un conector a un servidor SFTP remoto se ha completado correctamente.
Falló el envío del archivo del conector SFTP	Falló la transferencia de un archivo desde un conector a un servidor SFTP remoto.
Se completó la recuperación del archivo del conector SFTP	La transferencia de archivos desde un servidor SFTP remoto a un conector se ha completado correctamente.
Falló la recuperación del archivo del conector SFTP	Falló la transferencia de un archivo desde un servidor SFTP remoto a un conector.
Se completó la lista del directorio de conectores SFTP	Una llamada a la lista del directorio de archivos de inicio que se completó correctamente.
Error en la lista del directorio de conectores SFTP	Error en la lista del directorio de archivos de inicio.

Eventos A2S

Tipo de detalle del evento	Descripción
Se completó la recepción de carga útil del AS2	Se ha recibido la carga útil de un mensaje AS2.
Falló la recepción de la carga útil del AS2	No se ha recibido la carga útil de un mensaje AS2.
Se ha completado el envío de la carga útil AS2	La carga útil de un mensaje AS2 se envió correctamente.
Falló el envío de la carga útil AS2	No se pudo enviar la carga útil de un mensaje AS2.
Se completó la recepción de AS2 MDN	Se ha recibido la notificación de disposición de un mensaje AS2.
Falló la recepción de MDN de AS2	No se ha recibido la notificación de disposición de un mensaje AS2.
Se ha completado el envío de AS2 MDN	La notificación de disposición de un mensaje AS2 se envió correctamente.
Falló el envío de MDN de AS2	No se pudo enviar la notificación de disposición de un mensaje AS2.

Envío de Transfer Family eventos mediante reglas EventBridge

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), destinos de API 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 objeto JSON 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 del conector SFTP:

{
  "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 descargas de SFTP correctas para el nombre de usuario:

{
  "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 Targets.