Eventos del conector SFTP - 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.

Eventos del conector SFTP

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

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 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", "local-file-location" : { "domain" : "string", "bucket" : "string", "key" : "string" }, "output-file-location" : { "domain" : "string", "bucket" : "string", "key" : "string" } } }
detail-type

Identifica el tipo de evento.

Para este evento, el valor es uno de los nombres de eventos del conector SFTP enumerados anteriormente.

source

Identifica el servicio que generó el evento. Para Transfer Family los eventos, este valor esaws.transfer.

detail

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

El número máximo de nombres de directorios o archivos que se van a devolver.

operation

Si la StartFileTransfer solicitud envía o recupera un archivo. Valores:SEND|RETRIEVE.

connector-id

El identificador único del conector SFTP que se está utilizando.

output-directory-path

La ruta (bucket y prefijo) en Amazon S3 para almacenar los resultados de la lista de archivos/directorios.

listing-id

Un identificador único para la llamada a la StartDirectoryListing API. Este identificador se puede utilizar para comprobar CloudWatch los registros y ver el estado de la solicitud de anuncio.

transfer-id

El identificador único del evento de transferencia (una StartFileTransfer solicitud).

file-transfer-id

El identificador único del archivo que se está transfiriendo.

url

La URL del punto de conexión de AS2 o SFTP del socio.

file-path

La ubicación y el archivo que se están enviando o recuperando.

status-code

Si la transferencia se ha realizado correctamente. Valores:FAILED | COMPLETED.

failure-code

En el caso de transferencias fallidas, el código del motivo por el que se produjo el error en la transferencia.

failure-message

En el caso de las transferencias fallidas, los detalles del motivo del error en la transferencia.

start-timestamp

Para que las transferencias se realicen correctamente, la marca de tiempo en la que se inicia el procesamiento del archivo.

end-timestamp

Para que las transferencias se realicen correctamente, la marca de tiempo en la que se completa el procesamiento del archivo.

local-directory-path

En el caso de RETRIEVE las solicitudes, la ubicación en la que se debe colocar el archivo recuperado.

remote-directory-path

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

El número de elementos (directorios y archivos) devueltos para la solicitud de listado.

truncated

Si el resultado de la lista contiene todos los elementos contenidos en el directorio remoto o no.

bytes

El número de bytes que se están transfiriendo. El valor es 0 para las transferencias fallidas.

local-file-location

Este parámetro contiene los detalles de la ubicación del archivo de AWS almacenamiento.

domain

El almacenamiento que se está utilizando. Actualmente, el único valor esS3.

bucket

El contenedor del objeto en Amazon S3.

key

El nombre asignado al objeto en Amazon S3.

output-file-location

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

El almacenamiento que se está utilizando. Actualmente, el único valor esS3.

bucket

El contenedor del objeto en Amazon S3.

key

El nombre asignado al objeto en Amazon S3.

ejemplo Ejemplo de evento fallido al enviar el archivo del conector SFTP

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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }
ejemplo Ejemplo de evento SFTP Connector File Retrieve Completed

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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }
ejemplo Ejemplo de listado de directorios de conectores SFTP completado

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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json" } } }