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.
# 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).
**Topics**
+ [Carga de archivos](#upload-cli)
+ [Configuración de carpetas activas](#hot-folders-file-transfer-cli)
+ [Descarga de archivos](#download-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](https://aws.amazon.com/s3/storage-classes/).
**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.
1. (Recomendado) Acceda la carpeta que contiene los archivos y carpetas que desea cargar.
1. 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.
1. 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`
1. No utilice una ruta absoluta. Una ruta de archivo absoluta comienza con una barra inclinada (`/`). Ejemplo: `/Users/username/Desktop/folder1`
1. 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](checksums.md) 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\$1CONFIG\$1DIR | 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/` de su equipo. Abra la carpeta `.filetransfer` y luego abra el archivo `filetransfer.yaml` en un editor de texto.
1. macOS: introduzca **Cmd\$1Shift\$1G**. Luego introduzca **\$1/.filetransfer**. Abra el archivo `filetransfer.yaml` en un editor de texto.
1. Linux: abra el archivo `filetransfer.yaml` con cualquier editor de texto. El archivo se encuentra en `~/.filetransfer/configuration.yaml`.
1. 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
```
1. La carpeta activa solo lo estará cuando el valor `enabled` esté establecido en true.
1. Reemplace *local\$1source\$1folder* 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).
1. Bajo `remote_configurations`:
1. Reemplace *remote\$1configuration\$1name* por el nombre de la configuración remota que quiere utilizar. Aparece una lista de sus configuraciones remotas en `protocols.s3.transfer_profiles`.
1. (Opcional) Reemplace *s3\$1destination\$1folder* 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.
1. (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.
1. 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.
1. 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
```
1. 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html). Para obtener más información acerca de las clases de almacenamiento, consulte [Clases de almacenamiento de Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**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.
1. (Recomendado) Navegue hasta la carpeta en la que desee descargar los archivos.
1. 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.
1. 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`
1. No utilice una ruta absoluta. Una ruta de archivo absoluta comienza con una barra inclinada (`/`). Ejemplo: `/Users/username/Desktop/folder1`
1. 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\$1CONFIG\$1DIR | 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]` |