Enviar y recuperar archivos mediante un conector SFTP

Los conectores SFTP amplían las capacidades de AWS Transfer Family comunicación con servidores remotos tanto en la nube como en las instalaciones. Puede integrar los datos que se generan y almacenan en fuentes remotas con sus almacenes de datos AWS alojados para realizar análisis, aplicaciones empresariales, informes y auditorías.

Para iniciar una transferencia de archivos a un servidor SFTP remoto, utilice la operación API StartFileTransfer, que utiliza conectores SFTP para realizar la transferencia. Cada solicitud StartFileTransfer puede contener 10 rutas distintas.

Puede supervisar las transferencias de archivos consultando los registros del servidor. La actividad de los conectores se registra en los flujos de registro que tienen el formato de aws/transfer/connector-id, por ejemplo, aws/transfer/c-1234567890abcdef0. Si no ve ningún registro para su conector, asegúrese de haber especificado un rol de registro con los permisos correctos para el conector.

Para obtener información sobre cómo crear conectores, consulte Configure los conectores SFTP.

Para enviar y recuperar archivos mediante un conector SFTP, utilice el comando start-file-transfer AWS Command Line Interface (AWS CLI). Debe especificar los siguientes parámetros, en función de si envía archivos (transferencias salientes) o si recibe archivos (transferencias entrantes).

• Transferencias salientes

  • send-file-paths contiene de una a diez rutas de archivos de origen, para que los archivos se transfieran al servidor SFTP del socio.

  • remote-directory-path es la ruta remota a la que se envía un archivo en el servidor SFTP del cliente.

• Transferencias entrantes

  • retrieve-file-paths contiene de una a diez rutas remotas. Cada ruta especifica una ubicación para transferir archivos desde el servidor SFTP del socio a su servidor Transfer Family.

  • local-directory-path es la ubicación en Amazon S3 (bucket y prefijo opcional) en la que se almacenan los archivos.

Para enviar archivos, debe especificar los parámetros send-file-paths y remote-directory-path. Puede especificar hasta 10 archivos para el parámetro send-file-paths. El siguiente comando de ejemplo envía los archivos denominados /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt y /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt, ubicados en el almacenamiento de Amazon S3, al directorio /tmp del servidor SFTP de su socio. Para utilizar este comando de ejemplo, sustituya DOC-EXAMPLE-SOURCE-BUCKET por su propio bucket.

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt \
    --remote-directory-path /tmp --connector-id c-1111AAAA2222BBBB3 --region us-east-2

Para recibir los archivos, debe especificar los parámetros retrieve-file-paths y local-directory-path. El siguiente ejemplo recupera los archivos /my/remote/file1.txt y los guarda /my/remote/file2.txt en el servidor SFTP del socio y los coloca en el prefijo /DOC-EXAMPLE-BUCKET/ de la ubicación de Amazon S3. Para utilizar este comando de ejemplo, sustituya user input placeholders por su propia información.

aws transfer start-file-transfer --retrieve-file-paths /my/remote/file1.txt  /my/remote/file2.txt \
   --local-directory-path /DOC-EXAMPLE-BUCKET/prefix --connector-id c-2222BBBB3333CCCC4 --region us-east-2

Los ejemplos anteriores especifican las rutas absolutas en el servidor SFTP. También puede utilizar rutas relativas, es decir, rutas relativas al directorio de inicio del usuario de SFTP. Por ejemplo, si el usuario de SFTP es marymajor y su directorio de inicio en el servidor SFTP es /users/marymajor/, el siguiente comando envía /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt a /users/marymajor/test-connectors/file1.txt.

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt \
   --remote-directory-path test-connectors --connector-id c-2222BBBB3333CCCC4 --region us-east-2