Administración Transfer Family eventos usando Amazon EventBridge

Amazon EventBridge es un servicio sin servidor que usa eventos para conectar los componentes de la aplicación, lo que puede facilitar la creación de aplicaciones escalables basadas en eventos. Event-driven la arquitectura es un estilo de creación de sistemas de software poco acoplados que funcionan en conjunto 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 EventBridge predeterminado. 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 objetivos especificados.

Temas

• Transfer Family eventos

• Enviando Transfer Family eventos mediante el uso EventBridge reglas

• Amazon EventBridge permisos

• Adicional EventBridge recursos

• 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 en las que 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 entregan a los objetivos especificados con el máximo esfuerzo o de forma duradera (tenga en cuenta que algunos eventos pueden entregarse fuera de orden). Estos niveles de entrega se describen en la sección Nivel de entrega para los eventos de AWS servicio de la Referencia de EventBridge eventos de Amazon.

• Server-level los eventos para los servidores SFTP, FTPS y FTP se entregan con el máximo esfuerzo.

• Los eventos del conector SFTP se entregan de forma duradera.

• Los eventos AS2 se entregan de forma duradera.

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

Eventos de servidor SFTP, FTPS y FTP

En las tablas siguientes se enumeran los eventos de los servidores SFTP, FTPS y FTP, organizados por tipo de evento.

Eventos de carga y descarga de archivos

Tipo de detalle del evento	Description (Descripción)
Se completó la descarga del archivo del servidor FTP	Se descargó correctamente un archivo para el protocolo FTP.
No se pudo descargar el archivo del servidor FTP	Se ha producido un error al intentar descargar un archivo para el protocolo FTP.
Se completó la carga del archivo del servidor FTP	Se ha cargado correctamente un archivo para el protocolo FTP.
No se pudo cargar el archivo en el servidor FTP	Se ha producido un error al intentar cargar un archivo para el protocolo FTP.
Se completó la descarga del archivo del servidor FTPS	Se descargó correctamente un archivo para el protocolo FTPS.
Falló la descarga del archivo del servidor FTPS	Se ha producido un error al intentar descargar un archivo para el protocolo FTPS.
Se completó la carga del archivo del servidor FTPS	Se ha cargado correctamente un archivo para el protocolo FTPS.
Fallo al cargar el archivo del servidor FTPS	Se ha producido un error al intentar cargar un archivo para el protocolo FTPS.
Se completó la descarga del archivo del servidor SFTP	Se descargó correctamente un archivo para el protocolo SFTP.
Falló la descarga del archivo del servidor SFTP	Se ha producido un error al intentar 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.
Fallo al cargar el archivo del servidor SFTP	Se ha producido un error al intentar cargar un archivo para el protocolo SFTP.

Otros eventos de operaciones con archivos

Tipo de detalle del evento	Description (Descripción)
Se completó la creación del directorio del servidor FTP	Se ha creado correctamente un directorio para el protocolo FTP.
No se pudo crear el directorio del servidor FTP	No se pudo crear un directorio para el protocolo FTP.
Se completó la eliminación del directorio del servidor FTP	Se ha eliminado correctamente un directorio del protocolo FTP.
No se pudo eliminar el directorio del servidor FTP	Se ha producido un error al intentar eliminar un directorio para el protocolo FTP.
Se ha completado la eliminación del archivo del servidor FTP	Se ha eliminado correctamente un archivo para el protocolo FTP.
No se pudo eliminar el archivo del servidor FTP	Se ha producido un error al intentar eliminar un archivo para el protocolo FTP.
Se completó el cambio de nombre del archivo del servidor FTP	Se ha cambiado correctamente el nombre de un archivo para el protocolo FTP.
No se pudo cambiar el nombre del archivo del servidor FTP	Se ha producido un error al intentar cambiar el nombre de un archivo para el protocolo FTP.
Se completó la creación del directorio del servidor FTPS	Se ha creado correctamente un directorio para el protocolo FTPS.
Fallo al crear el directorio del servidor FTPS	No se pudo crear un directorio para el protocolo FTPS.
Se completó la eliminación del directorio del servidor FTPS	Se ha eliminado correctamente un directorio para el protocolo FTPS.
No se pudo eliminar el directorio del servidor FTPS	Se ha producido un error al intentar eliminar un directorio con el protocolo FTPS.
Se ha completado la eliminación del archivo del servidor FTPS	Se ha eliminado correctamente un archivo para el protocolo FTPS.
No se pudo eliminar el archivo del servidor FTPS	Se ha producido un error al intentar eliminar un archivo con el protocolo FTPS.
Se completó el cambio de nombre del archivo del servidor FTPS	Se ha cambiado correctamente el nombre de un archivo para el protocolo FTPS.
No se pudo cambiar el nombre del archivo del servidor FTPS	Se ha producido un error al intentar cambiar el nombre de un archivo con el protocolo FTPS.
Se completó la creación del directorio del servidor SFTP	Se creó correctamente un directorio para el protocolo SFTP.
No se pudo crear el directorio del servidor SFTP	No se pudo crear un directorio para el protocolo SFTP.
Se completó la eliminación del directorio del servidor SFTP	Se ha eliminado correctamente un directorio del protocolo SFTP.
No se pudo eliminar el directorio del servidor SFTP	Se ha producido un error al intentar eliminar un directorio para el protocolo SFTP.
Se completó la eliminación del archivo del servidor SFTP	Se ha eliminado correctamente un archivo para el protocolo SFTP.
No se pudo eliminar el archivo del servidor SFTP	Se ha producido un error al intentar eliminar un archivo para el protocolo SFTP.
Se completó el cambio de nombre del archivo del servidor SFTP	Se cambió correctamente el nombre de un archivo para el protocolo SFTP.
No se pudo cambiar el nombre del archivo del servidor SFTP	Se ha producido un error al intentar cambiar el nombre de un archivo para el protocolo SFTP.

Eventos del conector SFTP

nota

Estos eventos se entregan de forma duradera, tal y como se describe en el apartado Nivel de entrega para eventos de AWS servicio de la sección Amazon EventBridge Events Reference. EventBridge

Tipo de detalle del evento	Description (Descripción)
Se completó el envío del archivo del conector SFTP	La transferencia de archivos desde un conector a un servidor SFTP remoto se completó correctamente.
Error al enviar el archivo del conector SFTP	Se produjo un error en la transferencia de archivos 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 completó correctamente.
Error al recuperar el archivo del conector SFTP	Se produjo un error en la transferencia de archivos desde un servidor SFTP remoto a un conector.
Se completó la lista de directorios de conectores SFTP	Se ha completado correctamente una llamada de lista del directorio de archivos de inicio.
No se pudo enumerar el directorio del conector SFTP	Se produjo un error en la lista de directorios de archivos de inicio.
Se completó el traslado remoto del conector SFTP	Los archivos o directorios se movieron o cambiaron de nombre correctamente en el servidor remoto.
Error al mover el conector SFTP de forma remota	No se pudieron mover o renombrar archivos o directorios en el servidor remoto.
Se completó la eliminación remota del conector SFTP	Los archivos o directorios se eliminaron correctamente en el servidor remoto.
Falló la eliminación remota del conector SFTP	No se pudieron eliminar los archivos o directorios del servidor remoto.

Eventos AS2

nota

Estos eventos se entregan de forma duradera, tal y como se describe en el apartado Nivel de entrega para eventos de AWS servicio de la sección Amazon EventBridge Events Reference. EventBridge

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

Enviando Transfer Family eventos mediante el uso EventBridge reglas

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

Para capturar AWS Transfer Family eventos en Amazon EventBridge

1. Inicia sesión en Consola de administración de AWS y abre la EventBridge consola de Amazon en https://console.aws.amazon.com/events/.

2. En el panel de navegación, selecciona Reglas y, a continuación, elige Crear regla.

3. Introduzca un nombre descriptivo para la regla y, si lo desea, introduzca una descripción.

4. En Tipo de regla, seleccione Regla con un patrón de eventos y, a continuación, elija Siguiente.

5. En la sección Origen del evento, seleccione AWS eventos o eventos EventBridge asociados.

6. En la sección Método de creación, elige Usar forma de patrón.

7. En la sección Patrón de eventos, proporciona la siguiente información.

   1. En Origen de evento, seleccione Servicios de AWS .

   2. Para el AWS servicio, elige Transferir.

   3. Para el tipo de evento, elige el tipo de evento Transfer Family en el que quieres que se active tu regla.

      En función del tipo de evento que haya seleccionado, es posible que aparezca una sección sobre la especificación del tipo de evento 1.

   4. Si ves la sección Especificación 1 del tipo de evento, selecciona los eventos específicos que deseas capturar (o selecciona Cualquier evento para capturar todos los eventos del tipo de evento que hayas seleccionado).

   5. (Opcional) Usa el editor de patrones de eventos para especificar filtros para los detalles del evento.

   6. Elija Siguiente.

8. Elija un objetivo entre las opciones disponibles en Seleccionar objetivos. Elige entre los siguientes objetivos disponibles.

   • AWS servicio. Las opciones más populares son las funciones de Lambda para el procesamiento sin servidor, las colas de Amazon SQS para el procesamiento de mensajes, los temas de Amazon SNS para las notificaciones y para la organización de los flujos de trabajo. AWS Step Functions

   • EventBridge Destino de la API. Si quieres enviar eventos a un punto final HTTP externo AWS, puedes usar un destino de API como destino.

   • EventBridge bus de eventos. Puede enviar eventos a otro bus de eventos, ya sea en la misma cuenta y región o en una cuenta o región diferente.

     Para obtener instrucciones completas sobre la creación de reglas de bus de eventos, consulte Crear reglas que reaccionen a los eventos en la Guía del EventBridge usuario de Amazon.

   Si necesitas ayuda para seleccionar un objetivo, consulta la sección Selección de objetivos en la Guía del EventBridge usuario de Amazon.

9. Configure cualquier opción adicional para su objetivo y, a continuación, seleccione Siguiente.

10. (Opcional) Añada etiquetas a la regla y elija Siguiente.

11. En la pantalla Revisar y crear, si todo está bien, elige Crear regla.

Creación de patrones de eventos para Transfer Family eventos

Cuando Transfer Family envía un evento al bus de eventos predeterminado, EventBridge utiliza el patrón de eventos definido para cada regla para determinar si el evento debe entregarse a los objetivos 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. Para Transfer Family 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 con el que hacer coincidir.

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 realizadas correctamente por el usuariousername:

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

Probando patrones de eventos para Transfer Family eventos en EventBridge

Puedes 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, puedes definir un patrón de eventos y usar un evento de muestra para confirmar que el patrón coincide con los eventos deseados. EventBridge te ofrece la opción de crear una nueva regla utilizando ese patrón de eventos directamente desde el entorno limitado.

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

Amazon EventBridge permisos

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

Los objetivos que especifiques pueden requerir permisos o configuraciones 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 .

Adicional EventBridge recursos

Consulte los siguientes temas de la Guía del Amazon EventBridge usuario para obtener más información sobre cómo usar EventBridge para 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 la creación de patrones de eventos EventBridge para usarlos al comparar 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.