Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Trasferimento di file tramite l'interfaccia a riga di comando (CLI)
Le seguenti sezioni descrivono in dettaglio come caricare, scaricare e configurare le hot folder File Transfer con l'interfaccia a riga di comando (CLI).
**Topics**
+ [Caricamento di file](#upload-cli)
+ [Configurazione delle hot folder](#hot-folders-file-transfer-cli)
+ [Scarica i file](#download-cli)
## Caricamento di file
I seguenti comandi sono per l'interfaccia a riga di comando (CLI). Con questi comandi, puoi scaricare i file dal bucket S3 corrispondente che hai impostato nel tuo file di configurazione. Puoi eseguire questi comandi da qualsiasi punto del computer. Tuttavia, consigliamo di eseguire questi comandi da root.
File Transferpreserva la struttura delle cartelle che gli viene assegnata. Ciò significa che la struttura delle cartelle rimane la stessa dopo aver raggiunto Amazon S3. Tuttavia, non puoi fornire File Transfer un percorso assoluto. Ciò significa che il percorso del file non può iniziare con una `/` (barra).
File Transfercaricamenti su tutte le classi di archiviazione S3. Per ulteriori informazioni sulle classi di storage, consulta [Amazon S3 Storage](https://aws.amazon.com/s3/storage-classes/) Classes.
**Nota**
Ti consigliamo di disabilitare la modalità di sospensione sul tuo computer locale. Se il computer attiva la modalità di sospensione, i trasferimenti in corso potrebbero essere interrotti. In **Impostazioni**, attiva **Disabilita sospensione (solo macOS**).
**Per avviare i caricamenti utilizzando la CLI**
1. Apri un terminale.
1. (Consigliato) Passa alla cartella che contiene i file e le cartelle che desideri caricare.
1. Esegui il seguente comando da qualsiasi punto del computer per caricare file dal computer locale su Amazon S3.
```
filetransfer upload [transfer profile] [relative path]
```
1. Sostituisci *[profilo di trasferimento]* con il profilo di trasferimento che desideri utilizzare.
1. Sostituisci *[percorso relativo]* con il percorso del file o della directory che desideri caricare.
1. Un percorso relativo non inizia con una `/` (barra). Esempio: `Users/username/Desktop/folder1`
1. Non utilizzare un percorso assoluto. Un percorso di file assoluto inizia con una `/` (barra). Esempio: `/Users/username/Desktop/folder1`
1. Comando di esempio: `filetransfer upload [transfer profile name] /Users/username/Desktop/folder1`
File Transferesegue [File Transferchecksum](checksums.md) sui tuoi file. Il checksum viene utilizzato per un'ulteriore verifica dell'integrità dei file, per rilevare se un file è stato modificato in modo imprevisto. Una volta completati questi checksum, i trasferimenti iniziano. Se fornisci la tua *Media Hash List (*MHL**), File Transfer puoi verificare che i tuoi file corrispondano al checksum definito nell'MHL. Il file MHL è un file XML che spesso viene fornito con riprese non elaborate da fotocamera.
### Flag
Per eseguire determinate azioni, è possibile aggiungere contrassegni alla fine di un comando. L'uso delle bandiere è facoltativo.
| Flag | Descrizione | Esempio |
| --- | --- | --- |
| --help | Elenca i flag e i comandi disponibili. | `filetransfer --help` |
| --checksum-algorithm | Definisce quale calcolo del checksum viene eseguito. File Transfer Valori supportati:`md5`, `XXHash``XXHash64`, e. `XXH3` | `filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Se utilizzato, File Transfer filtra automaticamente i file di metadati di sistema. Questi file includono `Thumbs.db``.DS_Store`, e file che iniziano con `._.` | `filetransfer upload [remote configuration] [relative path] --enable-metadata-filter` |
| --filter | Filtra i file che vengono trasferiti in base al loro formato. Il campo del filtro accetta espressioni regolari valide. Esempio: trasferisce `^.*\.(mov)$` solo i file che terminano con`.mov`. È possibile aggiungere filtri al file di configurazione per eseguire determinate azioni. Quando aggiungi filtri alla configurazione invece di usarli come flag su comandi specifici, File Transfer applica l'azione a tutti i trasferimenti. | `filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"` Questo comando caricherà solo i file in `.mov` formato. |
| --force | Forza un trasferimento indipendentemente dai filtri o dai conflitti. Per impostazione predefinita, File Transfer non trasferisce file trasferiti in precedenza. Il flag force fa sì che File Transfer vengano ignorati eventuali filtri o conflitti. Questa funzione è utile se hai cancellato accidentalmente un file che devi scaricare. | `filetransfer upload [remote configuration] [relative path] --force` |
| --max-age | Trasferisci solo i file che sono stati creati o modificati in una finestra temporale che termina all'ora corrente. Se non viene fornita alcuna unità, l'età massima sarà espressa in secondi. Ad esempio, `2d` scaricherà i file degli ultimi due giorni e `3500` caricherà i file degli ultimi 3500 secondi. | `filetransfer upload [remote configuration] [relative path] --max-age “2d”` Il comando precedente caricherà nel bucket S3 solo i file degli ultimi 2 giorni. |
| --retry-count | Se si verifica un errore, File Transfer tenterà di trasferire i file tante volte quanto il numero di tentativi. | `filetransfer upload [remote configuration] [relative path] --retry-count 4` |
| --chunk-size | Dimensione del blocco in MB (impostazione predefinita 25) | `filetransfer upload [remote configuration] [relative path] --chunk-size 50` |
| --sintonizzazione automatica | Consenti allo strumento di decidere i migliori valori di configurazione per ottimizzare il trasferimento | `filetransfer upload [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Numero massimo di checksum attivi (impostazione predefinita 1). Questo flag è valido solo per i caricamenti. | `filetransfer upload [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Numero massimo di trasferimenti | `filetransfer upload [remote configuration] [relative path] --max-active-transfers 10` |
| --prefix | Percorso del prefisso S3 per caricamenti e download | `filetransfer upload [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS profilo denominato | `filetransfer upload [remote configuration] [relative path] --profile my_named_profile` |
| --threads | Numero di thread per caricamento (impostazione predefinita 10) | `filetransfer upload [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Sostituisce la cartella predefinita. `.filetransfer` Questa variabile può definire qualsiasi directory in cui memorizzare il file di configurazione e il file di database. Se `FILETRANSFER_CONFIG_DIR` non è impostata, viene utilizzato il valore predefinito`~/.filetransfer`,. I file devono essere ancora denominati `configuration.yaml` o`configuration.yaml`, e`checksum-cache.db`. Se non esistono, vengono creati. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]` |
## Configurazione delle hot folder
**Per configurare l'hot folder di caricamento utilizzando la CLI.**
1. Apri il file di configurazione con qualsiasi software di modifica del testo presente sul tuo computer.
1. Windows: accedi alla `User/` cartella sul tuo computer. Apri la `.filetransfer` cartella e apri il `filetransfer.yaml` file con un editor di testo.
1. macOS: Invio**Cmd\$1Shift\$1G**. Quindi entra**\$1/.filetransfer**. Apri il file `filetransfer.yaml` con un editor di testo.
1. Linux: apri il `filetransfer.yaml` file utilizzando un editor di testo qualsiasi. Il file si trova in`~/.filetransfer/configuration.yaml`.
1. Crea una nuova `hot_folder` sezione con i seguenti campi
```
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. L'hot folder sarà attiva solo quando `enabled` è impostata su true.
1. Sostituisci *local\$1source\$1folder* con la posizione della cartella che desideri monitorare. File Transfer Il percorso del file deve contenere il percorso completo: `C:\path\to\upload-hot-folder` (Windows) o (&). `/path/to/upload-hot-folder` Linux macOS
1. Sotto`remote_configurations`:
1. Sostituisci *remote\$1configuration\$1name con il nome* della configurazione remota che desideri utilizzare. Puoi trovare le tue configurazioni remote elencate sotto. `protocols.s3.transfer_profiles`
1. (Facoltativo) Sostituisci *s3\$1destination\$1folder con la cartella* di destinazione S3 in cui desideri caricare i file. File Transfercreerà la cartella in Amazon S3 se non esiste già. I file verranno inseriti nella radice del bucket se il valore non è impostato.
1. (Facoltativo) È possibile aggiungere qui tutte le voci di configurazione remota che si desidera e l'hot folder avvierà un caricamento utilizzando ciascuna configurazione remota. Ciò consente di impostare una singola hot folder da caricare su più bucket.
1. L'esempio seguente è una configurazione di upload hot folder con più hot folder. In questo esempio, ci sono due hot folder.
1. La prima hot folder è impostata per controllare la `Media/drive` cartella. Quando i file vengono aggiunti a questa cartella, verranno avviati due caricamenti, uno utilizzando la configurazione `example1` remota e l'altro utilizzando la configurazione `example2` remota. Ogni caricamento utilizzerà i rispettivi`s3_destination_folder`.
1. La seconda hot folder è impostata per controllare la `/Users/user1/myhotfolder` cartella. Quando i file vengono aggiunti a questa cartella, inizierà un singolo caricamento, utilizzando la configurazione `another_configuration` remota. Tutti i file verranno caricati nella `example_folder` cartella in 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. Salva il file di configurazione.
**Nota**
Quando si avvia il demone o quando vengono aggiunte/aggiornate le hot folder, verrà avviato un caricamento forzato automatico per l'intera cartella. Se non si preferisce questo comportamento, è possibile aprire la GUI e annullare il processo.
## Scarica i file
Con i seguenti comandi, puoi scaricare i file dal bucket S3 corrispondente che hai impostato nel tuo file di configurazione. Puoi eseguire questi comandi da qualsiasi punto del computer. Ti consigliamo di eseguire questi comandi da root.
File Transfernon è possibile effettuare il download direttamente dalle classi di archiviazione Deep Archive o Glacier. Questo perché sono archiviate in un sistema diverso. Questi tipi di oggetti richiedono un metodo diverso per recuperare i file. Per ulteriori informazioni sul recupero di oggetti da sistemi diversi, vedere [Ripristino](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html) di un oggetto archiviato. Per ulteriori informazioni sulle classi di storage, consulta [Amazon S3 Storage](https://aws.amazon.com/s3/storage-classes/) Classes.
**Nota**
Ti consigliamo di disabilitare la modalità di sospensione sul tuo computer locale. Se il computer attiva la modalità di sospensione, i trasferimenti in corso potrebbero essere interrotti. In **Impostazioni**, attiva **Disabilita sospensione (solo macOS**).
**Per avviare i download utilizzando la CLI**
1. Apri un terminale.
1. (Consigliato) Accedere alla cartella in cui si desidera scaricare i file.
1. Esegui il seguente comando da qualsiasi punto del tuo computer per scaricare file da Amazon S3 sul tuo computer.
```
filetransfer download [transfer profile]
[relative path]
```
1. Sostituisci *[profilo di trasferimento]* con il profilo di trasferimento che desideri utilizzare.
1. Sostituisci *[percorso relativo]* con il percorso in cui desideri scaricare i file.
1. Un percorso relativo non inizia con una `/` (barra). Esempio: `Users/username/Desktop/folder1`
1. Non utilizzare un percorso assoluto. Un percorso di file assoluto inizia con una `/` (barra). Esempio: `/Users/username/Desktop/folder1`
1. Comando di esempio: `filetransfer download [transfer profile name] /Users/username/Desktop/folder1`
File Transfercontrolla il File Transfer database locale per verificare se il file selezionato è già stato scaricato.
### Flag
È possibile aggiungere delle bandiere alla fine di un comando per eseguire determinate azioni. L'uso delle bandiere è facoltativo.
| Flag | Descrizione | Esempio |
| --- | --- | --- |
| --help | Elenca i flag e i comandi disponibili. | `filetransfer --help` |
| --checksum-algorithm | Definisce quale calcolo del checksum viene eseguito. File Transfer Valori supportati:`md5`, `XXHash``XXHash64`, e. `XXH3` | `filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Se utilizzato, File Transfer filtra automaticamente i file di metadati di sistema. Questi file includono `Thumbs.db``.DS_Store`, e file che iniziano con `._.` | `filetransfer download [remote configuration] [relative path] --enable-metadata-filter` |
| --filter | Filtra i file che vengono trasferiti in base al loro formato. Il campo del filtro accetta espressioni regolari valide. Esempio: trasferisce `^.*\.(mov)$` solo i file che terminano con`.mov`. È possibile aggiungere filtri al file di configurazione per eseguire determinate azioni. Quando aggiungi filtri alla configurazione invece di usarli come flag su comandi specifici, File Transfer applica l'azione a tutti i trasferimenti. | `filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"` Questo comando scaricherà solo i file in `.mov` formato. |
| --force | Forza un trasferimento indipendentemente dai filtri o dai conflitti. Per impostazione predefinita, File Transfer non trasferisce file trasferiti in precedenza. Il flag force fa sì che File Transfer vengano ignorati eventuali filtri o conflitti. Questa funzione è utile se hai cancellato accidentalmente un file che devi scaricare. | `filetransfer download [remote configuration] [relative path] --force` |
| --max-age | Trasferisci solo i file che sono stati creati o modificati in una finestra temporale che termina all'ora corrente. Se non viene fornita alcuna unità, l'età massima sarà espressa in secondi. Ad esempio, `2d` scaricherà i file degli ultimi due giorni e `3500` caricherà i file degli ultimi 3500 secondi. | `filetransfer download [remote configuration] [relative path] --max-age “2d”` Il comando precedente scaricherà solo i file nel bucket S3 degli ultimi 2 giorni. |
| --retry-count | Se si verifica un errore, File Transfer tenterà di trasferire i file tante volte quanto il numero di tentativi. | `filetransfer download [remote configuration] [relative path] --retry-count 4` |
| --chunk-size | Dimensione del blocco in MB (impostazione predefinita 25) | `filetransfer download [remote configuration] [relative path] --chunk-size 50` |
| --sintonizzazione automatica | Consenti allo strumento di decidere i migliori valori di configurazione per ottimizzare il trasferimento | `filetransfer download [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Numero massimo di checksum attivi (impostazione predefinita 1) | `filetransfer download [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Numero massimo di trasferimenti | `filetransfer download [remote configuration] [relative path] --max-active-transfers 10` |
| --prefix | Percorso del prefisso S3 per caricamenti e download | `filetransfer download [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS profilo denominato | `filetransfer download [remote configuration] [relative path] --profile my_named_profile` |
| --threads | Numero di thread per download (impostazione predefinita 10) | `filetransfer download [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Sostituisce la cartella predefinita. `.filetransfer` Questa variabile può definire qualsiasi directory in cui memorizzare il file di configurazione e il file di database. Se `FILETRANSFER_CONFIG_DIR` non è impostata, viene utilizzato il valore predefinito`~/.filetransfer`,. I file devono essere ancora denominati `configuration.yaml` o`configuration.yaml`, e`checksum-cache.db`. Se non esistono, vengono creati. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]` |