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.
Temas
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 ha descargado correctamente un archivo para el protocolo FTP. |
|
|
No se pudo descargar un archivo para el protocolo FTP. |
|
|
Se ha cargado correctamente un archivo para el protocolo FTP. |
|
|
Se produjo un error al intentar cargar un archivo para el protocolo FTP. |
|
|
Se ha descargado correctamente un archivo para el protocolo FTPS. |
|
|
Se produjo un error al intentar descargar un archivo para el protocolo FTPS. |
|
|
Se ha cargado correctamente un archivo para el protocolo FTPS. |
|
|
Se produjo un error al intentar cargar un archivo para el protocolo FTPS. |
|
|
Se ha descargado correctamente un archivo para el protocolo SFTP. |
|
|
No se pudo descargar un archivo para el protocolo SFTP. |
|
|
Se ha cargado correctamente un archivo para el protocolo 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 ha creado correctamente un directorio para el protocolo FTP. |
|
|
No se pudo crear un directorio para el protocolo FTP. |
|
|
Se ha eliminado correctamente un directorio del protocolo FTP. |
|
|
No se pudo eliminar un directorio para el protocolo FTP. |
|
|
Se ha eliminado correctamente un archivo del protocolo 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. |
|
No se pudo cambiar el nombre de un archivo para el protocolo FTP. |
|
|
Se ha creado correctamente un directorio para el protocolo FTPS. |
|
|
No se pudo crear un directorio para el protocolo FTPS. |
|
|
Se ha eliminado correctamente un directorio del protocolo FTPS. |
|
|
Se produjo un error al intentar eliminar un directorio para el protocolo FTPS. |
|
|
Se ha eliminado correctamente un archivo del protocolo 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. |
|
No se pudo cambiar el nombre de un archivo para el protocolo FTPS. |
|
|
Se ha creado correctamente un directorio para el protocolo SFTP. |
|
|
No se pudo crear un directorio para el protocolo SFTP. |
|
|
Se ha eliminado correctamente un directorio del protocolo SFTP. |
|
|
Se produjo un error al intentar eliminar un directorio para el protocolo SFTP. |
|
|
Se ha eliminado correctamente un archivo del protocolo 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. |
|
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 |
|---|---|
| La transferencia de archivos desde un conector a un servidor SFTP remoto se ha completado correctamente. | |
| Se produjo un error en la transferencia de archivos desde un conector a un servidor SFTP remoto. | |
| La transferencia de archivos desde un servidor SFTP remoto a un conector se ha completado correctamente. | |
| Falló la transferencia de un archivo desde un servidor SFTP remoto a un conector. | |
| Una llamada a la lista del directorio de archivos de inicio que se completó correctamente. | |
| Error en la lista del directorio de archivos de inicio. | |
| Los archivos o directorios se movieron o se les cambió el nombre correctamente en el servidor remoto. | |
| No se pudo mover o cambiar el nombre de los archivos o directorios en el servidor remoto. | |
| Los archivos o directorios se eliminaron correctamente en el servidor remoto. | |
| 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 |
|---|---|
| Se ha recibido la carga útil de un AS2 mensaje. | |
| No se ha recibido la carga útil de un AS2 mensaje. | |
| La carga útil de un AS2 mensaje se envió correctamente. | |
| No se pudo enviar la carga útil de un AS2 mensaje. | |
| Se ha recibido la notificación de disposición de un AS2 mensaje. | |
| No se ha recibido la notificación de disposición de un AS2 mensaje. | |
| La notificación de disposición de un AS2 mensaje se envió correctamente. | |
| 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
-
Inicia sesión en la EventBridge consola de Amazon AWS Management Console y ábrela en https://console.aws.amazon.com/events/
. -
En el panel de navegación, selecciona Reglas y, a continuación, selecciona Crear regla.
-
Introduzca un nombre descriptivo para la regla y, si lo desea, introduzca una descripción.
-
En Tipo de regla, seleccione Regla con un patrón de eventos y, a continuación, elija Siguiente.
-
En la sección Origen del evento, selecciona AWS eventos o eventos EventBridge asociados.
-
En la sección Método de creación, selecciona Usar formulario de patrón.
-
En la sección Patrón de eventos, proporciona la siguiente información.
-
En Origen de evento, seleccione Servicios de AWS .
-
Para el AWS servicio, selecciona Transferir.
-
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.
-
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).
-
(Opcional) Usa el editor de patrones de eventos para especificar filtros para los detalles del evento.
-
Elija Siguiente.
-
-
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.
-
-
Configura cualquier opción adicional para tu objetivo y, a continuación, selecciona Siguiente.
-
(Opcional) Añade etiquetas a la regla y selecciona Siguiente.
-
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
sourceque identifica el servicio que envía el evento. En el Transfer Family caso de los eventos, la fuente esaws.transfer. -
(Opcional) Un
detail-typeatributo que contiene una matriz de los tipos de eventos que deben coincidir. -
(Opcional) Un
detailatributo 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.