Transferencia de archivos con la interfaz de la línea de comandos (CLI)

En las siguientes secciones se detalla cómo cargar, descargar y configurar carpetas activas File Transfer con la interfaz de línea de comandos (CLI).

Carga de archivos

Los siguientes comandos son para la interfaz de la línea de comandos (CLI). Con estos comandos, puede descargar archivos del bucket de S3 correspondiente que configuró en su archivo de configuración. Puede ejecutar estos comandos desde cualquier parte de su equipo. No obstante, recomendamos ejecutarlos desde la raíz.

File Transfer conserva la estructura de carpetas que le asigne. Esto significa que la estructura de carpetas sigue siendo la misma al llegar a Amazon S3. Sin embargo, no puede facilitar a File Transfer una ruta absoluta. Esto significa que la ruta del archivo no puede empezar con el carácter / (barra inclinada).

File Transfer realiza cargas en todas las clases de almacenamiento de S3. Para obtener más información sobre las clases de almacenamiento, consulte Clases de almacenamiento de Amazon S3.

nota

Se recomienda deshabilitar el modo de suspensión en el equipo local. Si se activa el modo de suspensión en el equipo, puede que las transferencias en curso se interrumpan. En Configuración, cambie a Desactivar suspensión (solo macOS).

Para iniciar las cargas mediante la CLI

1. Abra un terminal.

2. (Recomendado) Acceda la carpeta que contiene los archivos y carpetas que desea cargar.

3. Ejecute el siguiente comando desde cualquier lugar de su equipo para cargar archivos desde su máquina local a Amazon S3.

   filetransfer upload [transfer profile] [relative path]

   1. Reemplace [perfil de transferencia] por el perfil de transferencia que desee utilizar.

   2. Reemplace [ruta relativa] por la ruta del archivo o directorio que desee cargar.

      1. Una ruta relativa no comienza con una barra inclinada (/). Ejemplo: Users/username/Desktop/folder1

      2. No utilice una ruta absoluta. Una ruta de archivo absoluta comienza con una barra inclinada (/). Ejemplo: /Users/username/Desktop/folder1

   3. Comando de ejemplo: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File Transfer realiza el proceso de Sumas de comprobación de File Transfer en los archivos. La suma de comprobación se utiliza para verificar aún más la integridad del archivo y detectar si se ha modificado inesperadamente. Una vez completadas esas sumas de comprobación, comienzan las transferencias. Si proporciona su propia lista de hash de medios (MHL), File Transfer podrá comprobar que sus archivos coinciden con la suma de comprobación definida en la MHL. La lista MHL es un archivo XML que suele incluir imágenes de cámara sin procesar.

Indicadores

Para realizar determinadas acciones, puede añadir indicadores al final de un comando. El uso de indicadores es opcional.

Indicador	Descripción	Ejemplo
--help	Enumera los indicadores y los comandos disponibles.	filetransfer --help
--checksum-algorithm	Defina qué cálculo de suma de comprobación realiza File Transfer. Valores admitidos: md5, XXHash, XXHash64 y XXH3.	filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64
--enable-metadata-filter	Cuando se utiliza, File Transfer filtra automáticamente los archivos de metadatos del sistema. Estos archivos son Thumbs.db, .DS_Store y los archivos que comienzan por ._..	filetransfer upload [remote configuration] [relative path] --enable-metadata-filter
--filter	Filtre los archivos que se están transfiriendo en función de su formato. El campo de filtro acepta expresiones regulares válidas. Ejemplo: ^.*\.(mov)$ solo transfiere archivos que terminen en .mov. Se pueden añadir filtros al archivo de configuración para realizar determinadas acciones. Al añadir filtros a la configuración en lugar de utilizarlos como indicadores en comandos específicos, File Transfer aplica la acción a todas las transferencias.	filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$" Este comando solo cargará los archivos que estén en formato .mov.
--force	Fuerza una transferencia independientemente de filtros o conflictos. De forma predeterminada, File Transfer no transferirá los archivos transferidos anteriormente. El indicador force hace que File Transfer ignore los filtros o conflictos. Esta función resulta de gran utilidad si ha eliminado accidentalmente un archivo que necesita descargar.	filetransfer upload [remote configuration] [relative path] --force
--max-age	Permite transferir únicamente los archivos que se crearon o modificaron dentro de un período de tiempo que finalice en la hora actual. Si no se indica ninguna unidad, la antigüedad máxima será en segundos. Por ejemplo, 2d descargará los archivos de los últimos dos días y 3500 cargará los archivos de los últimos 3500 segundos.	filetransfer upload [remote configuration] [relative path] --max-age “2d” El comando anterior solo cargará al bucket de S3 los archivos de los últimos 2 días.
--retry-count	Si se produce un error, File Transfer intentará transferir los archivos tantas veces como se indique en esta opción.	filetransfer upload [remote configuration] [relative path] --retry-count 4
--chunk-size	Tamaño del fragmento en MB (valor predeterminado: 25)	filetransfer upload [remote configuration] [relative path] --chunk-size 50
--auto-tuning	Permitir que la herramienta decida los mejores valores de configuración para optimizar la transferencia	filetransfer upload [remote configuration] [relative path] --auto-tuning true
--max-active-checksums	Número máximo de sumas de verificación activas (predeterminado: 1). Esta marca solo es válida para las subidas.	filetransfer upload [remote configuration] [relative path] --max-active-checksums 5
--max-active-transfers	Número máximo de transferencias	filetransfer upload [remote configuration] [relative path] --max-active-transfers 10
--prefix	Ruta de los prefijos de S3 para cargas y descargas	filetransfer upload [remote configuration] [relative path] --prefix my/s3/path
--profile	AWS perfil con nombre	filetransfer upload [remote configuration] [relative path] --profile my_named_profile
--threads	Número de subprocesos por carga (valor predeterminado: 10)	filetransfer upload [remote configuration] [relative path] --threads 10
FILETRANSFER_CONFIG_DIR	Anula la carpeta predeterminada .filetransfer. Esta variable puede definir cualquier directorio para almacenar el archivo de configuración y el archivo de base de datos. Si no se ha establecido FILETRANSFER_CONFIG_DIR, se utiliza el valor predeterminado, ~/.filetransfer. Los archivos deben seguir teniendo el nombre configuration.yaml o configuration.yaml, y checksum-cache.db. Si no existen, se crean.	FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]

Configuración de carpetas activas

Para configurar la carpeta activa de carga mediante la CLI

1. Abra el archivo de configuración con cualquier software de edición de texto de su equipo.

   1. Windows: vaya a la carpeta User/<your username> de su equipo. Abra la carpeta .filetransfer y luego abra el archivo filetransfer.yaml en un editor de texto.

   2. macOS: introduzca Cmd+Shift+G. Luego introduzca ~/.filetransfer. Abra el archivo filetransfer.yaml en un editor de texto.

   3. Linux: abra el archivo filetransfer.yaml con cualquier editor de texto. El archivo se encuentra en ~/.filetransfer/configuration.yaml.

2. Cree una sección hot_folder nueva con los siguientes campos:

   hot folders:
                 - enabled: true
                 local_source_folder: /Users/user/myhotfolder
                 name: my_hot_folder
                 remote_configurations:
                   - remote_configuration_name: example_configuration
                     s3_destination_folder: my/s3/prefix

3. La carpeta activa solo lo estará cuando el valor enabled esté establecido en true.

4. Reemplace local_source_folder por la ubicación de la carpeta que quiere que File Transfer supervise. La ruta del archivo debe contener la ruta completa: C:\path\to\upload-hot-folder (Windows) o /path/to/upload-hot-folder (Linux y macOS).

5. Bajo remote_configurations:

   1. Reemplace remote_configuration_name por el nombre de la configuración remota que quiere utilizar. Aparece una lista de sus configuraciones remotas en protocols.s3.transfer_profiles.

   2. (Opcional) Reemplace s3_destination_folder por la carpeta de destino de S3 en la que quiere que se carguen los archivos. File Transfer creará la carpeta en Amazon S3 si aún no existe. Los archivos se colocarán en la raíz del bucket si el valor no está establecido.

   3. (Opcional) Aquí puede agregar tantas entradas de configuración remota como quiera y la carpeta activa iniciará una carga con cada configuración remota. Esto le permite establecer una única carpeta activa que se cargará en varios buckets.

6. A continuación, se muestra un ejemplo de configuración de una carpeta activa de carga con varias carpetas activas. En este ejemplo, hay dos carpetas activas.

   1. La primera carpeta activa está configurada para observar la carpeta Media/drive. Cuando se agreguen archivos a esta carpeta, iniciará dos cargas: una con la configuración remota de example1 y otra con la de example2. Cada carga utilizará su s3_destination_folder respectiva.

   2. La segunda carpeta activa está configurada para observar la carpeta /Users/user1/myhotfolder. Cuando se agreguen archivos a esta carpeta, iniciará una sola carga con la configuración remota another_configuration. Todos los archivos se cargarán en la carpeta example_folder de Amazon S3.

   hot folders: 
           - enabled: true
             local_source_folder: /Media/drive
             name: my_hot_folder
             remote_configurations:
                   - remote_configuration_name: example1
                     s3_destination_folder: my/s3/folder
                   - remote_configuration_name: example2
                     s3_destination_folder: second/folder
           - enabled: true
             local_source_folder: /Users/user1/my_hot_folder
             name: another_hot_folder
             remote_configurations:
                   - remote_configuration_name: another_configuration
                     s3_destination_folder: example/folder
   

7. Guarde el archivo de configuración.

   nota

   Al iniciar el daemon, o al agregar o actualizar carpetas activas, se iniciará una carga automática forzada de toda la carpeta. Si este comportamiento no es de su preferencia, puede abrir la GUI y cancelar el trabajo.

Descarga de archivos

Con los siguientes comandos, puede descargar archivos del bucket de S3 correspondiente que configuró en su archivo de configuración. Puede ejecutar estos comandos desde cualquier parte de su equipo. Recomendamos ejecutarlos desde la raíz.

File Transfer no puede descargar directamente desde las clases de almacenamiento Deep Archive o Glacier. Esto se debe a que se almacenan en un sistema diferente. Estos tipos de objetos requieren un método diferente de recuperación de archivos. Para obtener más información sobre la recuperación de objetos de diferentes sistemas, consulte Restauración de un objeto archivado. Para obtener más información acerca de las clases de almacenamiento, consulte Clases de almacenamiento de Amazon S3.

nota

Se recomienda deshabilitar el modo de suspensión en el equipo local. Si se activa el modo de suspensión en el equipo, puede que las transferencias en curso se interrumpan. En Configuración, cambie a Desactivar suspensión (solo macOS).

Para iniciar las descargas mediante la CLI

1. Abra un terminal.

2. (Recomendado) Navegue hasta la carpeta en la que desee descargar los archivos.

3. Ejecute el siguiente comando desde cualquier parte de su equipo para descargar en él archivos de Amazon S3.

   filetransfer download [transfer profile]
                     [relative path]

   1. Reemplace [perfil de transferencia] por el perfil de transferencia que desee utilizar.

   2. Reemplace [ruta relativa] por la ruta a la que desee descargar los archivos.

      1. Una ruta relativa no comienza con una barra inclinada (/). Ejemplo: Users/username/Desktop/folder1

      2. No utilice una ruta absoluta. Una ruta de archivo absoluta comienza con una barra inclinada (/). Ejemplo: /Users/username/Desktop/folder1

   3. Comando de ejemplo: filetransfer download [transfer profile name] /Users/username/Desktop/folder1

File Transfer comprueba la base de datos local de File Transfer para verificar si el archivo que ha seleccionado ya se ha descargado.

Indicadores

Se pueden añadir indicadores al final de un comando para realizar determinadas acciones. El uso de indicadores es opcional.

Indicador	Descripción	Ejemplo
--help	Enumera los indicadores y los comandos disponibles.	filetransfer --help
--checksum-algorithm	Defina qué cálculo de suma de comprobación realiza File Transfer. Valores admitidos: md5, XXHash, XXHash64 y XXH3.	filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64
--enable-metadata-filter	Cuando se utiliza, File Transfer filtra automáticamente los archivos de metadatos del sistema. Estos archivos son Thumbs.db, .DS_Store y los archivos que comienzan por ._..	filetransfer download [remote configuration] [relative path] --enable-metadata-filter
--filter	Filtre los archivos que se están transfiriendo en función de su formato. El campo de filtro acepta expresiones regulares válidas. Ejemplo: ^.*\.(mov)$ solo transfiere archivos que terminen en .mov. Se pueden añadir filtros al archivo de configuración para realizar determinadas acciones. Al añadir filtros a la configuración en lugar de utilizarlos como indicadores en comandos específicos, File Transfer aplica la acción a todas las transferencias.	filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$" Este comando solo descargará los archivos que estén en formato .mov.
--force	Fuerza una transferencia independientemente de filtros o conflictos. De forma predeterminada, File Transfer no transferirá los archivos transferidos anteriormente. El indicador force hace que File Transfer ignore los filtros o conflictos. Esta función resulta de gran utilidad si ha eliminado accidentalmente un archivo que necesita descargar.	filetransfer download [remote configuration] [relative path] --force
--max-age	Permite transferir únicamente los archivos que se crearon o modificaron dentro de un período de tiempo que finalice en la hora actual. Si no se indica ninguna unidad, la antigüedad máxima será en segundos. Por ejemplo, 2d descargará los archivos de los últimos dos días y 3500 cargará los archivos de los últimos 3500 segundos.	filetransfer download [remote configuration] [relative path] --max-age “2d” El comando anterior solo descargará al bucket de S3 los archivos de los últimos 2 días.
--retry-count	Si se produce un error, File Transfer intentará transferir los archivos tantas veces como se indique en esta opción.	filetransfer download [remote configuration] [relative path] --retry-count 4
--chunk-size	Tamaño del fragmento en MB (valor predeterminado: 25)	filetransfer download [remote configuration] [relative path] --chunk-size 50
--auto-tuning	Permitir que la herramienta decida los mejores valores de configuración para optimizar la transferencia	filetransfer download [remote configuration] [relative path] --auto-tuning true
--max-active-checksums	Número máximo de sumas de comprobación activas (valor predeterminado: 1)	filetransfer download [remote configuration] [relative path] --max-active-checksums 5
--max-active-transfers	Número máximo de transferencias	filetransfer download [remote configuration] [relative path] --max-active-transfers 10
--prefix	Ruta de los prefijos de S3 para cargas y descargas	filetransfer download [remote configuration] [relative path] --prefix my/s3/path
--profile	AWS perfil nombrado	filetransfer download [remote configuration] [relative path] --profile my_named_profile
--threads	Número de subprocesos por descarga (valor predeterminado: 10)	filetransfer download [remote configuration] [relative path] --threads 10
FILETRANSFER_CONFIG_DIR	Anula la carpeta predeterminada .filetransfer. Esta variable puede definir cualquier directorio para almacenar el archivo de configuración y el archivo de base de datos. Si no se ha establecido FILETRANSFER_CONFIG_DIR, se utiliza el valor predeterminado, ~/.filetransfer. Los archivos deben seguir teniendo el nombre configuration.yaml o configuration.yaml, y checksum-cache.db. Si no existen, se crean.	FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]