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
<a name="eventbridge"></a>

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 de acoplamiento débil 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 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 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.\]](http://docs.aws.amazon.com/es_es/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [Transfer Family eventos](#supported-events)
+ [Enviar Transfer Family eventos mediante EventBridge reglas](#eventbridge-using-events-rules)
+ [Amazon EventBridge permisos](#eventbridge-permissions)
+ [EventBridge Recursos adicionales](#eventbridge-additonal-resources)
+ [Transfer Family referencia detallada de los eventos](events-detail-reference.md)

## Transfer Family eventos
<a name="supported-events"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del usuario de Amazon EventBridge *.

### Eventos de servidor SFTP, FTPS y FTP
<a name="supported-events-servers"></a>

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](events-detail-reference.md#event-detail-server-events)  |  Se ha descargado correctamente un archivo para el protocolo FTP.  | 
|  [Falló la descarga del archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar descargar un archivo para el protocolo FTP.  | 
|  [Se completó la carga del archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se ha cargado correctamente un archivo para el protocolo FTP.  | 
|  [No se pudo cargar el archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar cargar un archivo para el protocolo FTP.  | 
|  [Se completó la descarga del archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha descargado correctamente un archivo para el protocolo FTPS.  | 
|  [No se pudo descargar el archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar descargar un archivo para el protocolo FTPS.  | 
|  [Se completó la carga del archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha cargado correctamente un archivo para el protocolo FTPS.  | 
|  [No se pudo cargar el archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar cargar un archivo para el protocolo FTPS.  | 
|  [Se completó la descarga del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha descargado correctamente un archivo para el protocolo SFTP.  | 
|  [Falló la descarga del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo descargar un archivo para el protocolo SFTP.  | 
|  [Se completó la carga del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha cargado correctamente un archivo para el protocolo SFTP.  | 
|  [No se pudo cargar el archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar cargar un archivo para el protocolo SFTP.  | 

**Otros eventos de operaciones de archivos**


| Tipo de detalle del evento | Description (Descripción) | 
| --- | --- | 
|  [Se completó la creación del directorio del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se ha creado correctamente un directorio para el protocolo FTP.  | 
|  [No se pudo crear el directorio del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo crear un directorio para el protocolo FTP.  | 
|  [Se completó la eliminación del directorio del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un directorio del protocolo FTP.  | 
|  [No se pudo eliminar el directorio del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo eliminar un directorio para el protocolo FTP.  | 
|  [Se completó la eliminación del archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un archivo del protocolo FTP.  | 
|  [No se pudo eliminar el archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo eliminar un archivo para el protocolo FTP.  | 
|  [Se ha completado el cambio de nombre del archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  Se ha cambiado correctamente el nombre de un archivo para el protocolo FTP.  | 
|  [Error al cambiar el nombre del archivo del servidor FTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo cambiar el nombre de un archivo para el protocolo FTP.  | 
|  [Se completó la creación del directorio del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha creado correctamente un directorio para el protocolo FTPS.  | 
|  [No se pudo crear el directorio del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  No se pudo crear un directorio para el protocolo FTPS.  | 
|  [Se completó la eliminación del directorio del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un directorio del protocolo FTPS.  | 
|  [No se pudo eliminar el directorio del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se produjo un error al intentar eliminar un directorio para el protocolo FTPS.  | 
|  [Se completó la eliminación del archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un archivo del protocolo FTPS.  | 
|  [No se pudo eliminar el archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  No se pudo eliminar un archivo con el protocolo FTPS.  | 
|  [Se ha completado el cambio de nombre del archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  Se ha cambiado correctamente el nombre de un archivo para el protocolo FTPS.  | 
|  [Error al cambiar el nombre del archivo del servidor FTPS](events-detail-reference.md#event-detail-server-events)  |  No se pudo cambiar el nombre de un archivo para el protocolo FTPS.  | 
|  [Se completó la creación del directorio del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha creado correctamente un directorio para el protocolo SFTP.  | 
|  [No se pudo crear el directorio del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo crear un directorio para el protocolo SFTP.  | 
|  [Se completó la eliminación del directorio del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un directorio del protocolo SFTP.  | 
|  [Falló la eliminación del directorio del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo eliminar un directorio para el protocolo SFTP.  | 
|  [Se completó la eliminación del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha eliminado correctamente un archivo del protocolo SFTP.  | 
|  [No se pudo eliminar el archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo eliminar un archivo para el protocolo SFTP.  | 
|  [Se ha completado el cambio de nombre del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  Se ha cambiado correctamente el nombre de un archivo para el protocolo SFTP.  | 
|  [Error al cambiar el nombre del archivo del servidor SFTP](events-detail-reference.md#event-detail-server-events)  |  No se pudo cambiar el nombre de un archivo para el protocolo SFTP.  | 

### Eventos del conector SFTP
<a name="supported-events-connectors"></a>

**nota**  
Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de [entrega para eventos de AWS servicio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) en la *Referencia de EventBridge eventos de Amazon*.


| Tipo de detalle del evento | Description (Descripción) | 
| --- | --- | 
|  [Se ha completado el envío del archivo del conector SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | 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](events-detail-reference.md#event-detail-sftp-connector-events)  | 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](events-detail-reference.md#event-detail-sftp-connector-events)  | 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](events-detail-reference.md#event-detail-sftp-connector-events)  | Falló la transferencia de un archivo desde un servidor SFTP remoto a un conector. | 
|  [Se completó la lista del directorio de conectores SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | Una llamada a la lista del directorio de archivos de inicio que se completó correctamente. | 
|  [Error en la lista del directorio de conectores SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | Error en la lista del directorio de archivos de inicio. | 
|  [Se completó el traslado remoto del conector SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | Los archivos o directorios se movieron o se les cambió el nombre correctamente en el servidor remoto. | 
|  [Falló el movimiento remoto del conector SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | 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](events-detail-reference.md#event-detail-sftp-connector-events)  | Los archivos o directorios se eliminaron correctamente en el servidor remoto. | 
|  [Falló la eliminación remota del conector SFTP](events-detail-reference.md#event-detail-sftp-connector-events)  | No se pudieron eliminar los archivos o directorios del servidor remoto. | 

### AS2 eventos
<a name="supported-events-as2"></a>

**nota**  
Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de [entrega para eventos de AWS servicio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) en la *Referencia de EventBridge eventos de Amazon*.


| Tipo de detalle del evento | Description (Descripción) | 
| --- | --- | 
|  [AS2 Se ha completado la recepción de la carga](events-detail-reference.md#event-detail-as2-server-events)  | Se ha recibido la carga útil de un AS2 mensaje. | 
|  [AS2 Falló la recepción de la carga](events-detail-reference.md#event-detail-as2-server-events)  | No se ha recibido la carga útil de un AS2 mensaje. | 
|  [AS2 Se ha completado el envío de la carga](events-detail-reference.md#event-detail-as2-server-events)  | La carga útil de un AS2 mensaje se envió correctamente. | 
|  [AS2 Falló el envío de la carga](events-detail-reference.md#event-detail-as2-server-events)  | No se pudo enviar la carga útil de un AS2 mensaje. | 
|  [AS2 Se completó la recepción de MDN](events-detail-reference.md#event-detail-as2-server-events)  | Se ha recibido la notificación de disposición de un AS2 mensaje. | 
|  [AS2 Falló la recepción de MDN](events-detail-reference.md#event-detail-as2-server-events)  | No se ha recibido la notificación de disposición de un AS2 mensaje. | 
|  [AS2 Envío de MDN completado](events-detail-reference.md#event-detail-as2-server-events)  | La notificación de disposición de un AS2 mensaje se envió correctamente. | 
|  [AS2 Falló el envío de MDN](events-detail-reference.md#event-detail-as2-server-events)  | No se pudo enviar la notificación de disposición de un AS2 mensaje. | 

## Enviar Transfer Family eventos mediante EventBridge reglas
<a name="eventbridge-using-events-rules"></a>

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 Consola de administración de AWS y ábrela en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

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

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

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

1. En la sección **Origen del evento**, selecciona **AWS eventos o eventos EventBridge asociados**.

1. En la sección **Método de creación**, selecciona **Usar formulario de patrón**.

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

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

   1. Para el **AWS servicio**, selecciona **Transferir**.

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

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

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

   1. Elija **Siguiente**.

1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la *Guía del EventBridge usuario de Amazon*. 

   Si necesitas ayuda para seleccionar un objetivo, consulta la sección [Seleccionar objetivos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target) en la *Guía del EventBridge usuario de Amazon*.

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

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

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

### Crear patrones de Transfer Family eventos para eventos
<a name="eventbridge-using-events-rules-patterns"></a>

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 es`aws.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 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) en la *Guía del usuario de EventBridge *.

### Probar patrones de Transfer Family eventos para eventos en EventBridge
<a name="eventbridge-using-events-testing"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) en la Guía del *EventBridge usuario*.

## Amazon EventBridge permisos
<a name="eventbridge-permissions"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) en la *Guía del usuario de Amazon EventBridge *.

## EventBridge Recursos adicionales
<a name="eventbridge-additonal-resources"></a>

Consulte los siguientes temas de la [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html).
+ Para obtener información sobre la estructura de los eventos, consulte [Eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
+ Para obtener información sobre cómo crear patrones de eventos EventBridge para usarlos cuando se comparan eventos con reglas, consulte [Patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html).
+ Para obtener información sobre la creación de reglas para especificar qué eventos procesa EventBridge , consulte [Reglas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
+ 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).

# Transfer Family referencia detallada de los eventos
<a name="events-detail-reference"></a>

Todos los eventos de AWS los servicios tienen un conjunto común de campos que contienen metadatos sobre el evento. Estos metadatos pueden incluir el AWS servicio que es el origen del evento, la hora en que se generó el evento, la cuenta y la región en las que tuvo lugar el evento, entre otros. Para ver las definiciones de estos campos generales, consulte [Referencia de estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del usuario de Amazon EventBridge *. 

Además, cada evento tiene un campo `detail` que contiene datos específicos de ese evento en particular. La siguiente referencia define los campos de detalle de los distintos Transfer Family eventos.

Cuando utilice EventBridge para seleccionar y gestionar Transfer Family eventos, tenga en cuenta lo siguiente:
+ El `source` campo para todos los eventos de Transfer Family está establecido en`aws.transfer`.
+ El campo `detail-type` especifica el tipo de evento. 

  Por ejemplo, `FTP Server File Download Completed`.
+ El campo `detail` contiene los datos específicos de ese evento en particular. 

Para obtener más información sobre cómo construir patrones de eventos que permitan que las reglas coincidan con los eventos de Transfer Family , consulte [Patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) en la *Guía del usuario de Amazon EventBridge *.

Para obtener más información sobre los eventos y cómo EventBridge los procesa, consulte [Amazon EventBridge los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) en la *Guía del Amazon EventBridge usuario*.

**Topics**
+ [Eventos de servidores SFTP, FTPS y FTP](#event-detail-server-events)
+ [Eventos del conector SFTP](#event-detail-sftp-connector-events)
+ [AS2 eventos](#event-detail-as2-server-events)

## Eventos de servidores SFTP, FTPS y FTP
<a name="event-detail-server-events"></a>

Los siguientes son los campos detallados de los eventos de los servidores SFTP, FTPS y FTP:
+ Se completó la creación del directorio del servidor FTP
+ No se pudo crear el directorio del servidor FTP
+ Se completó la eliminación del directorio del servidor FTP
+ Falló la eliminación del directorio del servidor FTP
+ Se completó la eliminación del archivo del servidor FTP
+ No se pudo eliminar el archivo del servidor FTP
+ Se completó la descarga del archivo del servidor FTP
+ Falló la descarga del archivo del servidor FTP
+ Se ha completado el cambio de nombre del archivo del servidor FTP
+ Falló el cambio de nombre del archivo del servidor FTP
+ Se completó la carga del archivo del servidor FTP
+ Falló la carga del archivo del servidor FTP
+ Se completó la creación del directorio del servidor FTPS
+ No se pudo crear el directorio del servidor FTPS
+ Se completó la eliminación del directorio del servidor FTPS
+ Falló la eliminación del directorio del servidor FTPS
+ Se completó la eliminación del archivo del servidor FTPS
+ No se pudo eliminar el archivo del servidor FTPS
+ Se completó la descarga del archivo del servidor FTPS
+ Falló la descarga del archivo del servidor FTPS
+ Se ha completado el cambio de nombre del archivo del servidor FTPS
+ Error al cambiar el nombre del archivo del servidor FTPS
+ Se completó la carga del archivo del servidor FTPS
+ Error al cargar el archivo del servidor FTPS
+ Se completó la creación del directorio del servidor SFTP
+ No se pudo crear el directorio del servidor SFTP
+ Se completó la eliminación del directorio del servidor SFTP
+ Falló la eliminación del directorio del servidor SFTP
+ Se completó la eliminación del archivo del servidor SFTP
+ Falló la eliminación del archivo del servidor SFTP
+ Se completó la descarga del archivo del servidor SFTP
+ Falló la descarga del archivo del servidor SFTP
+ Se completó el cambio de nombre del archivo del servidor SFTP
+ Error al cambiar el nombre del archivo del servidor SFTP
+ Se completó la carga del archivo del servidor SFTP
+ Falló la carga del archivo del servidor SFTP

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los Transfer Family eventos. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "failure-code" : "string",
    "status-code" : "string",
    "protocol" : "string",
    "bytes" : "number",
    "client-ip" : "string",
    "failure-message" : "string",
    "end-timestamp" : "string",
    "etag" : "string",
    "file-path" : "string",
    "original-file-path" : "string",
    "renamed-file-path" : "string",
    "directory-path" : "string",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
```

`detail-type`  <a name="event-detail-server-events-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, el valor es uno de los nombres de eventos del servidor SFTP, FTPS o FTP enumerados anteriormente.

`source`  <a name="event-detail-server-events-source"></a>
Identifica el servicio que generó el evento. Para los eventos de Transfer Family, este valor es`aws.transfer`.

`detail`  <a name="sftp-server-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, los datos incluyen lo siguiente:    
`failure-code`  <a name="sftp-server-failure-code"></a>
Categoría por la que se produjo un error en la transferencia. Valores: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
Si la transferencia se ha realizado correctamente. Valores:`COMPLETED | FAILED`.  
`protocol`  <a name="sftp-server-protocol"></a>
El protocolo utilizado para la transferencia. Valores: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
Número de bytes transferidos.  
`client-ip`  <a name="sftp-server-client-ip"></a>
La dirección IP del cliente implicado en la transferencia  
`failure-message`  <a name="sftp-server-failure-message"></a>
En el caso de las transferencias fallidas, los detalles del motivo por el que se produjo el error en la transferencia.  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que se termina de procesar el archivo.  
`etag`  <a name="sftp-server-etag"></a>
La etiqueta de entidad (solo se usa para los archivos de Amazon S3).  
`file-path`  <a name="sftp-server-file-path"></a>
La ruta al archivo que se está transfiriendo, eliminando o utilizando de alguna otra forma.  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
En el caso de eventos de cambio de nombre de archivos, la ruta original del archivo antes de cambiarle el nombre.  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
En el caso de los eventos de cambio de nombre de archivos, la nueva ruta del archivo tras el cambio de nombre.  
`directory-path`  <a name="sftp-server-directory-path"></a>
En el caso de los eventos de creación y eliminación de directorios, la ruta del directorio.  
`server-id`  <a name="sftp-server-server-id"></a>
El identificador único del servidor Transfer Family.  
`username`  <a name="sftp-server-username"></a>
El usuario que realiza la transferencia.  
`session-id`  <a name="sftp-server-session-id"></a>
El identificador único de la sesión de transferencia.  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que comienza el procesamiento de los archivos.

**Example Ejemplo de evento fallido al descargar un archivo del servidor SFTP**  <a name="event-detail-server-events.example"></a>
El siguiente ejemplo muestra un evento en el que se produjo un error de descarga en un servidor SFTP (si Amazon EFS se está utilizando el almacenamiento).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Download Failed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T17:20:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "failure-code": "PARTIAL_DOWNLOAD",
        "status-code": "FAILED",
        "protocol": "SFTP",
        "bytes": 4100,
        "client-ip": "IP-address",
        "failure-message": "File was partially downloaded.",
        "end-timestamp": "2024-01-29T17:20:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2024-01-29T17:20:16.706282454Z"
    }
}
```

**Example Ejemplo de evento: se completó la carga de un archivo en un servidor FTP**  <a name="event-detail-server-events.example"></a>
El siguiente ejemplo muestra un evento en el que una carga se completó correctamente en un servidor FTP (Amazon S3 si se está utilizando el almacenamiento).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "FTP Server File Upload Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T16:31:43Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1111aaaa2222bbbb3"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "FTP",
        "bytes": 1048576,
        "client-ip": "10.0.0.141",
        "end-timestamp": "2024-01-29T16:31:43.311866408Z",
        "etag": "b6d81b360a5672d80c27430f39153e2c",
        "file-path": "/amzn-s3-demo-bucket/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}
```

**Example Ejemplo de evento: se completó la eliminación de archivos del servidor SFTP**  <a name="event-detail-server-events.example"></a>
El siguiente ejemplo muestra un evento en el que un archivo se eliminó correctamente en un servidor SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Delete Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T14:30:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T14:30:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file-to-delete.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T14:30:26.706282454Z"
    }
}
```

**Example Ejemplo de cambio de nombre de archivo del servidor SFTP completado**  <a name="event-detail-server-events.example"></a>
El siguiente ejemplo muestra un evento en el que se cambió correctamente el nombre de un archivo en un servidor SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Rename Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T15:45:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T15:45:12.749749117Z",
        "original-file-path": "/fs-1234abcd5678efghi/user0/old-filename.txt",
        "renamed-file-path": "/fs-1234abcd5678efghi/user0/new-filename.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T15:45:11.706282454Z"
    }
}
```

**Example Ejemplo de evento de creación completa del directorio del servidor SFTP**  <a name="event-detail-server-events.example"></a>
El siguiente ejemplo muestra un evento en el que se creó correctamente un directorio en un servidor SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server Directory Create Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T16:20:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T16:20:05.749749117Z",
        "directory-path": "/fs-1234abcd5678efghi/user0/new-directory",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T16:20:04.706282454Z"
    }
}
```

## Eventos del conector SFTP
<a name="event-detail-sftp-connector-events"></a>

**nota**  
Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de [entrega para eventos de AWS servicio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) en la *Referencia de EventBridge eventos de Amazon*.

Los siguientes son los campos de detalle de los eventos del conector SFTP:
+ Se ha completado el envío del archivo del conector SFTP
+ Falló el envío del archivo del conector SFTP
+ Se completó la recuperación del archivo del conector SFTP
+ Falló la recuperación del archivo del conector SFTP
+ Se completó el listado del directorio de conectores SFTP
+ Falló la lista del directorio de conectores SFTP
+ Se completó el movimiento remoto del conector SFTP
+ Falló el movimiento remoto del conector SFTP
+ Se completó la eliminación remota del conector SFTP
+ Falló la eliminación remota del conector SFTP

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los Transfer Family eventos. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "operation" : "string",
    "max-items" : "number",
    "connector-id" : "string",
    "output-directory-path" : "string",
    "listing-id" : "string",
    "transfer-id" : "string",
    "file-transfer-id" : "string",
    "url" : "string",
    "file-path" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "local-directory-path" : "string",
    "remote-directory-path" : "string"
    "item-count" : "number"
    "truncated" : "boolean"
    "bytes" : "number",
    "egress-type" : "string",
    "vpc-lattice-resource-configuration-arn" : "string",
    "vpc-lattice-port-number" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
    "output-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    }
  }
}
```

`detail-type`  <a name="event-detail-sftp-connector-events-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, el valor es uno de los nombres de eventos del conector SFTP enumerados anteriormente.

`source`  <a name="event-detail-sftp-connector-events-source"></a>
Identifica el servicio que generó el evento. Para Transfer Family los eventos, este valor es`aws.transfer`.

`detail`  <a name="sftp-connector-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, los datos incluyen lo siguiente:    
`max-items`  <a name="sftp-connector-max-items"></a>
El número máximo de directory/file nombres que se van a devolver.  
`operation`  <a name="sftp-connector-operation"></a>
Si la `StartFileTransfer` solicitud envía o recupera un archivo. Valores:`SEND|RETRIEVE`.  
`connector-id`  <a name="sftp-connector-connector-id"></a>
El identificador único del conector SFTP que se está utilizando.  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
La ruta (bucket y prefijo) en Amazon S3 para almacenar los resultados del file/directory listado.  
`listing-id`  <a name="sftp-connector-listing-id"></a>
Un identificador único para la operación de la `StartDirectoryListing` API. Este identificador se puede utilizar para comprobar CloudWatch los registros y ver el estado de la solicitud de listado.  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
El identificador único del evento de transferencia (una `StartFileTransfer` solicitud).  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
El identificador único del archivo que se está transfiriendo.  
`url`  <a name="sftp-connector-url"></a>
La URL del punto final SFTP AS2 o del socio.  
`file-path`  <a name="sftp-connector-file-path"></a>
La ubicación y el archivo que se están enviando o recuperando.  
`status-code`  <a name="sftp-connector-status-code"></a>
Si la transferencia se ha realizado correctamente. Valores:`FAILED | COMPLETED`.   
`failure-code`  <a name="sftp-connector-failure-code"></a>
En el caso de transferencias fallidas, el código del motivo por el que se produjo el error en la transferencia.  
`failure-message`  <a name="sftp-connector-failure-message"></a>
En el caso de las transferencias fallidas, los detalles del motivo del error en la transferencia.  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que se inicia el procesamiento del archivo.  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que se completa el procesamiento del archivo.  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
En el caso de `RETRIEVE` las solicitudes, la ubicación en la que se debe colocar el archivo recuperado.  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
En el caso de `SEND` las solicitudes, el directorio de archivos en el que se va a colocar el archivo en el servidor SFTP del socio. Es el valor `RemoteDirectoryPath` que el usuario ha transferido a la `StartFileTransfer` solicitud. Puede especificar un directorio predeterminado en el servidor SFTP del socio. Si es así, este campo está vacío.  
`item-count`  <a name="sftp-connector-item-count"></a>
El número de elementos (directorios y archivos) devueltos para la solicitud de listado.  
`truncated`  <a name="sftp-connector-truncated"></a>
Si el resultado de la lista contiene todos los elementos contenidos en el directorio remoto o no.  
`bytes`  <a name="sftp-connector-bytes"></a>
El número de bytes que se están transfiriendo. El valor es 0 para las transferencias fallidas.  
`egress-type`  <a name="sftp-connector-egress-type"></a>
Tipo de configuración de salida del conector. Valores: `SERVICE_MANAGED` o. `VPC_LATTICE`  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
ARN de la configuración de recursos VPC\$1LATTICE que define la ubicación del servidor SFTP de destino. Este campo es nulo para los conectores gestionados por servicios.  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
Número de puerto para conectarse al servidor SFTP a través de VPC\$1LATTICE.  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
Este parámetro contiene los detalles de la ubicación del archivo de almacenamiento. AWS     
`domain`  <a name="sftp-connector-domain"></a>
El almacenamiento que se está utilizando. Actualmente, el único valor es`S3`.  
`bucket`  <a name="sftp-connector-bucket"></a>
El contenedor del objeto en Amazon S3.  
`key`  <a name="sftp-connector-key"></a>
El nombre asignado al objeto en Amazon S3.  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
Este parámetro contiene los detalles de la ubicación en la que se almacenarán los resultados de la lista de AWS directorios.    
`domain`  <a name="sftp-connector-output-domain"></a>
El almacenamiento que se está utilizando. Actualmente, el único valor es`S3`.  
`bucket`  <a name="sftp-connector-output-bucket"></a>
El contenedor del objeto en Amazon S3.  
`key`  <a name="sftp-connector-output-key"></a>
El nombre asignado al objeto en Amazon S3.

**Example Ejemplo de evento fallido al enviar el archivo del conector SFTP**  <a name="event-detail-sftp-connector-events.example"></a>
El siguiente ejemplo muestra un evento en el que un conector SFTP falló al intentar enviar un archivo a un servidor SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Send Failed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T19:30:45Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "SEND",
        "connector-id": "c-f1111aaaa2222bbbb3",
        "transfer-id": "transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "/amzn-s3-demo-bucket/testfile.txt",
        "status-code": "FAILED",
        "failure-code": "CONNECTION_ERROR",
        "failure-message": "Unknown Host",
        "remote-directory-path": "",
        "bytes": 0,
        "start-timestamp": "2024-01-24T18:29:33.658729Z",
        "end-timestamp": "2024-01-24T18:29:33.993196Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Ejemplo de evento SFTP Connector File Retrieve Completed**  <a name="event-detail-sftp-connector-events.example"></a>
El siguiente ejemplo muestra un evento en el que un conector SFTP recuperó correctamente un archivo enviado desde un servidor SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Retrieve Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "RETRIEVE",
        "connector-id": "c-fc68000012345aa18",
        "transfer-id": "file-transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "testfile.txt",
        "status-code": "COMPLETED",
        "local-directory-path": "/amzn-s3-demo-bucket",
        "bytes": 63533,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Ejemplo de listado de directorios de conectores SFTP completado**  <a name="event-detail-sftp-connector-events.example"></a>
El siguiente ejemplo muestra un evento en el que una llamada a iniciar un listado del directorio recuperó un archivo de listado de un servidor SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector Directory Listing Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "max-items": 10000,
        "connector-id": "c-fc68000012345aa18",
        "output-directory-path": "/amzn-s3-demo-bucket/example/file-listing-output",
        "listing-id": "123456-23aa-7980-abc1-1a2b3c4d5e",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",        
        "status-code": "COMPLETED",
        "remote-directory-path": "/home",
        "item-count": 10000,
        "truncated": true,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "output-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json"
        }
    }
}
```

## AS2 eventos
<a name="event-detail-as2-server-events"></a>

**nota**  
Estos eventos se entregan a un EventBridge nivel duradero, como se describe en Nivel de [entrega para eventos de AWS servicio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) en la *Referencia de EventBridge eventos de Amazon*.

Los siguientes son los campos de detalle de los AS2 eventos:
+ AS2 Se completó la recepción de la carga
+ AS2 Falló la recepción de la carga
+ AS2 Se ha completado el envío de la carga
+ AS2 Falló el envío de la carga
+ AS2 Se completó la recepción de MDN
+ AS2 Falló la recepción de MDN
+ AS2 Envío de MDN completado
+ AS2 Falló el envío de MDN

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los Transfer Family eventos. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte la [referencia a la estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) en la *Guía del Amazon EventBridge usuario*.

```
{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
```

`detail-type`  <a name="event-detail-as2-server-events-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, el valor es uno de los AS2 eventos enumerados anteriormente.

`source`  <a name="event-detail-as2-server-events-source"></a>
Identifica el servicio que generó el evento. Para Transfer Family los eventos, este valor es`aws.transfer`.

`detail`  <a name="as2-server-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
Identifica el depósito y la clave de Amazon S3 del archivo que se está transfiriendo. En el caso de los eventos de MDN, también identifica el depósito y la clave del archivo MDN.    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
El contenedor del objeto en Amazon S3.  
`file-key`  <a name="as2-server-s3-file-key"></a>
El nombre asignado al objeto en Amazon S3.  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
En el caso de las transferencias FINALIZADAS o FALLIDAS, el contenedor del archivo JSON.  
`json-key`  <a name="as2-server-s3-json-key"></a>
En el caso de transferencias COMPLETADAS o FALLIDAS, el nombre asignado al archivo JSON en Amazon S3.  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
En el caso de los eventos de MDN, el contenedor del archivo MDN.  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
Para los eventos de MDN, el nombre asignado al archivo MDN en Amazon S3.   
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
En el caso de los eventos de MDN, una descripción textual de la disposición del mensaje.  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
Para los eventos de MDN, un identificador único para el mensaje de MDN.  
`disposition`  <a name="as2-server-disposition"></a>
En el caso de los eventos de MDN, la categoría de la disposición.  
`bytes`  <a name="as2-server-bytes"></a>
El número de bytes del mensaje.  
`as2-from`  <a name="as2-server-as2-from"></a>
El socio AS2 comercial que envía el mensaje.  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
Un identificador único para el AS2 mensaje que se está transfiriendo.  
`as2-to`  <a name="as2-server-as2-to"></a>
El socio AS2 comercial que recibe el mensaje.  
`connector-id`  <a name="as2-server-connector-id"></a>
Para AS2 los mensajes que se envían desde un servidor de Transfer Family a un socio comercial, se utiliza el identificador único del AS2 conector que se está enviando.  
`client-ip`  <a name="as2-server-client-ip"></a>
Para los eventos del servidor (transferencias de un socio comercial a un servidor de Transfer Family), la dirección IP del cliente implicado en la transferencia.   
`agreement-id`  <a name="as2-server-agreement-id"></a>
En el caso de los eventos del servidor, el identificador único del AS2 acuerdo.  
`server-id`  <a name="as2-server-server-id"></a>
Para los eventos del servidor, un identificador único solo para el servidor Transfer Family.  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
En el caso de los eventos de carga útil, el nombre original del archivo recibido durante la transferencia.  
`message-subject`  <a name="as2-server-message-subject"></a>
Descripción textual del asunto del mensaje.  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que comienza el procesamiento del archivo.  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
Para que las transferencias se realicen correctamente, la marca de tiempo en la que se completa el procesamiento del archivo.  
`status-code`  <a name="as2-server-status-code"></a>
El código que corresponde al estado del proceso de transferencia de AS2 mensajes. Valores válidos: `COMPLETED | FAILED | PROCESSING`.  
`failure-code`  <a name="as2-server-failure-code"></a>
En el caso de las transferencias fallidas, la categoría por la que se produjo el error en la transferencia.  
`failure-message`  <a name="as2-server-failure-message"></a>
En el caso de las transferencias fallidas, los detalles del motivo por el que se produjo el error en la transferencia.  
`transfer-id`  <a name="as2-server-transfer-id"></a>
El identificador único del evento de transferencia.

**Example AS2 Ejemplo de evento Payload Receive Completed**  <a name="event-detail-as2-server-events.example"></a>

```
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "amzn-s3-demo-bucket"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
```

**Example AS2 Ejemplo de evento MDN Receive Failed**  <a name="event-detail-as2-server-events.example"></a>

```
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "amzn-s3-demo-bucket1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "amzn-s3-demo-bucket2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}
```