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, ya sea haciendo el mejor esfuerzo posible o de forma duradera (tenga en cuenta que algunos eventos pueden entregarse fuera de orden). Estos niveles de entrega se describen en Nivel de entrega para eventos de AWS servicio en Amazon EventBridge Events Reference.

  • Los eventos a nivel de servidor 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 AS2 eventos 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 Descripción

Se completó la descarga del archivo del servidor FTP

Se ha descargado correctamente un archivo para el protocolo FTP.

Falló la descarga del archivo del servidor FTP

No se pudo 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 del servidor FTP

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

Se completó la descarga del archivo del servidor FTPS

Se ha descargado correctamente un archivo para el protocolo FTPS.

No se pudo descargar el archivo del servidor FTPS

Se produjo 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.

No se pudo cargar el archivo del servidor 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.

Otros eventos de operaciones de archivos

Tipo de detalle del evento 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

No se pudo eliminar un directorio para el protocolo FTP.

Se completó la eliminación del archivo del servidor FTP

Se ha eliminado correctamente un archivo del protocolo FTP.

No se pudo eliminar el archivo del servidor FTP

No se pudo eliminar un archivo para el protocolo FTP.

Se ha completado el cambio de nombre del archivo del servidor FTP

Se ha cambiado correctamente el nombre de un archivo para el protocolo FTP.

Error al cambiar el nombre del archivo del servidor FTP

No se pudo 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.

No se pudo 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 del protocolo FTPS.

No se pudo eliminar el directorio del servidor FTPS

Se produjo un error al intentar eliminar un directorio para el protocolo FTPS.

Se completó la eliminación del archivo del servidor FTPS

Se ha eliminado correctamente un archivo del protocolo FTPS.

No se pudo eliminar el archivo del servidor FTPS

No se pudo eliminar un archivo con el protocolo FTPS.

Se ha completado el cambio de nombre del archivo del servidor FTPS

Se ha cambiado correctamente el nombre de un archivo para el protocolo FTPS.

Error al cambiar el nombre del archivo del servidor FTPS

No se pudo cambiar el nombre de un archivo para el protocolo FTPS.

Se completó la creación del directorio del servidor SFTP

Se ha creado 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.

Falló la eliminación del directorio del servidor SFTP

Se produjo 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 del protocolo SFTP.

No se pudo eliminar el archivo del servidor SFTP

No se pudo eliminar un archivo para el protocolo SFTP.

Se ha completado el cambio de nombre del archivo del servidor SFTP

Se ha cambiado correctamente el nombre de un archivo para el protocolo SFTP.

Error al cambiar el nombre del archivo del servidor SFTP

No se pudo cambiar el nombre de un archivo para el protocolo SFTP.

Eventos del conector SFTP

nota

Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de entrega para eventos de AWS servicio en la Referencia de EventBridge eventos de Amazon.

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

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

Se completó el traslado remoto del conector SFTP

Los archivos o directorios se movieron o se les cambió el nombre correctamente en el servidor remoto.

Falló el movimiento remoto del conector SFTP

No se pudo mover o cambiar el nombre de los 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.

AS2 eventos

nota

Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de entrega para eventos de AWS servicio en la Referencia de EventBridge eventos de Amazon.

Tipo de detalle del evento Descripción

AS2 Se completó la recepción de carga

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

AS2 Falló la recepción de la carga

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

AS2 Se ha completado el envío de la carga

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

AS2 Falló el envío de la carga

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

AS2 Se completó la recepción de MDN

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

AS2 Falló la recepción de MDN

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

AS2 Se ha completado el envío de MDN

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

AS2 Falló el envío de MDN

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.

Para capturar AWS Transfer Family eventos en Amazon EventBridge
  1. Inicia sesión en la EventBridge consola de Amazon AWS Management Console y ábrela en https://console.aws.amazon.com/events/.

  2. En el panel de navegación, selecciona Reglas y, a continuación, selecciona 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, selecciona AWS eventos o eventos EventBridge asociados.

  6. En la sección Método de creación, selecciona Usar formulario 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, selecciona Transferir.

    3. En Tipo de evento, elige el tipo de evento de Transfer Family que quieres que active tu regla.

      Según el tipo de evento que selecciones, es posible que se te presente una sección con la Especificación del tipo de evento 1.

    4. Si ve la sección Especificación del tipo de evento 1, seleccione los eventos específicos que desee capturar (o seleccione Cualquier evento para capturar todos los eventos del tipo de evento que haya 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 de 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 la computación sin servidor, las colas de Amazon SQS para el procesamiento de mensajes, los temas de Amazon SNS para las notificaciones y para organizar 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 objetivo.

    • 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 detalladas sobre cómo crear reglas de bus de eventos, consulta Cómo 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 Seleccionar objetivos en la Guía del EventBridge usuario de Amazon.

  9. Configura cualquier opción adicional para tu objetivo y, a continuación, selecciona Siguiente.

  10. (Opcional) Añade etiquetas a la regla y selecciona Siguiente.

  11. En la pantalla Revisar y crear, si todo va bien, selecciona Crear regla.

Crear patrones de Transfer Family eventos para eventos

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

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 .

Recursos adicionales de EventBridge

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